Matt Pocock의 Skills, 실전 엔지니어를 위한 작고 조립 가능한 에이전트 스킬
목차
개요
TypeScript 교육자로 잘 알려진 Matt Pocock이 자신의 Claude Code 에이전트 스킬 모음을 GitHub에 공개했다. 저장소 이름은 단순하게 skills이고, 슬래시 커맨드로 호출되는 재사용 가능한 행동 가이드라인의 집합이다.
이 저장소의 핵심 메시지는 분명하다. “모든 것을 자동화하는 거대한 프레임워크”를 거부하고, “작고, 교체 가능하며, 조립 가능한 도구”로 에이전트와 협업하자는 것이다. 다시 말해 Pocock은 에이전트 도구가 개발자의 통제권을 빼앗아서는 안 된다고 주장하며, 그 철학을 17개 스킬로 구체화했다.
네 가지 실패 모드
저장소는 AI 어시스턴트가 실제 엔지니어링 워크플로우에서 자주 망가지는 네 가지 패턴을 정의하고, 각 패턴마다 대응 스킬을 제시한다.
정렬 실패
가장 먼저 다루는 실패 모드는 개발자와 에이전트 사이의 의도 정렬 문제다. 에이전트가 “이해했다”고 말한 뒤 전혀 다른 방향으로 코드를 작성하는 상황을 막기 위해, /grill-me와 /grill-with-docs 같은 스킬이 구현 전에 강제로 상세 질문을 던진다.
/grill-me는 의사결정 트리를 따라가며 사용자에게 끝까지 캐물어, 충분히 정렬되기 전까지는 코드 작성으로 넘어가지 않는다. /grill-with-docs는 여기에 더해 도메인 용어집을 함께 구축하면서 인간과 에이전트 사이의 공유 어휘를 만든다.
장황한 응답
두 번째 실패는 에이전트의 응답이 지나치게 길어 토큰을 낭비하고, 동시에 코드의 일관성을 떨어뜨리는 문제다. 이 저장소는 CONTEXT.md라는 프로젝트별 도메인 사전 파일을 두고, 거기에 정의된 어휘를 모든 에이전트가 공유하게 한다. 저장소 설명에 따르면 이 방식으로 토큰 사용량을 약 75% 줄일 수 있다고 한다.
또한 caveman 스킬은 그 자체로 “초압축 커뮤니케이션”을 강제한다. 필요한 정보만 골자로 전달하게 만들어, 응답 자체의 길이도 통제한다.
버그가 있는 코드
세 번째 실패는 에이전트가 작동하지 않는 코드를 그럴듯하게 작성하는 문제다. 이를 막기 위해 /tdd와 /diagnose가 도입된다.
| 스킬 | 역할 |
|---|---|
| /tdd | red-green-refactor 루프를 강제 |
| /diagnose | 재현 → 최소화 → 가설 → 계측 → 수정 절차 |
/diagnose는 단순히 “버그를 고쳐라”가 아니라, 디버깅의 단계를 명시적으로 정의해 에이전트가 추측 기반으로 수정하는 것을 막는다. 재현 가능한 케이스를 만들고, 최소 사례로 줄이고, 가설을 세우고, 계측한 뒤 수정하는 흐름을 따라가게 한다.
아키텍처 부패
마지막 실패는 단기적으로는 빠르게 코드를 만들지만, 장기적으로 코드베이스가 무너지는 문제다. /improve-codebase-architecture는 도메인 지식을 바탕으로 설계 개선점을 식별하고, /zoom-out은 시스템 수준의 맥락을 제공해 에이전트가 좁은 시야로 코드를 작성하지 않게 한다. /to-prd는 대화 흐름을 정식 요구사항 문서로 합성하여, 즉흥적으로 시작된 작업이 사라지지 않고 설계 산출물로 남도록 한다.
스킬 카테고리와 구성
저장소는 스킬을 명확한 카테고리로 나눈다. 각 스킬은 자체 문서 파일을 가진 독립적인 관리 단위로, 다른 스킬에 의존하지 않고 단독으로 호출 가능하다.
| 카테고리 | 주요 스킬 |
|---|---|
| Engineering | diagnose, grill-with-docs, tdd, triage, improve-codebase-architecture, to-issues, to-prd, zoom-out, prototype, setup-matt-pocock-skills |
| Productivity | caveman, grill-me, write-a-skill |
| Misc | git-guardrails-claude-code, migrate-to-shoehorn, scaffold-exercises, setup-pre-commit |
이 외에도 personal, in-progress, deprecated 같은 카테고리를 두어 스킬의 라이프사이클을 관리한다. 완성도가 낮거나 폐기된 스킬도 그대로 보관해, 사용자가 필요에 따라 갈아끼울 수 있게 한다는 사상이 반영되어 있다.
설치와 사용
설치는 30초 정도면 끝난다.
1
npx skills@latest add mattpocock/skills
명령을 실행하면 원하는 스킬과 코딩 에이전트를 선택할 수 있고, 마지막에 /setup-matt-pocock-skills를 한 번 실행하면 이슈 트래킹, 트리아지 라벨, 문서 위치 등의 설정이 자동으로 구성된다.
저장소는 100% 셸 스크립트로 작성되어 있고 MIT 라이선스다. 공개 시점 기준 6.6만 개 이상의 스타와 5,700개 이상의 포크가 모였다.
의미와 시사점
이 저장소의 가치는 개별 스킬의 기능보다도, 그 뒤에 깔린 설계 철학에 있다.
첫 번째는 “작고 교체 가능한 도구”라는 사상이다. 저장소는 거대한 자동화 시스템 대신, 개발자가 자신의 워크플로우에 맞게 스킬 하나하나를 수정하고 갈아끼울 수 있는 형태를 지향한다. 이는 최근 에이전트 생태계가 점점 무거운 프레임워크화되는 흐름에 대한 반작용으로 읽힌다.
두 번째는 “공유 어휘”의 강조다. CONTEXT.md를 통해 도메인 용어를 명시적으로 정의하고, 모든 스킬이 그 위에서 동작하게 한다. 이는 에이전트와 인간이 같은 언어로 이야기하지 못해 발생하는 비효율을, 코드가 아닌 어휘 설계로 해결하려는 시도다.
세 번째는 실패 모드 분류 그 자체다. “정렬 실패, 장황함, 버그, 아키텍처 부패”라는 네 가지 실패 모드는, 다른 스킬 저장소를 설계할 때도 거의 그대로 적용 가능한 일반적 분류 체계다. 스킬 모음을 만들 때 어떤 문제를 풀어야 하는지에 대한 실용적인 체크리스트로 쓸 수 있다.
결론
Matt Pocock의 skills 저장소는 Claude Code 에이전트를 위한 작고 조립 가능한 스킬 모음이다. 정렬, 장황함, 버그, 아키텍처 부패라는 네 가지 실패 모드를 명시적으로 정의하고, 17개 스킬로 각 모드를 직접 공격한다. 거대한 프레임워크보다는 작고 교체 가능한 도구를, 자동화의 절대량보다는 인간-에이전트 공유 어휘를 우선시하는 접근 방식이 가장 큰 시사점이다.