# wp-ability-development

wp-ability-development — a Claude Code skill for designing and reviewing WordPress ability schemas and behavior. It activates when an agent works on an ability’s contract.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 281 installs · ★ 2390 repo stars
- Author: WordPress
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/WordPress/agent-skills/tree/HEAD/skills/wp-ability-development/SKILL.md
- Updated: 2026-10-21
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/wp-ability-development

## What it does

The skill helps define what a WordPress ability accepts, returns, and changes. It frames schema decisions around the caller’s task, with precise input fields and a predictable success result. Related fields can be grouped into nested schemas, while distinct request forms can be modeled separately.

It also covers errors, empty results, and consistent naming across CRUD abilities. The skill targets WordPress 7.0+ and PHP 7.4.0+. Changes to a published ability call for attention to its documentation, tests, and existing call sites.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add WordPress/agent-skills --skill wp-ability-development -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-ability-development/SKILL.md

## When to use it
- shape ability inputs around the caller’s task
- keep collection results consistent when queries return different numbers of records
- separate failed reads from successful empty results
- align field names and types across CRUD abilities

## Example prompts
- Design a WordPress ability schema to find published posts by author.
- Review an ability contract that looks up a record by ID or slug.
- Update the input and output fields for this WordPress ability’s create operation.

## Similar
- [mongoose-mongodb](https://affpapa.org/en/nevibecode/skills/mongoose-mongodb.md) — skill · 702 installs
- [wordpress-development-expert](https://affpapa.org/en/nevibecode/agents/wordpress-development-expert.md) — subagent · ★ 372 repo stars
- [laravel-api-tool-kit](https://affpapa.org/en/nevibecode/plugins/laravel-api-tool-kit.md) — plugin · ★ 530 repo stars
- [wordpress-pro](https://affpapa.org/en/nevibecode/skills/wordpress-pro.md) — skill · 10400 installs
- [wp-guard](https://affpapa.org/en/nevibecode/skills/wp-guard.md) — skill · 2700 installs
- [woocommerce-code-review](https://affpapa.org/en/nevibecode/skills/woocommerce-code-review.md) — skill · 1900 installs

From the same set: [wordpress/agent-skills](https://affpapa.org/en/nevibecode/by/wordpress/agent-skills.md) — 20 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
