맷 포콕(Matt Pocock)의 skills 저장소는 AI 에이전트(예: Claude Code 등)가 실제 소프트웨어 엔지니어링 작업을 더 효율적으로 수행할 수 있도록 돕는 '스킬(명령어 및 가이드라인)'들의 모음집입니다.
각 디렉토리별 주요 구성 내용은 다음과 같습니다.
1. 핵심 디렉토리: skills/
이 저장소의 가장 중요한 부분으로, 용도에 따라 여러 하위 카테고리로 나뉩니다.
engineering/(엔지니어링 기술): 실제 코딩 작업에 사용되는 핵심 도구들입니다.diagnose: 버그 진단 루프 (재현 -> 가설 -> 수정 -> 테스트).tdd: 테스트 주도 개발(Red-Green-Refactor)을 위한 가이드.grill-with-docs: 계획을 문서(CONTEXT.md, ADR)와 대조하며 검토하는 세션.to-prd/to-issues: 대화 내용을 PRD(제품 요구 사양서)로 만들거나 GitHub 이슈로 분할.improve-codebase-architecture: 코드베이스의 구조적 개선 제안.setup-matt-pocock-skills: 이 스킬들을 사용하기 위한 초기 설정 도구.
productivity/(생산성 도구): 코딩 외의 일반적인 업무 효율을 높여줍니다.grill-me: 계획이나 디자인에 대해 AI가 사용자에게 집요하게 질문하여 빈틈을 찾는 기능.caveman: 불필요한 수식어를 빼고 핵심만 전달하여 토큰 사용량을 줄이는 통신 모드.handoff: 현재 작업을 다른 에이전트가 이어받을 수 있게 요약 문서 생성.write-a-skill: 새로운 스킬을 만드는 가이드.
personal/(개인용): 개인적인 워크플로우를 위한 도구입니다.obsidian-vault: 옵시디언(Obsidian) 메모 관리 관련.edit-article: 기사나 글 편집 지원.
misc/(기타): 특정 목적을 위한 도구들입니다.git-guardrails-claude-code: 위험한 git 명령어(push, reset 등) 실행을 방지하는 가드레일.setup-pre-commit: Husky나 Prettier 같은 프리커밋 훅 설정.
in-progress/&deprecated/: 현재 개발 중이거나 더 이상 사용되지 않는 예전 스킬들이 포함되어 있습니다.
2. 기타 주요 디렉토리 및 파일
docs/: 프로젝트의 의사결정 기록(ADR - Architecture Decision Records)이 담겨 있습니다. 왜 특정 구조를 선택했는지에 대한 기술적 배경을 알 수 있습니다.scripts/: 스킬들을 시스템에 연결하거나 목록을 확인하는 데 사용되는 쉘 스크립트(link-skills.sh,list-skills.sh)가 들어 있습니다.README.md: 전체 프로젝트의 철학(왜 이 스킬들이 필요한지)과 빠른 시작 가이드가 포함되어 있습니다.CLAUDE.md/CONTEXT.md: AI 에이전트가 이 프로젝트 자체를 이해하고 작업할 때 참고하는 가이드라인 파일입니다.
요약 표
| 디렉토리 | 주요 내용 |
|---|---|
skills/engineering | TDD, 버그 진단, 아키텍처 개선 등 실제 개발 업무 지원 |
skills/productivity | 질문 세션(Grilling), 요약 전달(Handoff), 토큰 절약 모드 등 |
skills/personal | 개인 메모(Obsidian) 및 글쓰기 지원 |
skills/misc | Git 보안 설정, 테스트 마이그레이션 등 기타 유틸리티 |
docs/adr | 프로젝트의 주요 기술적 의사결정 기록 |
scripts | 스킬 설치 및 관리를 위한 실행 스크립트 |
이 저장소의 스킬들은 단순히 코드를 짜는 것을 넘어, "엔지니어링 원칙(Fundamentals)"을 AI 작업 과정에 녹여내어 더 견고한 소프트웨어를 만드는 데 초점이 맞춰져 있습니다.
