subagent-creatorlisted

# Subagent Creator Claude Code의 **subagent 정의 파일**(`.claude/agents/<name>.md`)을 대화형으로 만드는 스킬이다. 사용자가 "X를 하는 에이전트를 만들어줘"라고 하면, 역할을 구체화하고 frontmatter와 시스템 프롬프트를 작성한 뒤 검증까지 마친 정의 파일을 생성한다. subagent 는 Claude Code 가 특정 작업을 **위임(delegate)** 할 수 있는 독립 에이전트다. 자체 컨텍스트 창과 도구 권한, 시스템 프롬프트를 가지며, 메인 대화의 컨텍스트를 어지럽히지 않고 전문화된 일을 수행한다. 잘 만든 subagent 의 핵심은 두 가지뿐이다. | 무엇이 | 어디서 결정되는가 | | --- | --- | | **언제** 위임되는가 | `description` | | **무엇을 어떻게** 하는가 | 본문(시스템 프롬프트) | 나머지 필드는 이 둘을 거드는 장치다. ## subagent 정의 형식 정의 파일은 YAML frontmatter + Markdown 본문(시스템 프롬프트)으로 구성된다. ```markdown --- name: code-reviewer description: Expert code review specialist. Use proactively right after writing or modifying code, before committing. tools: Read, Grep, Glob, Bash model: sonnet --- 너는 코드 리뷰 전문가다. ...(시스템 프롬프트 본문)... ``` | 필드 | 필수 | 설명 | | --- | :---: | --- | | `name` | ✅ | kebab-case 식별자. **파일명(확장자 제외)과 일치**해야 한다 | | `description` | ✅ | **언제 위임할지**. 자동 위임 판단의 핵심 | | `tools` | | 콤마 구분 도구 allowlist. **생략 시 메인 스레드의 모든 도구를 상속** | | `model` | | 모델 별칭(`sonnet`, `opus`, `haiku`, `fable`) 또는 전체 모델 ID. 생략 시 기본값 | | `effort` | | `low` / `medium` / `high` / `xhigh` / `max` | | `maxTurns` | | 최대 agentic turn 수(1 이상의 정수) | | `skills` | | 시작할 때 preload 할 스킬 이름 목록 | | `isolation` | | `worktree` 이면 임시 git worktree 에서 실행 | | `hooks` | | 이 에이전트에만 적용할 lifecycle hook 매핑 | 본문 전체가 subagent 의 **시스템 프롬프트**다. 필드별 상세, 도구 목록, 경로 규칙은 [references/agent-format.md](references/agent-format.md) 에 있다. `SKILL.md` 는 활성화 시점에 통째로 컨텍스트에 들어가므로 여기