Back to Skills

WordPress Agent Skills

Official

by WordPress

developmentbeginner
wordpressgutenbergblock-developmentplugin-developmentblock-themeswp-playgroundclaude-codecodexcursorphprest-apiinteractivity-apiai-codingagents-md

WordPress Agent Skills gives AI coding assistants deep, practical knowledge of modern WordPress development -- from Gutenberg blocks and block themes to plugin architecture and the REST API. Instead of letting your AI assistant generate outdated pre-block-era code, these skills inject expert-level context so the agent writes WordPress 6.9+ patterns correctly on the first try. The package ships 13 individual skills covering the full WordPress stack. The wordpress-router skill automatically detects what kind of project you are working in and selects the right workflow. wp-project-triage identifies your tooling, PHP version, and plugin/theme structure before the agent writes a single line. wp-block-development handles block.json registration, deprecation arrays, and InnerBlocks patterns that trip up even experienced developers. wp-plugin-development enforces proper hook architecture, settings API usage, nonce verification, and capability checks. The standout addition is wp-playground, which spins up a full WordPress environment through Playground CLI so your agent can build, test, and iterate without waiting for Docker or a remote server. Helper scripts reduce the time from code change to live preview from roughly a minute down to seconds. The agent auto-detects where your code should live inside the WordPress install, mounts it correctly, and opens a browser preview. All skills follow the AGENTS.md format, making them portable across Claude Code, GitHub Copilot, OpenAI Codex, Cursor, Antigravity, Gemini CLI, and any assistant that reads project-level instructions. The WordPress core team maintains the repository, and the skills receive updates as WordPress core APIs evolve. With 819 GitHub stars and 115 forks since launching in January 2026, the project has quickly become a standard tool in the WordPress developer workflow.

Installation

npx openskills install WordPress/agent-skills

Key Features

  • 13 modular skills covering blocks, themes, plugins, REST API, performance, and more -- install only what your project needs
  • wp-playground skill launches a local WordPress environment in seconds so agents can test code changes without Docker or remote servers
  • wordpress-router auto-detects project type and selects the correct development workflow before the agent writes any code
  • Enforces modern WordPress 6.9+ patterns including block.json registration, proper deprecation arrays, and capability-based security checks
  • Portable AGENTS.md format works across Claude Code, Codex, Copilot, Cursor, Antigravity, and Gemini CLI without per-tool configuration
  • Maintained by the WordPress core team with updates tracking WordPress core API changes

Use Cases

  • A freelance developer building a custom block plugin asks Claude Code to scaffold the block with InnerBlocks support -- the wp-block-development skill ensures correct block.json attributes, deprecation handling, and edit/save component structure instead of the deprecated registerBlockType-only approach.
  • An agency team migrating a classic theme to a block theme uses Cursor with the wp-block-themes skill loaded. The agent generates valid theme.json with proper font-face declarations, template-part references, and style variation files that pass the Theme Check plugin.
  • A plugin developer writing a settings page tells their AI assistant to add an admin panel with REST API endpoints. The wp-plugin-development and wp-rest-api skills ensure nonce verification, capability checks, proper schema definitions, and sanitization callbacks are all in place from the start.
  • A contributor working on WordPress core uses wp-playground to spin up a fresh WordPress instance, apply their patch, and run the test suite -- all through the AI agent -- cutting the feedback loop from minutes to seconds.
  • A solo developer building a WooCommerce extension uses wp-project-triage to let the agent detect the existing plugin structure, PHP version constraints, and coding standards before generating any code, avoiding compatibility issues with the production environment.

Related Resources

Weekly AI Digest