2026년 5월, mattpocock/skills가 GitHub Trending에서 연일 화제이며 Star는 10만을 넘었습니다. 저자 Matt Pocock(Total TypeScript 강사)이 매일 쓰던 Agent Skills를 개인 .claude에서 공개한 것——또 하나의 채팅 템플릿이 아니라 Claude Code·Cursor·Codex 등에 「먼저 맞추고, 쓰고, 검증하고」를 강제하는공정 규율 묶음입니다.
「에이전트가 파일 수십 개를 한 번에 건드리고 테스트는 전부 빨간데 완료라고 한다」—— 그 지침을 안다면, 본문은 문제 → 구조 → 비교 → 도입 워크플로 순으로 이 저장소를 설치할 가치가 있는지 정리합니다. 설치 명령, 권장 Skill 체인, OpenClaw·Cursor 기억과의 경계, Mac 팀 체크리스트까지 가져가세요. 먼저 당사 AI 코딩 지속 기억 글을 읽으면 「세션 기억」과 「공정 Skill」이 무엇을 나누는지 분명해집니다.
1. 바이브 코딩에 부족한 건 모델이 아니라 공정
2026년 「Vibe coding(분위기 코딩)」은 거의 비하어입니다. 모델이 좋아질수록 한 번에 나오는 코드량이 늘고, 어긋났을 때 비용도 같이 치솟습니다. Matt는 README에서 네 가지 전형적 실패를 짚습니다—— 『실용주의 프로그래머』『도메인 주도 설계』에 있던 오래된 문제가 Agent라는 가속기로 되살아난 것뿐입니다.
- 요구 불일치(Misalignment): 분명히 말한 줄 알았는데 다른 해석으로 구현되고, diff를 봐야 터진다.
- 장황함(Verbosity): 프로젝트 속어를 모르고, 짧게 말할 수 있는 걸 장문으로 써 token과 시간을 태운다.
- 피드백 부재(No feedback): 실패 테스트·타입 검사·재현 절차 없이 에이전트가 암흑 비행.
- 엔트로피(Entropy): 생성 속도 2배면 설계 부패도 2배. 몇 주 뒤엔 경계를 건드릴 사람이 없다.
GSD, BMAD, Spec-Kit 같은 「풀 프로세스 방법론」은 Agent를 두꺼운 껍질로 감싸려 합니다. Matt의 지적은 분명합니다——분해·수정 불가능한 흐름은, 망가진 컴파일러를 고치는 것보다 고통스럽다. skills 방향은 반대로, 각 Skill은 SKILL.md 짧은 Markdown, Slash로 실행, 레고처럼 조립합니다.
2. mattpocock/skills란 무엇인가
부제는 Skills for Real Engineers. Straight from my .claude directory. 기술적으로 skills.sh로 배포하는Skill 패키지 모음, MIT 라이선스. Star는 GitHub에서 실시간 확인(집필 시 10만+). 크게 세 갈래입니다.
2.1 Engineering(매일 쓰는 구현)
| Slash 명령 | 역할 | 전형적 타이밍 |
|---|---|---|
/grill-me, /grill-with-docs | 착수 전 요구를 「캐묻기」. 후자는 CONTEXT.md·ADR도 갱신 | 사소하지 않은 기능 전 |
/tdd | 적→녹→리팩터. 실패 테스트부터 | 비즈니스 로직, 버그 수정 |
/diagnose | 재현→최소화→가설→계측→수정→회귀 | 성능·동시성 난제 |
/to-prd | 대화를 PRD로 정리하고 GitHub Issue 생성 | 논의는 익었으나 문서화 전 |
/to-issues | PRD/계획을세로 슬라이스로 독립 배포 가능한 Issue로 | 스프린트 전 |
/improve-codebase-architecture | 도메인 언어로 「더 깊게 갈」 경계 탐색 | 며칠마다 저장소 순찰 |
/setup-matt-pocock-skills | Issue 소스, 트리아지 라벨, 문서 경로 | 설치 직후 필수 |
2.2 Productivity(범용 협업)
/caveman은 극단적으로 짧은 화법으로 token 절약(공식 약 75%). /handoff는 세션을 다음 Agent용 인수 문서로 압축. /write-a-skill은 규약에 맞는 새 Skill 작성. 긴 세션, 다중 Agent·다인 협업, 비용 민감 팀에 맞습니다.
2.3 Misc(필요 시)
/git-guardrails-claude-code는 Hook으로 force push·hard reset 등을 차단. pre-commit 발판·연습 디렉터리 생성 등——메인 라인 밖이지만 Git 사고 이력 있는 저장소엔 가치 있습니다.
2.4 공유 언어: grill-with-docs의 숨은 힘
README 예: 「레슨이 materialize됐다」를 「materialization cascade 문제」로 바꾸면——도메인어가 CONTEXT.md에 들어갈수록 변수명·파일명·이후 대화가 짧고 일관됩니다. 코드 지식 그래프로 거대 저장소 읽기와 보완: 그래프가 구조, CONTEXT.md가팀의 구두 계약을 담습니다.
3. Cursor Rules·OpenClaw·중량 방법론과 비교
선택 관점의 거친 대조표입니다. 하나만 고를 필요는 없습니다.
| 축 | mattpocock/skills | Cursor / IDE Rules | OpenClaw Skill 생태 | GSD / Spec-Kit 등 |
|---|---|---|---|---|
| 형태 | 설치 가능 Slash Skill 패키지 | 저장소 내 정적 규칙 | 게이트웨이 플러그인 + openclaw skills |
다단계 프로세스 템플릿 |
| 강점 | 정렬, TDD, Issue 분해, 아키 순찰 | 코딩 스타일, 디렉터리 규약 | 멀티 채널, Cron, Webhook | Spec부터 납품까지 서사 |
| 통제감 | 높음(Skill 단위 ON/OFF) | 높음 | 중간(운영 부담 큼) | 낮~중(흐름이 주도) |
| Mac과의 관계 | 임의 OS; iOS/macOS CI는 macOS 노드 필요할 수 있음 | 로컬 IDE 중심 | 상주 Mac 게이트웨이가 흔함 | Agent 실행 환경에 따름 |
OpenClaw ClawHub 스킬 설치와 대비: OpenClaw는 「메시지 입구와 게이트웨이 헬스」, mattpocock/skills는 「들어온 뒤엔지니어처럼 코딩」. 커뮤니티는 addyosmani/agent-skills와 Matt 패키지를 나란히 두기도——전자는 /spec→/ship 수명주기, 후자는 테스트·정렬, 같은 저장소 공존 가능합니다.
「지난주 결정을 기억하나」는 Rules·CONTEXT.md 영역. 「이번에 TDD로 갈까」는 공정 Skill 영역. 200K 컨텍스트로 대체——는 성립하지 않을 수 있습니다. 당사 긴 컨텍스트와 주 단위 협업도 참고하세요.
4. 30초 설치와 권장 Skill 체인
공식 Quickstart 세 단계. 실제 저장소 루트에서 실행하는 게 원칙입니다(README 기준).
4.1 설치
npx skills@latest add mattpocock/skills설치기에서 Skill과 대상 Agent(Claude Code, Cursor 등)를 고릅니다. /setup-matt-pocock-skills는 반드시 체크.
4.2 저장소 설정
Agent 안에서 실행:
/setup-matt-pocock-skillsIssue 트래커(GitHub / Linear / 로컬), /triage 라벨 어휘, CONTEXT.md·ADR 위치를 지정. 미설정이면 /to-issues·/triage가 팀 관습과 어긋난 티켓을 양산하기 쉽습니다.
4.3 기능 개발 복붙 가능 체인
/grill-with-docs(또는/grill-me)——결정 트리에 「미정」 가지가 없을 때까지./to-prd——합의됐으면 PRD화 후 Issue./to-issues——세로 슬라이스 Issue. 「프론트 일주·백 일주」 수평 분할 회피.- Issue마다
/tdd. 막히면/diagnose. - 릴리스 전 또는 금요일
/improve-codebase-architecture.
4.4 Apple / Mac 팀에서의 연결
Skills 자체는 크로스 플랫폼. 같은 저장소에서 xcodebuild, 서명, OpenClaw 게이트웨이도 돌린다면, 노트북 + Cursor에 Skills를 깔고 앱 코드를 쓰고 CI·게이트웨이는 자체 Mac Runner나 원격 전용 Mac에 두는 구성이 흔합니다. 로컬 LLM 선택은 MLX vs Ollama 비교를——Skills는 모델 고르기가 아니라 Agent 사용법을 묶습니다.
# 예: Skills 도입 후에도 기존 CI로 검증(Skill과 직교)
xcodebuild -project MyApp.xcodeproj -scheme MyApp -destination 'platform=iOS Simulator,name=iPhone 16' build5. 반례: Skills 전부가 필요 없는 때
- 일회성 스크립트·50줄 미만 변경:
/grill-me는 과함. 인수 조건만 한 줄로. - Spec-Kit 파이프라인이 이미 안정: 갈아엎을 필요 없음.
/tdd,/diagnose만 골라 쓰기. - CONTEXT.md 담당자 없음:
/grill-with-docs는 형식화. 문서 오너 정한 뒤. - 핵심이 IM/Webhook 자동화: OpenClaw류 게이트웨이 우선. Skills 패키지는 채널 문제를 못 풂.
Star 수는 공감 지표지 「깔면 시니어」 보장은 아닙니다. Beta 업데이트가 빠르니 CHANGELOG 확인——특히 setup·Issue 템플릿 변경.
자주 묻는 질문 FAQ
mattpocock/skills와 Cursor Rules의 차이는?
Cursor Rules는 정적 프로젝트 규약 중심. mattpocock/skills는 /grill-me, /tdd처럼 대화 중 단계 실행 Slash 워크플로. Rules가 하한, Skills가 절차——병행이 자연스럽습니다.
Claude Code 전용인가요?
아닙니다. skills.sh 설치기는 Claude Code, Cursor, Codex 등 지원. 설치 시 Agent를 고르면 해당 도구 형식으로 설정 디렉터리에 기록됩니다.
설치 직후 첫 작업은?
/setup-matt-pocock-skills 실행. Issue 트래커, 트리아지 라벨, CONTEXT.md·ADR 경로 설정. 미 setup이면 /to-issues, /triage가 맥락 부족.
GSD, BMAD, Spec-Kit과 충돌하나요?
반드시 충돌하지 않습니다. Matt 패키지는 작고 조립 가능. Spec-Kit PRD가 있으면 /to-issues로 세로 슬라이스만 해도 가치 있습니다.
처음 설치할 Skill 세 개는?
대부분 /grill-me(또는 /grill-with-docs), /tdd, /to-issues. 정렬·테스트 피드백·분할. Git 사고 이력 있으면 /git-guardrails-claude-code 추가.
Mac에서 Agent를 돌릴 때 원격 Mac이 필요한가?
TypeScript/프론트는 로컬로 충분. iOS 빌드, 대용량 LLM, 24×7 게이트웨이(OpenClaw 등)는 전용 macOS가 필요할 수 있습니다. Skills는 협업 방식, 원격 Mac은 macOS 부하 위치——역할이 다릅니다.
정리
mattpocock/skills의 주목은 개발자가 원하는 게 「코드 쓰는 채팅창」이 아니라감사 가능하고 조립 가능하며 전수 가능한 공정이라는 증거입니다. /grill-me로 정렬 구멍을 막고, /tdd·/diagnose로 피드백 루프를 만들고, /to-issues로 PRD를 독립 출하 가능한 세로 슬라이스로——AI 코딩을 vibe에서 discipline으로 옮기는 지름길 중 하나입니다.
- 설치:
npx skills@latest add mattpocock/skills, 이어서/setup-matt-pocock-skills. - 기본 체인: 정렬 → PRD → Issue 분해 → TDD 구현 → 정기 아키 순찰.
- OpenClaw, 지식 그래프, 원격 Mac은 분업 보완. 서로 대체 아님.
macOS에서 Agent 게이트웨이·iOS CI를 실을 다음 수는 Macstripe 홈에서 M4 Mac Mini 전용 노드 확인. OpenClaw·AI 인프라 글은 개발자 블로그 색인에서.
