Agent Skills for WordPress
Official WordPress skill set for AI assistants: blocks, themes, plugins, REST API, WP-CLI and performance
Medium risk
We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.
Why this level
- Scripts run in Node.js and scan project files
- Some skills drive WP-CLI operations that can change a WordPress database
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/agent-skills-for-wordpressDetects the agents on your machine, checks the risk and pins the version.
Other ways to install
Run in a terminal in the project folder
npx skills add wordpress/agent-skills --skill wp-plugin-development -a claude-code -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 9f4a603
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/wordpress/agent-skills.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/wp-plugin-development/
git -C "$tmp" checkout 9f4a603340bc7a474037967f66459391087e9165
mkdir -p .claude/skills
cp -R "$tmp/skills/wp-plugin-development" .claude/skills/wp-plugin-developmentCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add wordpress/agent-skills --skill wp-plugin-development -a cursor -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 9f4a603
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/wordpress/agent-skills.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/wp-plugin-development/
git -C "$tmp" checkout 9f4a603340bc7a474037967f66459391087e9165
mkdir -p .agents/skills
cp -R "$tmp/skills/wp-plugin-development" .agents/skills/wp-plugin-developmentCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add wordpress/agent-skills --skill wp-plugin-development -a github-copilot -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 9f4a603
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/wordpress/agent-skills.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/wp-plugin-development/
git -C "$tmp" checkout 9f4a603340bc7a474037967f66459391087e9165
mkdir -p .github/skills
cp -R "$tmp/skills/wp-plugin-development" .github/skills/wp-plugin-developmentCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add wordpress/agent-skills --skill wp-plugin-development -a codex -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 9f4a603
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/wordpress/agent-skills.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/wp-plugin-development/
git -C "$tmp" checkout 9f4a603340bc7a474037967f66459391087e9165
mkdir -p .agents/skills
cp -R "$tmp/skills/wp-plugin-development" .agents/skills/wp-plugin-developmentCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add wordpress/agent-skills --skill wp-plugin-development -a gemini-cli -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 9f4a603
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/wordpress/agent-skills.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/wp-plugin-development/
git -C "$tmp" checkout 9f4a603340bc7a474037967f66459391087e9165
mkdir -p .agents/skills
cp -R "$tmp/skills/wp-plugin-development" .agents/skills/wp-plugin-developmentCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/wordpress/agent-skills.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/wp-plugin-development/
git -C "$tmp" checkout 9f4a603340bc7a474037967f66459391087e9165
mkdir -p .devin/skills
cp -R "$tmp/skills/wp-plugin-development" .devin/skills/wp-plugin-developmentCommands for macOS and Linux, on Windows run them in Git Bash.
Formerly Windsurf.
Run in a terminal in the project folder
npx skills add wordpress/agent-skills --skill wp-plugin-development -a cline -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 9f4a603
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/wordpress/agent-skills.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/wp-plugin-development/
git -C "$tmp" checkout 9f4a603340bc7a474037967f66459391087e9165
mkdir -p .cline/skills
cp -R "$tmp/skills/wp-plugin-development" .cline/skills/wp-plugin-developmentCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add wordpress/agent-skills --skill wp-plugin-development -a roo -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 9f4a603
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/wordpress/agent-skills.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/wp-plugin-development/
git -C "$tmp" checkout 9f4a603340bc7a474037967f66459391087e9165
mkdir -p .roo/skills
cp -R "$tmp/skills/wp-plugin-development" .roo/skills/wp-plugin-developmentCommands for macOS and Linux, on Windows run them in Git Bash.
A fork of Roo Code, same .roo folders.
Run in a terminal in the project folder
npx skills add wordpress/agent-skills --skill wp-plugin-development -a opencode -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 9f4a603
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/wordpress/agent-skills.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/wp-plugin-development/
git -C "$tmp" checkout 9f4a603340bc7a474037967f66459391087e9165
mkdir -p .agents/skills
cp -R "$tmp/skills/wp-plugin-development" .agents/skills/wp-plugin-developmentCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/wordpress/agent-skills.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/wp-plugin-development/
git -C "$tmp" checkout 9f4a603340bc7a474037967f66459391087e9165
mkdir -p .agents/skills
cp -R "$tmp/skills/wp-plugin-development" .agents/skills/wp-plugin-developmentCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/wordpress/agent-skills.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/wp-plugin-development/
git -C "$tmp" checkout 9f4a603340bc7a474037967f66459391087e9165
mkdir -p .agents/skills
cp -R "$tmp/skills/wp-plugin-development" .agents/skills/wp-plugin-developmentCommands for macOS and Linux, on Windows run them in Git Bash.
Install the needed skill with npx skills add WordPress/agent-skills --skill wp-plugin-development. List all skills with npx skills add WordPress/agent-skills --list. Then follow the SKILL.md procedures.
Other ways from the author
npx skills add WordPress/agent-skills --skill wp-plugin-developmentInstalls one skill into the current project. The --global flag installs for all projects, --list shows the catalog.
This is third-party code. Review the repository files before installing.
What it does
The WordPress set gives an AI assistant ready procedures for WordPress work instead of guessing from memory. It covers Gutenberg blocks, block themes, patterns, plugins, REST API, the Interactivity API, the Abilities API, WP-CLI, performance, PHPStan and WordPress Playground, plus a router skill that classifies the repository and points to the right procedure. Each skill is a folder with a SKILL.md file, topic references and, for some, deterministic scripts that scan the project. Skills install globally or inside a repository and work in Claude Code, Cursor, Codex, VS Code and Copilot.
Who it is for. For WordPress developers who build blocks, themes and plugins with an AI assistant.
Good fit when
- You develop a WordPress block, theme or plugin and want the agent to follow current practices
- You need to avoid the Invalid block error when changing markup and add correct deprecations
- You need safe WP-CLI operations, REST API work or performance profiling
Not a fit when
- The project is not WordPress
- Your agent does not support project-level skills or instructions
Example request
Add a dynamic Gutenberg block with render.php and set up deprecations so existing posts do not breakLimitations
These are instructions and helper scripts, not a WordPress plugin: they help only inside an agent that can read project-level skills. The material targets WordPress 7.0+ and PHP 7.4+. The v1 skills were generated by AI from official docs and edited by contributors, who plan to improve them over time. Scripts run in Node.js.
How to disable. Remove the copied skill folders from ~/.claude/skills/ or from the project's skills directory (.claude/skills/, .cursor/skills/, .codex/skills/, .github/skills/).
Security check
- Scripts run in Node.js and scan project files
- Some skills drive WP-CLI operations that can change a WordPress database
README in short
The README presents the skills as portable bundles of instructions, references and scripts that teach an AI assistant to build WordPress by current rules and avoid outdated patterns. A table lists the skills: router, project triage, blocks, block themes, patterns, plugins, REST and Interactivity APIs, the Abilities API and its audit, WP-CLI, performance, PHPStan, Playground, the design system and plugin directory guidelines. Install paths are shown: the npx skills add command, build and install via scripts in shared/scripts, and manual folder copying. Skills install globally or into a specific repository and can be committed for the team. Licensed GPL-2.0-or-later.
SKILL.md
--- name: wp-block-development description: "Use when developing WordPress (Gutenberg) blocks: block.json metadata, register_block_type(_from_metadata), attributes/serialization, supports, dynamic rendering (render.php/render_callback), deprecations/migrations, viewScript vs viewScriptModule, and @wordpress/scripts/@wordpress/create-block build and test workflows." compatibility: "Targets WordPress 7.0+ (PHP 7.4.0+). Filesystem-based agent with bash + node. Some workflows require WP-CLI." --- # WP Block Development ## When to use Use this skill for block work such as: - creating a new block, or updating an existing one - changing block.json (scripts/styles/supports/attributes/render/viewScriptModule) - fixing block invalid / not saving / attributes not persisting - adding dynamic rendering (render.php / render_callback) - block deprecations and migrations (deprecated versions) - build tooling for blocks (@wordpress/scripts, @wordpress/create-block, wp-env) ## Inputs required - Repo root and target (plugin vs theme vs full site). - The block name/namespace and where it lives (path to block.json if known). - Target WordPress version range (especially if using modules / viewScriptModule). ## Procedure ### 0) Triage and locate blocks 1. Run triage: node skills/wp-project-triage/scripts/detect_wp_project.mjs 2. List blocks (deterministic scan): node skills/wp-block-development/scripts/list_blocks.mjs 3. Identify the block root (directory containing block.json) you are changing.
FAQ
Do I have to install every skill?
No. With npx skills add or the install script you can pick only the ones you need, for example wp-block-development and wp-playground.
Which agents does it work with?
Any that read project-level skills or instructions: Claude Code, Cursor, Codex, VS Code and Copilot. The install script lays skills into each one's directory.
Related
A skills library that gives coding agents a development process: brainstorming, planning, TDD, subagents and code review
Skills for real engineers by Matt Pocock
Skills For Real Engineers
Small composable skills for engineering with agents: plan grilling, TDD, bug diagnosis, code review and architecture
GitHub toolkit for spec-driven development: the specify CLI adds agent commands and skills to a project, from principles to implementation
Reference MCP servers
Model Context Protocol servers
Official reference MCP servers: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time and Everything