WP Block Development

Agent Skills for WordPress

**Teach AI coding assistants how to build WordPress the right way.**

Agent Skills are portable bundles of instructions, checklists, and scripts that help AI assistants (Claude, Copilot, Codex, Cursor, etc.) understand WordPress development patterns, avoid common mistakes, and follow best practices.

**AI Authorship Disclosure:** These skills were generated using GPT-5.2 Codex (High Reasoning) from official Gutenberg and WordPress documentation, then reviewed and edited by WordPress contributors. We tested skills with AI assistants and iterated based on results. This is v1, and skills will improve as the community uses them and contributes fixes. See [docs/ai-authorship.md](docs/ai-authorship.md) for details. ([WordPress AI Guidelines](https://make.wordpress.org/ai/handbook/ai-guidelines/))

Why Agent Skills?

AI coding assistants are powerful, but they often:

• Generate outdated WordPress patterns (pre-Gutenberg, pre-block themes)
• Miss critical security considerations in plugin development
• Skip proper block deprecations, causing "Invalid block" errors
• Ignore existing tooling in your repo

Agent Skills solve this by giving AI assistants **expert-level WordPress knowledge** in a format they can actually use.

Available Skills

Skill	What it teaches
wordpress-router	Classifies WordPress repos and routes to the right workflow
wp-project-triage	Detects project type, tooling, and versions automatically
wp-block-development	Gutenberg blocks: block.json, attributes, rendering, deprecations
wp-block-themes	Block themes: theme.json, templates, patterns, style variations
wp-plugin-development	Plugin architecture, hooks, settings API, security
wp-rest-api	REST API routes/endpoints, schema, auth, and response shaping
wp-interactivity-api	Frontend interactivity with data-wp-* directives and stores

...