mattpocock/skills — Skills For Real Engineers
Key Insight
GSD·BMAD처럼 프로세스를 소유하는 방식이 아니라, 작고 조합 가능한 스킬 단위로 제어권을 사용자에게 돌려준다. 4가지 AI 코딩 실패 모드를 소프트웨어 엔지니어링 고전(Pragmatic Programmer, DDD, XP)의 원칙으로 해결.
출처: GitHub (mattpocock/skills) 저자: Matt-Pocock (Total TypeScript) 설치:
npx skills@latest add mattpocock/skills유효일: 2026-05-20
핵심 Takeaway
- 4가지 AI 코딩 실패 모드 정의: ①요구 불일치 ②에이전트 과도한 언어 ③코드 작동 안 함 ④볼 오브 머드
- GSD, BMAD, Spec-Kit 비판: “프로세스를 소유하면 제어권을 빼앗기고 버그 디버깅이 어렵다” → 작고 조합 가능한 스킬이 대안
- grill-me: 가장 인기 스킬. 시작 전 에이전트가 상세 질문으로 요구사항 정렬
/grill-with-docs: grill-me + Shared Language(CONTEXT.md) + ADR. “프로젝트 전체에서 가장 강력한 기법”/caveman: 토큰 사용 ~75% 절감, filler 제거 후 기술 정확도 유지/tdd: red-green-refactor 강제 (Superpowers TDD와 유사하지만 독립적)/diagnose: 체계적 디버깅 루프 (재현 → 최소화 → 가설 → 계측 → 수정 → 회귀 테스트)/improve-codebase-architecture: 며칠마다 실행 권장, “볼 오브 머드” 방지CONTEXT.md기반 Shared Language: 변수·함수·파일명 일관성, 에이전트 토큰 사용 절감, 코드베이스 탐색 용이성
4가지 AI 코딩 실패 모드 & 해결책
| 실패 모드 | 핵심 문제 | 해결 스킬 | 철학적 근거 |
|---|---|---|---|
| ①요구 불일치 | 에이전트-사용자 커뮤니케이션 갭 | /grill-me, /grill-with-docs | ”No-one knows exactly what they want” — Pragmatic Programmer |
| ②과도한 언어 | 도메인 용어 없이 20단어로 설명 | /grill-with-docs (CONTEXT.md) | Shared Language — Eric Evans, DDD |
| ③코드 작동 안 함 | 피드백 루프 없이 비행 | /tdd, /diagnose | ”Never take on a task too big” — Pragmatic Programmer |
| ④볼 오브 머드 | AI 가속이 소프트웨어 엔트로피도 가속 | /zoom-out, /improve-codebase-architecture, /to-prd | ”Invest in design every day” — Kent Beck, XP |
전체 스킬 목록
Engineering (일상 코드 작업)
/grill-with-docs— 기존 도메인 모델 검토, CONTEXT.md·ADR 갱신/tdd— red-green-refactor, 수직 슬라이스 단위/diagnose— 재현→최소화→가설→계측→수정→회귀테스트/to-prd— 대화 컨텍스트 → GitHub 이슈 PRD/to-issues— PRD → 독립 수직 슬라이스 이슈 분해/triage— 이슈 상태 머신 트리아지/zoom-out— 코드 섹션의 시스템 전체 맥락 설명/improve-codebase-architecture— CONTEXT.md·ADR 기반 심화 기회 탐색/setup-matt-pocock-skills— 이슈 트래커·라벨·문서 경로 초기 설정 (최초 1회)/prototype— 로직 검증용 터미널 앱 또는 라디칼하게 다른 UI 변형 빌드
Productivity (범용 워크플로우)
/grill-me— 의사결정 트리의 모든 분기가 해소될 때까지 인터뷰/caveman— 토큰 ~75% 절감 초압축 통신 모드/handoff— 현재 대화 → 핸드오프 문서 (다른 에이전트 인계)/write-a-skill— 스킬 구조 설계 도우미
GSD와의 철학 비교
| 관점 | mattpocock/skills | GSD |
|---|---|---|
| 제어권 | 사용자 (작고 조합 가능) | 시스템 소유 (자동화된 프로세스) |
| 복잡성 | 스킬 단위 단순함 | 내부 복잡성, 외부 단순함 |
| 설계 관심 | 핵심 가치 (아키텍처 스킬 포함) | 기능 배송 중심 |
| 조합성 | 프리픽스 없이 직접 호출 | 고정 워크플로우 |
연결되는 노트
- Matt-Pocock — 저자
- grill-me — 핵심 스킬 (요구사항 정렬)
- GSD — 비판 대상 도구 (비교 맥락)
- context-rot —
/handoff가 해결하는 문제 - harness-engineering — 상위 방법론 영역
- Claude-Code-6개-추천-스킬-LinkedIn — 6개 추천 스킬 중 하나로 소개