Use when creating, updating, or maintaining AI documentation files (AGENTS.md, CLAUDE.md, skills). Covers file structure, conventions, and guidelines for evolving AI context.
How to write and maintain the structured documentation that AI coding assistants consume.
AGENTS.md # Root context — always loaded by agents
CLAUDE.md # Required for Claude Code (loads AGENTS.md)
.github/skills/<topic>/SKILL.md # On-demand detailed context
packages/<name>/AGENTS.md # Package-specific context
<any-folder>/AGENTS.md # Folder-specific context
Always loaded on every interaction. Keep it minimal to save tokens.
Must contain:
SKILL.mdMust not contain:
Required because Claude Code doesn't load AGENTS.md natively. It bridges Claude Code into the same context system. Contents:
Read [AGENTS.md](AGENTS.md) before starting any task.
## Skills
Load these for detailed context on specific topics:
| Skill | When to use |
|-------|-------------|
| [<name>](.github/skills/<name>/SKILL.md) | <description> |
Keep in sync with the skills table in AGENTS.md.
.github/skills/<topic>/SKILL.mdname and descriptionAGENTS.md and CLAUDE.md---