Agent Skills for WordPress is a set of portable instruction bundles that teach AI coding assistants such as Claude, Copilot, Codex, and Cursor how to build WordPress projects. Each skill packages procedures, checklists, reference documents, and optional scripts so that an assistant follows documented WordPress patterns instead of guessing.
The motivation is that assistants often generate pre-Gutenberg or pre-block-theme code, miss security considerations in plugins, skip block deprecations (causing "Invalid block" errors), and ignore tooling already present in a repository. The skills were generated with GPT-5.2 Codex from official Gutenberg and WordPress documentation, then reviewed and edited by WordPress contributors and iterated against real assistant runs; this is a v1 release.
Every skill is a self-contained folder: a SKILL.md with when-to-use guidance, procedure, and verification steps, a references/ directory of deeper topic docs, and a scripts/ directory of deterministic helpers for detection and validation. Skills can live globally in your home directory or per project inside the repository (where they can be committed and shared); the project-level copy wins when both exist. Targets include Claude Code, Codex, VS Code and GitHub Copilot, Cursor, and Antigravity. The skills target WordPress 7.0+ on PHP 7.4+.
Features
- wordpress-router and wp-project-triage: classify a WordPress repository, detect project type, tooling, and versions, and route to the right workflow
- wp-block-development: Gutenberg blocks, block.json, attributes, rendering, and deprecations
- wp-block-themes: theme.json, templates, patterns, and style variations
- wp-plugin-development: plugin architecture, hooks, the settings API, and security
- wp-rest-api: routes, endpoints, schema, authentication, and response shaping
- wp-interactivity-api: frontend interactivity with data-wp-* directives and stores
- wp-abilities-api, wp-abilities-audit, wp-abilities-verify: capability-based permissions, auditing a plugin's REST surface, and verifying Abilities API registrations
- wp-wpcli-and-ops: WP-CLI commands, automation, multisite, and search-replace
- wp-performance and wp-phpstan: profiling, caching, database optimisation, Server-Timing, and PHPStan configuration for WordPress
- wp-playground and blueprint: WordPress Playground routing, CLI runs, browser previews, snapshots, and declarative Blueprints
- wpds and wp-plugin-directory-guidelines: the WordPress Design System and Plugin Directory guidelines
- Authoring tooling: a scaffold script for new skills and an evaluation harness for validating them
