wp-abilities-audit — Claude Code skill: audit and install
This skill reviews a WordPress plugin’s REST surface and writes a planning document for proposed Abilities API registrations.
npx skills add WordPress/agent-skills --skill wp-abilities-audit -a claude-codeWhat wp-abilities-audit does
wp-abilities-audit examines a WordPress plugin checkout and turns its REST surface into a Markdown audit. The document records controllers, routes, HTTP methods, callbacks, permission checks, and a YAML model for proposed Abilities API registrations. Candidates are grouped by user intent, while internal transport routes stay in the inventory.
Each proposed ability gets an intent, backing path, permission details, return type, effort rating, annotations, risks, side effects, and seed-data requirements. The workflow needs a plugin checkout, a successful wp-project-triage run, an auditor identity, and an explicit output path. The audit cannot start without a successful wp-project-triage run. Use a filesystem-based environment with bash and node; WP-CLI can help with some workflows but is not required.
What it helps with
- review a WordPress plugin’s REST surface
- map controllers, routes, and callback details
- trace read and write capability gates
- group REST behavior into Abilities API proposals
- record rollout gaps, risks, and deferred candidates
Example prompts for the agent
- Audit this plugin’s REST surface and write the result to
audit.md. - Run
wp-project-triage, then prepare Abilities API registration proposals for the plugin checkout. - Build the controller inventory, trace permissions, and record the seed data needed to test each proposed ability.
How to install wp-abilities-audit
1Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wp-abilities-audit -a claude-code2Manually: put the files in place
~/.claude/skills/wp-abilities-audit/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/wp-abilities-audit/
1Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wp-abilities-audit -a codex2Manually: put the files in place
.agents/skills/wp-abilities-audit/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wp-abilities-audit -a cursor2Manually: put the files in place
.cursor/skills/wp-abilities-audit/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install WordPress/agent-skills wp-abilities-audit2Manually: put the files in place
.github/skills/wp-abilities-audit/SKILL.md1Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wp-abilities-audit -a gemini-cli2Platform CLI
gemini skills install https://github.com/WordPress/agent-skills --path skills/wp-abilities-auditManually: put the files in place
.devin/skills/wp-abilities-audit/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wp-abilities-audit -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about wp-abilities-audit
How do I install wp-abilities-audit in Claude Code?
Run npx skills add WordPress/agent-skills --skill wp-abilities-audit -a claude-code, then use ~/.claude/skills/wp-abilities-audit/SKILL.md.
What does wp-abilities-audit do?
It inspects a WordPress plugin’s REST controllers and creates a Markdown audit with a YAML schema, route inventory, and proposed Abilities API registrations.
What must be ready before the audit runs?
Provide a plugin checkout, a successful wp-project-triage result, an auditor identity, and an output path. The plugin also needs at least one REST controller.
