Skip to main content
skill CX Codex

capability-documentation — Claude Code skill: install

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

LicenseRef-Proprietary 130 installs ★ 50 updated 2026-01-05

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add qodex-ai/ai-agent-skills --skill capability-documentation -a claude-code
Open on GitHub

What capability-documentation 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.

What it helps with

  • 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 for the agent

  • 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.

How to install capability-documentation

1Skills CLI (Vercel)

npx skills add qodex-ai/ai-agent-skills --skill capability-documentation -a claude-code

2Manually: put the files in place

~/.claude/skills/capability-documentation/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/capability-documentation/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about capability-documentation

How do I install capability-documentation in Claude Code?

Run npx skills add qodex-ai/ai-agent-skills --skill capability-documentation -a claude-code, then check ~/.claude/skills/capability-documentation/SKILL.md.

What does capability-documentation do?

It guides the creation of skill documentation through baseline behavior checks, targeted rules, and a second verification pass with the agent.

What do I need before using capability-documentation?

You need to understand superpowers:test-driven-development first. This skill applies that RED-GREEN-REFACTOR cycle to documentation work.

Similar skills

All skills for Writing and docs →

From the same set42

The whole set →
peer-review-initiator peer-review-initiator builds a review request for your agent: commit SHAs, what changed, what it should do. Then hands it to a reviewer subagent. CX Codex +1 133installs selection-randomizer selection-randomizer is a Claude Code skill that randomly picks winners and participants from lists. It can apply weights and exclude past winners. CX Codex +1 133installs branch-finalization branch-finalization verifies tests, presents four clear next steps, and handles merging, pull requests, or branch cleanup. CX Codex +1 131installs autonomous-cloud-orchestration autonomous-cloud-orchestration walks your agent through AWS Bedrock AgentCore: picking the right service and wiring the deployment with the AWS CLI. CX Codex +1 131installs workspace-isolation workspace-isolation creates separate Git worktrees for parallel branch work. Use it when changes need their own working directories and a verified starting state. CX Codex +1 130installs deployment-automation deployment-automation — a skill that automates Vercel deployments with build error fixes. The agent runs vercel --prod, reads logs via MCP tool, and patches code until deployment succeeds. CX Codex +1 129installs directive-synthesis directive-synthesis is a Claude Code skill for building slash commands, from arguments and frontmatter to Bash steps and testing. CX Codex +1 127installs media-transformation media-transformation rewrites uniform JSON arrays as TOON v2.0, with field names declared once and rows after. Useful when repeated records fill your context. CX Codex +1 126installs

Project sponsors

Companies that keep this analytics open