writing-skillslisted

# Writing Skills ## Overview **스킬 작성은 프로세스 문서에 적용한 테스트 주도 개발(TDD)이다.** **스킬을 어디에 두는가**는 누가 쓰느냐로 갈린다. 나 혼자 쓰는 개인 스킬은 에이전트 실행 환경(Claude Code·Codex·Copilot CLI·Gemini CLI 같은 코딩 에이전트 제품)의 스킬 디렉터리에 둔다. Claude Code는 `~/.claude/skills/`이고, 다른 제품의 경로는 각 제품 문서를 따른다. Codex, Copilot CLI, Gemini CLI는 제품을 가리지 않��� 별칭으로 `~/.agents/skills/`도 인식한다. 플러그인으로 배포하는 스킬은 그 플러그인 저장소의 `skills/<이름>/`에 둔다. 테스트 케이스(서브에이전트를 쓴 압박 시나리오)를 먼저 쓰고, 실패를 지켜보고(베이스라인 행동), 스킬(문서)을 쓰고, 테스트가 통과하는지 지켜보고(에이전트가 준수), 리팩터한다(빈틈을 막는다). **핵심 원칙:** 스킬 없이 에이전트가 실패하는 걸 지켜보지 않았다면, 그 스킬이 옳은 것을 가르치는지 알 수 없다. **REQUIRED BACKGROUND:** 이 스킬을 쓰기 전에 groundwork:test-driven-development를 반드시 이해해야 한다. 그 스킬이 근본 RED-GREEN-REFACTOR 사이클을 정의한다. 이 스킬은 TDD를 문서에 적용한다. **공식 가이드:** Anthropic의 공식 스킬 작성 베스트 프랙티스는 anthropic-best-practices.md를 참조한다. 그 문서는 이 스킬의 TDD 중심 접근을 보완하는 추가 패턴·가이드라인을 담는다. ## 스킬이란 무엇인가 **스킬**은 검증된 기법·패턴·도구의 레퍼런스 가이드다. 스킬은 후속 에이전트가 효과적인 접근을 찾아 적용하도록 돕는다. **스킬인 것:** 재사용 가능한 기법·패턴·도구·레퍼런스 가이드 **스킬이 아닌 것:** 문제를 한 번 어떻게 풀었는지에 대한 서사 ## 스킬을 위한 TDD 대응 | TDD 개념 | 스킬 작성 | |-------------|----------------| | **테스트 케이스** | 서브에이전트를 쓴 압박 시나리오 | | **프로덕션 코드** | 스킬 문서(SKILL.md) | | **테스트 실패(RED)** | 스킬 없이 에이전트가 규칙을 위반(베이스라인) | | **테스트 통과(GREEN)** | 스킬이 있으면 에이전트가 준수 | | **리팩터** | 준수를 유지하면서 빈틈을 막음 | | **테스트 먼저 쓰기** | 스킬 쓰기 전에 베이스라인 시나리오 실행 | | **실패를 지켜보기** | 에이전트가 쓴 합리화를 그대로 기록 | | **최소 코드** | 그 위반만 겨냥한 스킬을 씀 | | **통과를 지켜보기** | 이제 에이전트가 준수하는지 검증 | | **리팩터 사이클** | 새 합리화 발견 → 막음 → 재검증 | 스킬 작성 과정 전체가 RED-GREEN-REFACTOR를 따른다. ## 스킬을 만들 때