콘텐츠로 이동

Skills vs Agents vs Sub-agents vs Agent Teams

한 줄 정의

Claude Code에서 작업을 위임하는 4가지 방법. 각각 독립성과 협업 수준이 다르다.

비유

  • Skill = 레시피 카드 (같은 셰프가 레시피 보고 요리)
  • Agent = 전문 요리사 1명 고용 (별도 주방에서 독립 작업)
  • Sub-agent = 심부름꾼 여러 명 (각자 재료 사오고 보고만)
  • Agent Team = 프로젝트팀 (서로 토론하며 코스 요리 완성)

4가지 비교표

Skill Agent Sub-agent Agent Team
위치 .claude/skills/이름/SKILL.md .claude/agents/이름.md 코드 내 Agent 도구 코드 내 TeamCreate
실행 방식 /이름 슬래시 커맨드 /agents에서 선택 세션 중 spawn 세션 중 팀 생성
인스턴스 같은 대화 (프롬프트 주입) 별도 1개 별도 여러 개 별도 여러 개
서로 대화 - - 못함 (나한테만 보고) 함 (토론, 반박)
도구 제한 못함 가능 (읽기 전용 등) 가능 리더 권한 상속
모델 선택 현재 모델 에이전트별 지정 spawn 시 지정 spawn 시 지정
컨텍스트 현재 대화 유지 독립 (대화 없음) 독립 독립 + 공유 작업목록
비용 낮음 보통 보통 높음 (인원 x 토큰)

의사결정 트리

"이 작업을 어떻게 시킬까?"
  |
  |- 반복 지시사항인가? (매번 같은 순서로)
  |    -> YES -> Skill (/slash 커맨드)
  |
  |- 도구를 제한하거나 다른 모델을 쓰고 싶은가?
  |    -> YES -> Agent (전문가 프로필 등록)
  |
  |- 여러 작업을 동시에 병렬로 하고 싶은가?
  |    |- 서로 대화 필요 없다 -> Sub-agent (결과만 보고)
  |    |- 서로 토론/반박 필요 -> Agent Team (협업)
  |
  |- 간단한 1회성 작업인가?
       -> 그냥 말로 시키기

1. Custom Skills (.claude/skills/)

구조

~/.claude/skills/
├── start/
|   └── SKILL.md      <- /start 커맨드가 됨
├── ebook/
|   └── SKILL.md      <- /ebook 커맨드가 됨
└── ...

SKILL.md 형식

---
name: start
description: 세션 시작 루틴
disable-model-invocation: true    # 자동 트리거 방지
argument-hint: "[오늘 목표]"       # 인자 힌트
---

실행 지시사항...

$ARGUMENTS    <- 사용자가 /start 뒤에 쓴 텍스트가 여기로

핵심 포인트

  • disable-model-invocation: true -> 사용자가 직접 /이름 쳐야만 실행
  • $ARGUMENTS -> 인자 전달 (없으면 물어보게 설계)
  • / 치면 자동완성 목록 뜸
  • 기존 Option C 스킬(C:\Projects\my-skills\)과 병행 가능

Option C 스킬 vs Custom Skills 차이

Option C (기존) Custom Skills (신규)
위치 C:\Projects\my-skills\ ~/.claude/skills/
호출 자연어 ("기획팀 돌려줘") 슬래시 (/ebook 기획팀)
실행 Claude가 SKILL.md Read 시스템이 자동 주입
자동완성 없음 / 치면 목록 뜸
공존 가능 - 둘 다 쓸 수 있음

2. Agents (.claude/agents/)

아직 안 만듦 (필요할 때 제안 예정)

언제 필요한가?

  • 같은 전문가 페르소나를 여러 스킬에서 재사용하고 싶을 때
  • 특정 에이전트에 도구 제한을 걸고 싶을 때 (읽기 전용 등)
  • 특정 에이전트에 다른 모델을 쓰고 싶을 때 (Haiku로 절약 등)

파일 형식 (예시)

---
name: editor
model: sonnet
tools: [Read, Grep, Glob, WebSearch, WebFetch]    # 편집 도구 제외
---

당신은 20년 경력 편집장입니다...

3. Sub-agents (Agent 도구)

이미 쓰고 있음

Agent(subagent_type="Explore", prompt="패턴 분석해줘")
- 결과만 나한테 돌아옴 - 서로 대화 못함 - 병렬 가능 (여러 개 동시 spawn)

4. Agent Teams (TeamCreate)

이미 쓰고 있음 (기획팀 05)

TeamCreate -> Agent(editor) + Agent(reader) + Agent(coach) + Agent(analyst)
-> 공유 작업 목록 -> R1~R4 라운드 -> shutdown -> TeamDelete
- 서로 메시지 주고받음 (SendMessage) - 공유 작업 목록 (TaskCreate/TaskUpdate) - 리더가 조율

활성화 필수

{ "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" } }

현재 우리 세팅 (2026-02-28)

개념 상태 내용
Custom Skills 8개 생성 start, wrap, archive, weekly-report, ebook, youtube, project-init, cmd
Option C Skills 6개 운영 youtube-workflow, ebook, youtube-ppt, lecture-content, customer-response, blog
Agents 미사용 필요할 때 제안 예정
Sub-agents 수시 사용 Explore, general-purpose 등
Agent Teams 기획팀(05) editor/reader/coach/analyst 4인 팀

참고