What it does
Use when building, extending, or debugging WordPress REST API endpoints/routes: register_rest_route, WP_REST_Controller/controller classes, schema/argument validation, permission_callback/authentication, response shaping, register_rest_field/register_meta, or exposing CPTs/taxonomies via show_in_rest.
Install
This skill ships in WordPress/agent-skills (Official, WordPress core fundamentals).
One command installs it for any assistant. Run this from your project root:
npx skills add WordPress/agent-skills --skill wp-rest-apiYou'll be asked to choose a scope: project (shared with your team, committed to version control) or global (available across all your projects). Add --global to skip the prompt and install globally.
Use it in your AI assistant
The destination folder, and how the assistant discovers it, differs per tool:
Claude Code
.claude/skills/wp-rest-api/ (or ~/.claude/skills/wp-rest-api/ for all projects)
- Claude Code auto-discovers skills in .claude/skills/ (project) or ~/.claude/skills/ (global, every project).
- Claude reaches for the skill on its own when a task matches its description, or you can name it directly.
GitHub Copilot (VS Code)
.github/skills/wp-rest-api/
- The skill is copied into .github/skills/wp-rest-api/, where Copilot in VS Code picks it up.
- Copilot Chat applies it automatically once your task matches the skill's description.
OpenAI Codex
.codex/skills/wp-rest-api/
- This installs the skill to .codex/skills/wp-rest-api/, which Codex reads for standing instructions on matching tasks.
- Point Codex at it directly if needed: "follow .codex/skills/wp-rest-api/SKILL.md for this task."
Cursor
.cursor/skills/wp-rest-api/ (or ~/.cursor/skills/wp-rest-api/ globally)
- Cursor discovers skills in .cursor/skills/ (project) or ~/.cursor/skills/ (global).
- Cursor loads it automatically when a request matches, same as its native Rules.
Compatibility
Targets WordPress 7.0+ (PHP 7.4.0+). Filesystem-based agent with bash + node. Some workflows require WP-CLI.