WordPress ships a syllabus for your AI intern
Portable instruction bundles that stop AI coding assistants from generating outdated WordPress patterns and security holes.

What it does The repository packages WordPress best practices into portable “skills” — Markdown instructions, checklists, and helper scripts — that you feed to AI coding assistants like Claude, Copilot, or Cursor. Each skill targets a specific domain, such as block development, REST API design, or plugin security, and aims to stop the assistant from guessing or regurgitating outdated pre-Gutenberg patterns. A set of Node scripts then installs these bundles into assistant-specific directories where they are automatically discovered.
The interesting bit WordPress is essentially treating AI assistants as junior developers who need onboarding: the project openly discloses that the skills were first drafted by GPT-5.2 Codex from official docs, then reviewed by human contributors. It is a v1 release, and the maintainers expect the community to iterate on the material as the tools evolve.
Key highlights
- Covers 16 domains, from
block.jsondeprecations to WordPress Playground blueprints and the Abilities API. - Each skill bundles a
SKILL.mdprocedure, deep-dive reference docs, and deterministic validation scripts. - Targets multiple assistants: Claude Code, Cursor, GitHub Copilot/Codex, and VS Code.
- Requires WordPress 6.9+ and PHP 7.2.24+.
- Licensed under GPL-2.0-or-later.
Caveats
- The skills are explicitly labeled v1; the README notes they “will improve as the community uses them and contributes fixes.”
- Content was initially generated by GPT-5.2 Codex and later reviewed by WordPress contributors, so accuracy depends on that human review loop.
Verdict If you use AI assistants to write WordPress code, this is a sanity check against outdated patterns. If you do not, it is simply an elaborate collection of Markdown best-practice guides.
Frequently asked
- What is WordPress/agent-skills?
- Portable instruction bundles that stop AI coding assistants from generating outdated WordPress patterns and security holes.
- Is agent-skills open source?
- Yes — WordPress/agent-skills is an open-source project tracked on heatdrop.
- What language is agent-skills written in?
- WordPress/agent-skills is primarily written in JavaScript.
- How popular is agent-skills?
- WordPress/agent-skills has 1.9k stars on GitHub and is currently holding steady.
- Where can I find agent-skills?
- WordPress/agent-skills is on GitHub at https://github.com/WordPress/agent-skills.