Claude Code: Skills vs Subagents

핵심 차이

Skills: 모든 에이전트가 따라야 하는 규칙과 가이드라인
Subagents: 특정 작업을 독립적으로 처리하는 전문 에이전트

비유하자면 Skills는 회사 내규, Subagents는 전문 팀원입니다.

실제 사용법

Skills 예시

# commit-convention.md
feat: 새 기능, fix: 버그 수정, docs: 문서 변경

# api-response.md
{ success: boolean, data: any, error: string | null }

메인 에이전트든 서브 에이전트든 자동으로 적용됩니다.

Subagents 예시

• code-reviewer: 보안, 성능 체크
• test-generator: 테스트 코드 생성
• api-designer: API 스펙 설계

각자 독립 컨텍스트에서 작업하고, 완료된 결과만 메인에게 전달합니다.

워크플로우 예시

메인: "로그인 API 만들어"
  ↓
api-designer (subagent): 스펙 설계 → api-response.md 적용
  ↓
메인: 구현 → commit-convention.md 적용
  ↓
test-generator (subagent): 테스트 생성

선택 기준

Subagent 사용:

• 반복 작업 (여러 파일 리팩토링)
• 독립 작업 (테스트 생성)
• 전문 분석 (보안 감사)

메인 + Skills만:

• 전체 맥락 필요
• 반복 의사결정 필요
• 실시간 조정 필요

주의사항

Subagent는 컨텍스트가 분리되므로, 작업 과정의 세부사항이 메인에게 전달되지 않습니다. 전체 흐름 파악이 중요한 작업엔 신중하게 사용하세요.

참고: Anthropic Skills | Subagents 문서