[Claude Code 입문 E26] Claude Code 실전 스킬 만들기: PR 리뷰, 테스트 생성, 문서 생성 SKILL.md 예제

25차시에서 익힌 SKILL.md 패턴을 실제 세 가지 스킬에 적용해 봅니다. 빈 디렉토리에서 시작해 PR 리뷰, 테스트 생성, 문서 생성 스킬을 한 단계씩 만들고, 빌트인과의 차이, description 최적화, Gotchas, Validation loop가 어떻게 들어가는지 살펴봅니다. 📌 다루는 내용 - 빌트인부터 점검: /review, /security-review, /simplify, /init, /batch — 같은 작업이면 빌트인을, 우리 프로젝트 컨벤션이 들어가야 할 때만 커스텀 - PR 리뷰 스킬(review-pr): context: fork + agent: Explore + 동적 컨텍스트(!gh pr diff)로 큰 PR을 격리 서브에이전트에서 검토, 결과 표만 main에 - 테스트 생성 스킬(generate-tests): $ARGUMENTS + argument-hint, Given-When-Then 컨벤션, Validation loop(통과까지 5회 반복), Vitest + __tests__ 위치 컨벤션 - 문서 생성 스킬(generate-docs): Plan-validate-execute로 일괄 덮어쓰기 전 사용자 확인, assets/api-template.md로 템플릿 분리해 토큰 절약, Glob/Grep으로 exported 심볼 탐색 - 25차시 패턴 적용: description 트리거 phrase, Gotchas는 이 프로젝트만의 비자명한 사실(soft delete, 같은 ID의 다른 이름, /health vs /ready), 출력 형식 템플릿, Procedures-not-declarations, Defaults-not-menus - 세 스킬을 한 워크플로로: 작업 → /generate-tests → /generate-docs → /commit → /pr → /review-pr (한 coherent unit 원칙) - 디버깅 팁: 자동 호출이 안 될 때, 너무 자주 호출될 때, Auto-compaction으로 5,000 토큰만 남았을 때, ! 명령이 실행 안 될 때 📌 환경 정보 - Claude Code 최신 버전 (Skills, slash commands, allowed-tools 지원) - .claude/skills/ 프로젝트 스코프 (팀 공유) - gh CLI (PR 리뷰 스킬용), Vitest (테스트 생성 스킬용) 📌 챕터 0:00 지난 시간 배운 패턴을 실제 세 스킬에 적용 0:34 빌트인부터 보고 커스텀 시작 1:43 PR 리뷰: context fork + agent Explore + 동적 컨텍스트 주입 3:57 PR 리뷰: Gotchas 섹션과 출력 표 템플릿 5:47 테스트 생성: $ARGUMENTS와 Validation loop 7:51 테스트 생성: Given-When-Then과 Vitest 컨벤션 9:47 문서 생성: Plan-validate-execute와 assets/ 템플릿 분리 13:40 세 스킬을 한 워크플로로 14:32 디버깅 팁 📌 참고 링크 - 블로그: https://neosarchizo.github.io/posts/claude-code-26-practical-skills - Extend Claude with skills: https://code.claude.com/docs/en/skills - Commands reference: https://code.claude.com/docs/en/commands - Subagents: https://code.claude.com/docs/en/sub-agents - Agent Skills Specification: https://agentskills.io/specification - Anthropic skills repository: https://github.com/anthropics/skills - webapp-testing skill: https://github.com/anthropics/skills/tree/main/skills/webapp-testing - doc-coauthoring skill: https://github.com/anthropics/skills/tree/main/skills/doc-coauthoring - skill-creator skill: https://github.com/anthropics/skills/tree/main/skills/skill-creator #ClaudeCode #실전스킬 #SKILLmd