Claude Code Extension Guide
Reference for creating and configuring Claude Code extensions.
Overview
| Extension | Purpose | Details |
|---|---|---|
| Sub-agents | Custom agents that delegate specific tasks | sub-agents.md |
| Plugins | Extension packages shared across projects | plugins.md |
| Skills | Condition-based processing auto-selected and executed | skills.md |
| CLI Auto-approval | Non-interactive mode for CI/CD | cli-automation.md |
Quick Reference
File Placement
~/.claude/ # User level (all projects)
├── agents/agent-name.md
├── skills/skill-name/SKILL.md
└── plugins/...
.claude/ # Project level (version control recommended)
├── agents/agent-name.md
└── skills/skill-name/SKILL.md
Built-in Sub-agents
Explore: Read-only, for codebase explorationPlan: For planninggeneral-purpose: Complex multi-step tasks
Detailed Documentation
See the following for details on each extension:
sub-agents.md- How to create sub-agentsplugins.md- Plugin structure and configurationskills.md- Skill definition and metadatacli-automation.md- CLI auto-approval and headless mode
Official Documentation
- Sub-agents
- Plugins
- Skills
- Headless/CLI
- CHANGELOG - Always check when researching latest features
Research Notes
When researching Claude Code features and settings, always check:
- CHANGELOG.md - Understand features added/changed in latest versions
- Official documentation - Verify detailed specs at links above
- Consistency with existing settings - Ensure no conflicts with this repository's settings