WordPress Agent Skills

WordPress/agent-skills packages contributor-reviewed WordPress guidance for AI coding assistants. It helps agents classify WordPress repositories, choose modern workflows, and avoid outdated patterns when working on Gutenberg blocks, block themes, plugins, REST endpoints, Interactivity API, Abilities API, WP-CLI, WordPress Playground, PHPStan, performance, and plugin directory rules.

The README states that the skills were generated from official Gutenberg and WordPress documentation with GPT-5.2 Codex, then reviewed, edited, and tested by WordPress contributors. Treat that disclosure as important context: this is an AI-assisted, human-reviewed skill pack, not an unreviewed prompt dump.

Knowledge Freshness

The skills target WordPress 6.9+ with PHP 7.2.24+ compatibility guidance. They lean on current Gutenberg and WordPress developer documentation, but WordPress APIs, block editor behavior, REST patterns, plugin directory rules, PHPStan baselines, and Playground tooling can change.

Use the skills for workflows and guardrails, then verify exact APIs and behavior against the target project's WordPress version, PHP version, installed plugins, theme architecture, and existing tooling.

Retrieval Sources

This listing is grounded in:

• The WordPress/agent-skills repository README.
• The repository's AI authorship disclosure.
• Representative skill manifests for routing, block development, plugin development, REST APIs, performance, and Playground.
• The GPL-2.0-or-later license text.
• Repository metadata from the official WordPress GitHub organization.

Core Workflow

List available skills:

npx skills add WordPress/agent-skills --list

Install the router skill to classify a WordPress repository and route work:

npx skills add WordPress/agent-skills --skill wordpress-router

Install focused skills for a project:

npx skills add WordPress/agent-skills --skill wp-plugin-development wp-block-development wp-playground

The repository also includes build and install scripts for global or project scope installation across Claude Code, Codex, VS Code/GitHub Copilot, and Cursor targets.

Capability Scope

The repository currently lists these skills:

Production Rules

Use these skills to make WordPress changes more disciplined, but keep site safety explicit:

• Run repository triage before broad edits so the agent understands whether it is touching a plugin, theme, block theme, WordPress core checkout, or full site.
• Prefer existing project tooling and conventions over invented structure.
• Review every security-sensitive change for nonces, capabilities, sanitization, escaping, SQL preparation, REST permission callbacks, and authorization logic.
• Add block deprecations when saved markup changes.
• Test plugin activation, settings saves, REST routes, WP-CLI commands, and build outputs before shipping.
• Avoid production write operations unless the user has explicitly approved the target site, command, backup plan, and rollback path.

Use Cases

• Ask Codex to triage a WordPress plugin repo before editing hooks or settings.
• Have Claude Code add a Gutenberg block with block.json, rendering, and deprecation guidance.
• Use Cursor to audit REST endpoints for missing permission callbacks or weak schema validation.
• Ask an agent to profile a slow backend route with WP-CLI and Query Monitor headers.
• Use WordPress Playground skills to create a disposable repro for a plugin or theme issue.

Source Review

• The README describes Agent Skills for WordPress as portable bundles for Claude, Copilot, Codex, Cursor, and other AI assistants.
• The README lists 17 skills covering routing, triage, blocks, themes, plugins, REST, Interactivity API, Abilities API, WP-CLI, performance, PHPStan, Playground, design system, plugin directory guidelines, and blueprints.
• The AI authorship disclosure states the skills were created from official Gutenberg trunk documentation and WordPress developer docs, generated with GPT-5.2 Codex, reviewed by WordPress contributors, and tested with AI assistants.
• Representative manifests document concrete workflows such as running triage scripts, listing blocks, using @wordpress/create-block, enforcing REST permission callbacks, and measuring backend performance before optimizing.
• The license file identifies the repository as GPL-2.0-or-later.

Duplicate Review

Checked current content/skills/, content/tools/, content/mcp/, open pull requests, and repository-wide content for WordPress Agent Skills, WordPress/agent-skills, wordpress-router, wp-block-development, wp-plugin-development, and wp-playground. No dedicated WordPress Agent Skills entry, exact source URL duplicate, target file, or open duplicate PR was found.

Disclosure

Editorial listing. No paid placement or affiliate link is used. The upstream repository discloses AI-assisted generation from official WordPress/Gutenberg documentation followed by WordPress contributor review and testing. The repository is GPL-2.0-or-later.