A beginner post about WordPress Agent Skills

[bph]

Discussed in #446

^{Originally posted by bph February 3, 2026}
There is now an official GitHub repository for Agent Skills These skills help AI coding assistants like Claude Code, GitHub Copilot, Cursor and others to understand how WordPress development should be done — blocks, themes, plugins, security, and so on.

The repo has install commands and documentation, but when I look at it, I think it expects that people already know how AI-assisted coding works. For many WordPress developers, this is not the case yet. Many of us know PHP, hooks, the block editor, but have never worked with an AI coding tool or configured skill files.

So my idea is: could we write an introductory blog post that explains things from the beginning?

Something like:

• What are agent skills exactly? Not just "instructions for AI" but what does that actually mean? What happens when the AI has these skills and what happens when it does not?
• What is the problem they fix? Maybe show some examples where AI generates old WordPress patterns or forgets about security, and then show how it works better with skills installed.
• A step-by-step walkthrough for getting started. What are the steps to install the skills? How does the AI assistant find and use them? What is happening in the background when I run the build and install scripts?
• How does this fit with how I already work? Because I think some developers might worry they need to change everything. But skills are just something you add on top.

The post could start really at the basics. Many WordPress developers learned by doing, or come from design, or are not native English speakers and the documentation can feel a bit overwhelming. If we explain things like what is Claude Code, what is a terminal, what does git clone actually do — I think more people from the community would try it out and benefit from this work.

What do you think? Is this something useful for the Developer Blog? I am happy to hear feedback about what to include or leave out.