테마
Skill(스킬) 상세 구조
스킬이란?
스킬은 문서 양식(템플릿) 이다. "이 형식대로 쓰세요"라고 AI에게 알려주는 규격이다. 스킬이 있으면 AI가 매번 일관된 형식으로 문서를 작성한다.
스킬의 가장 큰 장점은 컨텍스트를 최소한으로 아끼면서 원하는 양식과 형식 그대로 결과물을 얻어낼 수 있다는 것이다.
스킬 파일 구조
Claude Code 기준 스킬 엔트리 파일은 .claude/skills/{스킬이름}/SKILL.md 이다. 보통 디렉터리 이름은 소문자와 하이픈을 사용한다.
Front Matter (권장)
yaml
---
name: prd-writer
description: PRD 작성 시 사용하는 스킬. PRD, 기획서, MVP, 기획, 사용자 스토리, 수용 기준 요청 시 활성화.
---- name: 선택 사항이지만, 지정할 경우 디렉터리명과 맞추고 소문자-하이픈 형식을 사용한다.
- description: 자동 활성화에 가장 중요한 필드다. 스킬이 무엇을 하는지 설명하고, 트리거 키워드를 나열한다.
Description 작성이 핵심
description에 적은 키워드가 대화에 포함되면 스킬이 자동으로 활성화된다.
나쁜 사례: 너무 짧고 일반적 → 활성화가 잘 안 됨 좋은 사례: 구체적인 트리거 키워드 나열 → 정확하게 활성화
본문 (Markdown)
Front Matter 아래에 마크다운으로 역할, 규칙, 출력 형식 등을 정의한다. AI는 스킬이 활성화되면 이 내용을 읽고 따른다.
스킬 활성화 흐름
SDD의 4가지 핵심 스킬
1. PRDWriter — 요구사항 정의서
- 역할: 서비스의 기능 요구사항을 정리한 문서(PRD)를 작성
- 핵심 형식: "~로서, ~하고 싶다, ~하기 위해" (User Story 형식)
- 트리거 키워드: PRD, 기획서, MVP, 기획, 사용자 스토리, 수용 기준
2. TechSpecWriter — 기술 명세서
- 역할: PRD의 "무엇을"에 대해 "어떻게" 구현할지 기술 명세 작성
- 전제 조건: PRD가 없으면 작성 불가 (없을 경우 Plan부터 실행 안내)
- 트리거 키워드: 기술 스펙, 기술 설계, 아키텍처, API, DB 설계, 파일 구조
3. SpecValidator — 스펙 검증기
- 역할: PRD와 Tech Spec 기준으로 코드가 제대로 구현됐는지 3단계 검증
- 전제 조건: PRD, Tech Spec 모두 필요
- 특징: 문제만 지적하는 것이 아니라 수정 방향도 제시
4. CodeGenerator — 코드 생성기
- 역할: Tech Spec에 명시된 파일 경로, 함수명을 그대로 사용하여 코드 구현
- 전제 조건: PRD + Tech Spec 모두 필요
- 특징: 점진적으로 기능 1, 2, 3 순서로 구현