# capability-documentation

The capability-documentation skill helps document other skills with clear structure, examples, and behavior checks. It fits reusable agent guidance that needs verification.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 130 installs · ★ 50 repo stars
- Author: qodex-ai
- License: LicenseRef-Proprietary · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qodex-ai/ai-agent-skills/tree/HEAD/skills/capability-documentation/SKILL.md
- Updated: 2026-01-05
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/capability-documentation

## What it does

The skill treats skill documentation as a RED-GREEN-REFACTOR cycle. Start with pressure scenarios for subagents before writing the document, record the baseline failures, add targeted rules to `SKILL.md`, then run the scenarios again to check compliance.

It covers skill categories, the `skills/skill-name/` layout, YAML requirements for `name` and `description`, and decisions about inline content versus supporting files. It also explains how to write descriptions that help Claude find the right skill without replacing the document’s actual instructions.

You need to understand `superpowers:test-driven-development` first. The skill uses that cycle as its foundation, so this prerequisite affects how the guidance is applied.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill capability-documentation -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill capability-documentation -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill capability-documentation -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install qodex-ai/ai-agent-skills skills/capability-documentation
```

2. **Manually: put the files in place**
- File: `.github/skills/capability-documentation/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill capability-documentation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/qodex-ai/ai-agent-skills --path skills/capability-documentation
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill capability-documentation -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/qodex-ai/ai-agent-skills/tree/HEAD/skills/capability-documentation/SKILL.md

## When to use it
- write a reusable `SKILL.md` reference
- test an agent’s baseline behavior before documentation
- close loopholes in skill instructions
- separate heavy references from inline guidance
- make a skill easier for Claude to discover

## Example prompts
- Create a reusable skill guide for a technique that applies across projects.
- Run pressure scenarios with subagents to see which rules an agent breaks before `SKILL.md` exists.
- Draft `SKILL.md` with YAML metadata, common mistakes, and a quick reference section.

## Similar
- [product-capability](https://affpapa.org/en/nevibecode/skills/product-capability.md) — skill · 6300 installs
- [writing-skills](https://affpapa.org/en/nevibecode/skills/writing-skills.md) — skill · 217894 installs
- [capability-evolver](https://affpapa.org/en/nevibecode/skills/capability-evolver.md) — skill · 5000 installs
- [create-skill](https://affpapa.org/en/nevibecode/skills/neolabhq-create-skill.md) — skill · 1300 installs
- [platform-capability-search](https://affpapa.org/en/nevibecode/skills/platform-capability-search.md) — skill · 2900 installs
- [jev-capability-advisor](https://affpapa.org/en/nevibecode/skills/jev-capability-advisor.md) — skill · 2700 installs

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