# Implement Sub Agents

> Create and validate Claude sub-agent definitions with correct frontmatter, tool permissions, and delegation boundaries. Use when this capability is needed.

- Skill: `tomevault-io/implement-sub-agents-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/implement-sub-agents-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/implement-sub-agents-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/implement-sub-agents-2

---


# Implement Sub-Agents

Create or update agent files under `agents/` with explicit role boundaries, model/tool settings, and delegation patterns.

## Workflow

1. Define the sub-agent role and scope boundaries.
2. Author/update agent markdown with valid frontmatter.
3. Set tool/model/permission configuration based on least privilege.
4. Validate frontmatter and basic agent file shape.
5. Connect with related skills/hooks only when required.

## Progressive Disclosure

- Agent frontmatter rules: `references/subagent-frontmatter.md`
- Tool access strategy: `references/subagent-tools.md`
- Model selection guidance: `references/subagent-models.md`
- Permission boundaries: `references/subagent-permissions.md`
- Delegation patterns: `references/subagent-delegation.md`

- Agent file validator: `scripts/validate-subagent.sh`
- Frontmatter checker: `scripts/check-subagent-frontmatter.sh`

- Base sub-agent template: `assets/templates/subagent-template.md`
- Read-only sub-agent example: `assets/templates/subagent-readonly.md`
- Sub-agent with skills example: `assets/templates/subagent-with-skills.md`
- Sub-agent with hooks example: `assets/templates/subagent-with-hooks.md`

## Related Skills

- Umbrella routing and architecture: `../implement-claude-extensions/SKILL.md`
- Agent team coordination: `../implement-agent-teams/SKILL.md`

## Sources

- https://code.claude.com/docs/en/sub-agents
- https://code.claude.com/docs/en/plugins

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/yu-iskw) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->

