mattpocock/skills 완벽 가이드: 바이브코딩을 진짜 엔지니어링으로 바꾸는 27개 스킬
Matt Pocock의 27개 AI 에이전트 스킬 모음 사용법. Claude Code·Codex·Cursor 설치부터 /grill-with-docs 7단계 레시피, Caveman·Ponytail 3중 조합까지 정리했습니다.
목차
- 1. 만든 사람과 핵심 철학
- 2. 왜 필요할까? — 4가지 실패 모드
- 3. 설치하기 (30초 셋업)
- 4. 핵심 개념 2가지
- 5. 바이브코딩 실전 7단계 레시피
- 6. 자주 쓰는 워크플로 3가지
- 7. 스킬 27개 한눈에 보기
- 8. 실전 팁 8가지
- 9. Caveman·Ponytail과 함께 쓰기
- 10. 자주 묻는 질문 (FAQ)
1. 만든 사람과 핵심 철학
Matt Pocock은 Total TypeScript를 운영하는 유명 개발자이자 교육자입니다. 그는 mattpocock/skills를 "AI 에이전트로 진짜 엔지니어링을 하기 위해 매일 쓰는 스킬들"이라고 소개합니다.
GSD, BMAD, Spec-Kit 같은 무거운 방법론은 전체 절차를 통째로 통제하기 때문에 중간에 문제가 생겼을 때 부분만 고치기 어렵습니다. 반면 이 스킬 모음은 네 가지 원칙으로 설계되었습니다.
- 작다 — 하나하나가 부담 없는 작은 규칙 묶음입니다.
- 조립 가능(composable) — 지금 내 작업에 필요한 것만 골라 조합합니다.
- 고치기 쉽다 — 일반 텍스트 파일이라 마음에 안 드는 규칙은 내가 직접 수정하면 됩니다.
- 모델 불문 — Claude Code, Codex, Gemini 등 어떤 모델과 에이전트에서도 작동합니다.
2. 왜 필요할까? — 4가지 실패 모드
이 저장소는 AI 코딩 에이전트가 현장에서 가장 자주 일으키는 4가지 고장을 하나씩 막기 위해 설계되었습니다. 내가 최근 겪은 답답함을 아래 표에서 찾아보세요.
| 고장 | 자주 겪는 증상 | 해법 스킬 |
|---|---|---|
| ① 원하는 걸 안 만들어 줌 | "내 생각엔 다 말한 것 같은데" 막상 결과물을 보니 딴판이다. 나와 에이전트 사이의 소통 빈공간 | /grill-me · /grill-with-docs — 고문(그릴링) 세션: 구현 전에 에이전트가 질문 폭격을 던져 설계 갈림길을 먼저 맞춥니다. |
| ② 대화가 너무 장황하다 | 한 마디면 끝날 설명을 20마디로 늘어놓는다. 프로젝트 용어를 매번 새로 해석한다. | 공유 언어(Ubiquitous Language) — /grill-with-docs에 내장된 용어집(GLOSSARY.md)과 결정 기록(ADR)이 이후 대화를 짧게 만들고 토큰도 아낍니다. |
| ③ 코드가 동작하지 않음 | 방향은 맞는 것 같은데 결과물이 계속 깨진다. 에이전트가 눈을 가린 채 비행 중이다. | 피드백 루프 — tdd(실패 테스트 → 통과 → 정리 반복), diagnosing-bugs(규율 있는 디버깅 루프). |
| ④ 진흙 공(Ball of Mud) | 에이전트가 코드를 빨리 쓰는 만큼 코드베이스 복잡도도 폭발하고 금방 망가진다. | 설계에 매일 투자 — /to-spec(명세 전 모듈 설계 점검), /improve-codebase-architecture(며칠마다 스캔해 개선 후보 제시). |
3. 설치하기 (30초 셋업)
3.1 에이전트별 스킬 설치
claude plugin install mattpocock-skills@claude-plugins-official3.2 저장소마다 최초 1회 실행: /setup-matt-pocock-skills
설치 후 에이전트 대화창에서 /setup-matt-pocock-skills를 실행하면 딱 세 가지를 물어봅니다.
- 어떤 이슈 트래커를 쓸지 (GitHub, GitLab, 로컬 파일, 또는 내가 설명하는 방식)
- 이슈 분류 라벨 (
/triage스킬이 이슈를 분류할 때 사용) - 문서 저장 위치 (명세·용어집·ADR이 쌓일 폴더 경로)
저장소당 한 번만 답하면 모든 엔지니어링 스킬이 돌아갈 준비가 끝납니다.
4. 핵심 개념 2가지
4.1 누가 부르는 스킬인가? (지휘자 vs 규율)
목록을 볼 때 가장 헷갈리지 않는 기준은 **"누가 호출하는가"**입니다.
- 내가 부르는 스킬 (
user-invoked, 16개): 내가/명령을 직접 입력할 때만 작동하는 지휘자입니다. 예:/grill-with-docs,/implement,/retro. - 에이전트가 자동으로 쓰는 스킬 (
model-invoked, 11개): 내가 부를 수도 있지만, 작업 맥락이 맞으면 에이전트가 스스로 꺼내 쓰는 재사용 가능한 규율입니다. 예:tdd,code-review,grilling. - 호출 규칙: 내가 부르는 스킬은 자동 스킬을 호출할 수 있지만, 내가 부르는 스킬이 또 다른 내가 부르는 스킬을 호출하지는 않습니다.
4.2 공유 언어 (GLOSSARY.md)
프로젝트 핵심 용어를 한 문서에 정리해 두면 변수·함수·파일 이름이 일관되게 지어지고, 에이전트가 코드베이스를 헤매는 시간과 생각하는 토큰이 크게 줄어듭니다.
실제 예시: *"코스 안의 섹션 안의 레슨이 파일 시스템에서 자리를 받을 때 문제가 있다"*처럼 길게 설명하던 문장이, 용어집에 등록하면 **"materialization cascade에 문제가 있다"**라는 한 단어로 줄어들어 매 세션 토큰을 아껴 줍니다.
5. 바이브코딩 실전 7단계 레시피
새로운 아이디어나 기능을 구현할 때 아래 순서대로만 입력해 보세요.
- 1방향 맞추기 — 질문 폭격으로 설계 확정
/grill-with-docs에이전트가 설계 갈림길을 하나씩 질문합니다. 답변할수록 용어집(GLOSSARY.md)과 결정 기록(ADR)이 자동으로 쌓입니다.
- 2명세로 뭉치기 — 대화 내용을 공식 스펙으로 정리
/to-spec추가 질문 없이 방금 나눈 대화만 종합해 명세 문서를 만들고, 셋업에서 정한 이슈 트래커에 올립니다.
- 3티켓 분해 — 의존 관계 있는 실행 단위로 쪼개기
/to-tickets명세를 tracer-bullet 티켓들(예: 자료구조 정의 → 오늘 보기 화면 → 완료·미루기)로 나누고 선후 의존 관계까지 기록합니다.
- 4구현 — 테스트가 먼저, 커밋 전 자동 리뷰
/implement티켓 순서대로 구현하되 미리 정한 지점마다 tdd(실패 테스트 → 통과 → 정리)를 돌리고, 커밋 전 자동으로 code-review를 호출합니다.
- 5병렬 리뷰 — 표준 준수와 명세 충실도 동시 검증
/code-review서로 다른 두 서브에이전트가 각각 '코딩 규칙·Fowler 냄새'와 '원래 명세 누락 여부'를 병렬로 검토해 시야 오염을 막습니다.
- 6PR 작성 — 최소 시각 요약과 병합 위험 정리
/pr변경을 가장 잘 보여주는 최소한의 시각 자료 요약, 전후 동작 증거, 되돌릴 수 있는 변경인지와 영향 범위를 담은 PR 본문을 생성합니다.
- 7세션 회고 — 다음 작업 환경 개선 제안
/retro세션을 마무리하며 자동 검사 명령, 코딩 규칙, 도구 설정 중 다음 번에 더 잘되게 고칠 부분을 심각도 순으로 제안합니다.
1단계 대화 흐름 예시
/grill-with-docs 매일 반복되는 할 일을 관리하는 앱을 만들고 싶어. 아침에 오늘 할 일만 보이면 좋겠어.- 에이전트 질문 예시: "'완료'는 체크로 끝인가요? 날짜가 지나면 목록에서 어떻게 되나요? 반복 일정이 휴일과 겹치면 쉬나요?"
- 내 답변 예시: "완료는 체크로 끝. 날짜가 지나면 '내일로 미루기' 버튼이 붙어. 휴일이면 그날 반복 일정은 건너뛰어."
이후 /to-spec → /to-tickets → /implement → /code-review → /pr → /retro를 한 줄씩 이어 나가면 됩니다. 당장 하나만 기억한다면 "무엇을 만들든 항상 /grill-with-docs부터 시작한다"는 점입니다.
6. 자주 쓰는 워크플로 3가지
상황에 따라 어떤 스킬 조합을 쓰면 좋을지 선택해 보세요.
시나리오 A: 첫 기능 만들기예쁜 할일 앱 하나 만들어줘
“/setup-matt-pocock-skills → /grill-with-docs”
- 1단계 (초기화)
- /setup-matt-pocock-skills (로컬 파일 트래커 선택 가능)
- 2단계 (설계)
- /grill-with-docs로 완료 기준·반복 규칙 등 모호함 제거
- 3단계 (구현)
- /to-spec → /to-tickets → /implement (티켓마다 TDD 선행)
- 4단계 (마무리)
- /code-review + /pr로 검증 후 PR 생성
시나리오 B: 끈질긴 버그 잡기분명 고쳤는데 또 안 돼요
“diagnosing-bugs → tdd”
- 작동 방식
- 작업이 맞으면 에이전트가 diagnosing-bugs 스킬을 자동 호출
- 진단 순서
- 재현 루프(빨간 불) → 최소화 → 가설 → 계측 → 수정 → 회귀 테스트
- 효과
- 원인도 모른 채 이것저것 건드리는 무한 시행착오 방지
- 수정 검증
- 원인 파악 후 tdd로 실패 테스트를 먼저 만들고 수정 코드 작성
시나리오 C: 대형 작업 & 구조 관리큰 기능이라 세션이 감당이 안 돼요
“/wayfinder · /implement-spec · /improve-codebase-architecture”
- 지도 그리기
- /wayfinder로 거대 작업을 결정 티켓 지도로 쪼개 하나씩 해소
- 병렬 구현
- /implement-spec으로 통합 브랜치에서 작업 그래프 기반 병렬 서브에이전트 실행
- 정기 점검
- 며칠마다 /improve-codebase-architecture로 HTML 개선 후보 보고서 수신
- 주의점
- HTML 보고서는 진흙을 찾아줄 뿐, 실제 해소는 항목을 골라 고문 세션으로 진입해 진행
7. 스킬 27개 한눈에 보기
총 27개 스킬은 내가 부르는 스킬 16개(엔지니어링 11 + 생산성 5)와 자동 스킬 11개(엔지니어링 9 + 생산성 2)로 구성됩니다. 아래 탐색기에서 분야별로 필터링하거나 검색해 보세요.
- 모든 변경의 시작점: 설계 인터뷰 + 용어집·ADR 구축내가 부름· 내가 부름 · 엔지니어링
아이디어의 모든 설계 갈림길을 질문으로 짚어내고, GLOSSARY.md와 결정 기록(ADR)을 함께 구축합니다.
스킬:/grill-with-docs분류:엔지니어링 - 인터뷰 대화를 공식 명세 문서로 통합내가 부름· 내가 부름 · 엔지니어링
방금 나눈 대화만 종합해 추가 질문 없이 명세를 작성하고 설정된 이슈 트래커에 게시합니다.
스킬:/to-spec분류:엔지니어링 - 명세를 의존 관계 있는 실행 티켓으로 분해내가 부름· 내가 부름 · 엔지니어링
계획과 명세를 선후 의존성이 표시된 tracer-bullet 티켓 단위로 쪼갭니다.
스킬:/to-tickets분류:엔지니어링 - 티켓 순서대로 테스트 우선 구현내가 부름· 내가 부름 · 엔지니어링
티켓을 구현하면서 지점마다 tdd를 돌리고, 마무리 단계에서 자동으로 code-review를 호출합니다.
스킬:/implement분류:엔지니어링 - 명세 하나를 통합 브랜치에서 병렬로 통째 구현내가 부름· 내가 부름 · 엔지니어링
티켓 작업 그래프를 분석해 가능한 구간에 구현 서브에이전트를 병렬 배치합니다.
스킬:/implement-spec분류:엔지니어링 - 한 세션 용량을 넘는 거대 기능 길잡이내가 부름· 내가 부름 · 엔지니어링
대형 작업을 결정 티켓들의 지도로 만들어 트래커에 올리고 하나씩 해소합니다.
스킬:/wayfinder분류:엔지니어링 - 코드베이스 구조 부채 스캔 및 HTML 보고서내가 부름· 내가 부름 · 엔지니어링
며칠마다 코드베이스를 훑어 '깊은 모듈(작은 인터페이스·풍부한 기능)' 개선 후보를 HTML 보고서로 제시합니다.
스킬:/improve-codebase-architecture분류:엔지니어링 - 이슈 분류 및 라벨 상태 머신 처리내가 부름· 내가 부름 · 엔지니어링
셋업 때 지정한 라벨 규칙에 따라 이슈를 분류하고 상태를 정리합니다.
스킬:/triage분류:엔지니어링 - 지금 어떤 스킬을 써야 할지 막막할 때내가 부름· 내가 부름 · 엔지니어링
현재 작업 상황을 파악해 가장 적절한 스킬과 워크플로 순서를 추천합니다.
스킬:/ask-matt분류:엔지니어링 - 저장소당 최초 1회 트래커·라벨·문서 경로 설정내가 부름· 내가 부름 · 엔지니어링
다른 엔지니어링 스킬들이 참조하는 프로젝트 기준(트래커, 라벨, 문서 폴더)을 기록합니다. 수동 설치 시 필수 포함.
스킬:/setup-matt-pocock-skills분류:엔지니어링 - 세션 종료 후 에이전트 작업 환경 회고내가 부름· 내가 부름 · 엔지니어링
자동 검사, 코딩 규칙, 도구 설정에서 다음 세션 품질을 높일 개선안을 심각도 순으로 제안합니다.
스킬:/retro분류:엔지니어링 - 코드 외 기획·설계 아이디어 무자비한 인터뷰내가 부름· 내가 부름 · 생산성
코드 작업이 아니더라도 기획이나 설계의 빈틈을 끝까지 질문으로 파고듭니다.
스킬:/grill-me분류:생산성 - 긴 대화를 다음 에이전트용 인수인계 문서로 압축내가 부름· 내가 부름 · 생산성
세션이 길어졌을 때 핵심 맥락만 요약해 새 세션이나 다른 에이전트가 이어받을 수 있게 합니다.
스킬:/handoff분류:생산성 - 새로운 개념을 여러 세션에 걸쳐 단계적으로 학습내가 부름· 내가 부름 · 생산성
디렉토리를 교육 작업 공간으로 삼아 새로운 기술 개념을 체계적으로 익힙니다.
스킬:/teach분류:생산성 - 혼자 못 정한 결정을 답변 가능한 설문지로 변환내가 부름· 내가 부름 · 생산성
결정하기 애매한 선택지들을 팀원이나 이해관계자가 바로 답할 수 있는 설문 형태로 만듭니다.
스킬:/to-questionnaire분류:생산성 - 에이전트 설명이 이해되지 않을 때 즉시 재설명내가 부름· 내가 부름 · 생산성
빠진 맥락을 보충하고 GLOSSARY.md 용어를 기준으로 처음부터 이해하기 쉽게 다시 설명합니다.
스킬:/wait-what분류:생산성 - 수직 슬라이스 단위 빨강-초록-리팩터 테스트 루프자동· 자동 · 엔지니어링
실패하는 테스트를 먼저 쓰고 통과할 만큼만 구현한 뒤 정리하는 사이클을 강제합니다.
스킬:tdd분류:엔지니어링 - 표준 준수와 명세 충실도 2축 병렬 리뷰자동· 자동 · 엔지니어링
코딩 규칙·Fowler 냄새 검사와 원 명세 검증을 독립된 두 서브에이전트가 병렬 수행합니다.
스킬:code-review분류:엔지니어링 - 시각 요약·전후 증거·병합 위험 포함 PR 본문 작성자동· 자동 · 엔지니어링
리뷰어가 한눈에 파악할 수 있는 최소 시각 자료와 전후 동작 증거, 롤백 위험도를 정리합니다.
스킬:pr분류:엔지니어링 - 어려운 버그·성능 회귀를 잡는 규율 있는 진단 루프자동· 자동 · 엔지니어링
피드백 루프 구축 → 최소화 → 가설 → 계측 → 수정 → 회귀 테스트 순서로 뇌절을 막습니다.
스킬:diagnosing-bugs분류:엔지니어링 - 용어집 대조와 경계 사례 테스트로 도메인 모델 다듬기자동· 자동 · 엔지니어링
GLOSSARY.md와 대조하고 엣지 케이스를 스트레스 테스트해 깔끔한 도메인 모델을 만듭니다.
스킬:domain-modeling분류:엔지니어링 - 깊은 모듈 설계를 위한 공유 규율과 어휘자동· 자동 · 엔지니어링
작은 인터페이스 뒤에 풍부한 기능을 감추는 깊은 모듈 설계 원칙을 제공합니다.
스킬:codebase-design분류:엔지니어링 - 설계 의문에 답하기 위한 일회용 프로토타입 제작자동· 자동 · 엔지니어링
단일 HTML이나 UI 변형 프로토타입을 빠르게 만들어 확정 전 방향을 검증합니다.
스킬:prototype분류:엔지니어링 - 1차 자료 조사 및 출처 표기 Markdown 저장자동· 자동 · 엔지니어링
백그라운드에서 공식 문서 등 1차 소스를 조사해 출처가 담긴 Markdown 보고서로 저장합니다.
스킬:research분류:엔지니어링 - 사람만 할 수 있는 인프라·시크릿·마이그레이션 안내자동· 자동 · 엔지니어링
에이전트가 대신할 수 없는 수동 작업을 단계별 대화형 bash 마법사로 안내합니다.
스킬:wizard분류:엔지니어링 - 모든 질문 기반 스킬이 공유하는 인터뷰 엔진자동· 자동 · 생산성
grill·triage·wayfinder 등 5개 계열 스킬의 심장 역할을 하는 고문 인터뷰 원본입니다.
스킬:grilling분류:생산성 - 에이전트가 읽을 CLAUDE.md·SKILL.md 문서 작성법자동· 자동 · 생산성
장황한 산문 대신 동사가 명확하고 짧은 명령문으로 에이전트 지침서를 작성하게 합니다.
스킬:writing-for-agents분류:생산성
8. 실전 팁 8가지
1. 고문을 건너뛰는 게 최대의 실수고문 · 용어아무도 자기가 뭘 원하는지 정확히 모릅니다. '이미지 리사이즈 넣어줘'라고 바로 시키지 말고 항상 /grill-with-docs로 최대 크기·비율·다중 업로드 여부를 먼저 합의하세요.
2. 용어집(GLOSSARY.md)에 투자하세요고문 · 용어어려운 결정마다 ADR을 남기고 용어를 고정하면 세션이 길어져도 대화가 짧아지고 함수·파일 이름까지 일관되게 유지됩니다.
3. 피드백 루프가 곧 속도입니다피드백 · 구조정적 타입, 브라우저 접근, 자동 테스트 3대 안전망 중 자동 테스트를 tdd의 빨강→초록→리팩터 리듬이 책임져 줍니다.
4. 며칠마다 /improve-codebase-architecture피드백 · 구조에이전트가 빠르게 짠 코드의 설계 부채를 HTML 보고서로 스캔해 조기에 갚습니다. 단, 보고서는 후보를 찾아줄 뿐이므로 선택한 항목으로 고문 세션에 들어가 해결하세요.
5. 세션 끝나면 /retro문서 · 커스텀테스트 명령 누락이나 도구 불편사항을 매 세션 끝에 환경 개선안으로 뽑아 반영하면 매일 쓸수록 누적 효과가 커집니다.
6. 긴 대화는 /handoff, 말이 안 들리면 /wait-what문서 · 커스텀컨텍스트가 길어지면 /handoff로 압축해 새 세션에 넘기고, 에이전트 설명이 이해되지 않을 땐 즉시 /wait-what으로 GLOSSARY 어휘 기반 재설명을 받으세요.
7. 내 문서도 에이전트용(writing-for-agents)으로문서 · 커스텀CLAUDE.md·AGENTS.md를 산문 대신 '테스트: npx vitest run. 커밋 전 필수 실행.'처럼 동사가 명확한 짧은 문장으로 바꾸면 1줄이 스킬 1개보다 효과적입니다.
8. 스킬은 내 것 — 과감히 고쳐 쓰기문서 · 커스텀모든 스킬은 일반 텍스트(SKILL.md)입니다. 에이전트에게 '이 스킬 파일 보여줘'라고 한 뒤 우리 팀 스타일에 맞게 질문을 줄이거나 규칙을 수정하세요.
9. Caveman·Ponytail과 함께 쓰기
앞서 소개한 Caveman·Ponytail 토큰 절약 가이드와 mattpocock/skills는 다루는 층위가 서로 겹치지 않아 3중 스택으로 완벽하게 결합됩니다.
| 계층 | 도구 | 담당 영역 |
|---|---|---|
| 절차 (무엇을 언제 할지) | mattpocock/skills | 고문 → 명세 → 티켓 → 구현 → 리뷰의 순서를 강제 |
| 대화 (한 단계의 토큰) | Caveman | 에이전트 답변 단축 + 로그·테스트 출력 압축 (npx @caveman-ai/cli@latest) |
| 코드 (산출물의 크기) | Ponytail | 7단계 사다리로 필요한 코드만 쓰게 강제 (AGENTS.md 복사 방식 권장) |
워크플로에 얹는 4단계 순서
- 상시 깔기: Caveman 전체 설치 —
/grill-with-docs의 질문·답변이 짧아지고/implement가 읽는 로그·테스트 출력이 압축됩니다(세션 입력 최대 33% 절감 실측). - 구현 단계에 Ponytail 얹기 —
writing-for-agents로 관리하는AGENTS.md에 Ponytail 규칙을 복사해 넣으면 충돌 없이 동작합니다. - 리뷰 시점 나눠 중복 피하기 —
/code-review는 구현 중·커밋 전에(표준 준수·명세 충실도),/ponytail-review는 PR 올리기 직전에(버그·보안·제거할 코드) 한 번만 돌려 토큰 이중 소모를 막습니다. - 효과를 눈으로 확인하기 — Claude Code에서
/ponytail band와 터미널caveman stats를 함께 보면 절차 덕분에 잘 짜였는지, 절약 스킬 덕분에 싸졌는지를 분리해서 확인할 수 있습니다.
자주 쓰는 핵심 명령 빠른 복사
mattpocock/skills 핵심 워크플로
상황별 보조 · 3중 조합 명령
10. 자주 묻는 질문 (FAQ)
Q1. GSD, BMAD, Spec-Kit 같은 다른 방법론과 무엇이 다른가요?
Q2. 이렇게 절차를 밟으면 '바이브코딩'이 아니라 너무 느려지지 않나요?
Q3. 어떤 에이전트에서 가장 잘 동작하나요?
Q4. 업데이트는 어떻게 하나요?
Q5. 스킬이 정확히 몇 개인가요?
Q6. 실수로 플러그인과 skills.sh를 둘 다 설치해 스킬이 두 번씩 뜹니다.
Q7. 스킬을 내 입맛대로 고쳐 써도 되나요?
Hafuture JSON 포맷터로 에이전트 플러그인 설정 검증하기
GitHub Copilot의 ~/.copilot/settings.json(extraKnownMarketplaces)이나 MCP·에이전트 JSON 설정을 브라우저에서 서버 전송 없이 안전하게 포맷·검증해 보세요.