# Add Capability Doc

> Scaffold a new capability primer under docs/primers/ and add the capability to the repo README taxonomy.

- Skill: `microsoft-foundry/add-capability-doc` (Agent Skill)
- Install (CLI): `npx skillmds@latest add microsoft-foundry/add-capability-doc`
- Raw SKILL.md: https://api.skillmd.com/api/skills/microsoft-foundry/add-capability-doc/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: microsoft-foundry (https://skillmd.com/u/microsoft-foundry)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/microsoft-foundry/add-capability-doc

---


# add-capability-doc

Creates a new primer file with frontmatter validated by
[`primer.schema.json`](../../specs/schemas/primer.schema.json), and
appends a row to the **Capability taxonomy** table in the repo README.

Also updates the [`capsule.schema.json`](../../specs/schemas/capsule.schema.json)
`capabilities` enum so future capsules can tag themselves with the new
capability. (Author confirms this schema change explicitly.)