# wp-abilities-audit

This skill reviews a WordPress plugin’s REST surface and writes a planning document for proposed Abilities API registrations.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2700 installs · ★ 2298
- Author: WordPress
- License: LicenseRef-Unknown · policy=link-only · description only; the file stays with the author
- Source: https://github.com/WordPress/agent-skills/tree/HEAD/skills/wp-abilities-audit/SKILL.md
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/skills/wp-abilities-audit

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add WordPress/agent-skills --skill wp-abilities-audit -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/wp-abilities-audit/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/wp-abilities-audit/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add WordPress/agent-skills --skill wp-abilities-audit -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/wp-abilities-audit/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add WordPress/agent-skills --skill wp-abilities-audit -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/wp-abilities-audit/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install WordPress/agent-skills wp-abilities-audit
```

2. **Manually: put the files in place**
- File: `.github/skills/wp-abilities-audit/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add WordPress/agent-skills --skill wp-abilities-audit -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/WordPress/agent-skills --path skills/wp-abilities-audit
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/wp-abilities-audit/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add WordPress/agent-skills --skill wp-abilities-audit -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/WordPress/agent-skills/tree/HEAD/skills/wp-abilities-audit/SKILL.md

## When to use it
- 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
- 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.

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs

From the same set: [wordpress/agent-skills](https://affpapa.org/en/nevibecode/by/wordpress/agent-skills.md) — 19 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md