← all repositories
WordPress/agent-skills

WordPress ships a syllabus for your AI intern

Portable instruction bundles that stop AI coding assistants from generating outdated WordPress patterns and security holes.

1.9k stars JavaScript Coding Assistants
agent-skills
Velocity · 7d
+4.7
★ / day
Trend
steady
star history

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.json deprecations to WordPress Playground blueprints and the Abilities API.
  • Each skill bundles a SKILL.md procedure, 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.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.