Claude Subagents And Skills
Last verified: 2026-05
Use this when: a generated project will use Claude Code skills, hooks, subagents, or agent teams.
Quick Answer
Start with one Claude session and CLAUDE.md. Add skills for repeatable workflows and subagents for focused review/research/test tasks. Use agent teams only for large tasks with separate ownership.
Checklist
- [ ]
CLAUDE.mdpoints toAGENTS.mdandagent_docs/. - [ ] Repeated workflows live in
.claude/skills/*/SKILL.md. - [ ] Repeated roles live in
.claude/agents/*.md. - [ ] Shared permissions/hooks live in
.claude/settings.json. - [ ] Shell, write, network, MCP, production, billing, and destructive tools stay ask-first unless explicitly approved.
- [ ] Subagents have narrow scope and do not edit overlapping files.
Example
text
Read AGENTS.md and agent_docs/testing.md.
Review only the auth diff. Return prioritized findings with file/line references.
Do not edit files.