Matt Pocock의 Agent Skills 16개 — Real Engineering, Not Vibe Coding

Total TypeScript의 Matt Pocock이 자기 .claude 디렉토리를 그대로 오픈소스로 풀었다. 결과는 충격적이다. 공개 3개월 만에 GitHub stars 30,344, forks 2,380. 슬로건은 단 한 줄이다.

"My agent skills that I use every day to do real engineering — not vibe coding."

이 문장이 지금 AI 개발 생태계에서 가장 정확한 진단이다. AI에게 "잘 부탁해"라고 던지는 시대(vibe coding)는 끝났다. 워크플로우를 코드화하는 시대(real engineering)가 시작됐다. 이 글은 그 변곡점을 만든 16개 스킬의 정체와 사용법을 정리한다.

저장소 메타: 30K stars의 의미

먼저 숫자부터 보자.

3개월 만에 30K stars는 Vercel의 ai 패키지나 shadcn/ui 초기 성장 곡선과 비슷하다. 차이는 두 가지다. 첫째, 이건 라이브러리가 아니라 디렉토리 구조다. 둘째, 저자가 영업하지 않았다. 사람들이 자발적으로 fork했다.

비유하자면 요리사가 자기 손때 묻은 레시피북을 그대로 공개한 것과 같다. 프랜차이즈 매뉴얼이 아니다. 매일 쓰는 작업 노트다.

16개 스킬 카탈로그

스킬은 4개 카테고리로 분류된다. 하나씩 짚어보자.

Planning & Design (5개) — 무엇을 만들지 결정하는 단계

이 중 가장 강력한 건 grill-me다. 비유하자면 회의적인 테크리드를 24시간 터미널에 앉혀둔 효과다. "이건 왜?", "이 엣지 케이스는?", "이 결정의 비용은?" 질문 폭격이 결정 트리의 모든 분기가 해소될 때까지 멈추지 않는다.

to-prd도 영리하다. 이미 논의된 내용을 다시 인터뷰하지 않는다. 현재 컨텍스트를 합성해서 바로 GitHub 이슈로 던진다. 회의 끝난 직후 PRD가 issue tracker에 올라가 있다.

Development (5개) — 실제 코드를 쓰는 단계

tdd 스킬이 핵심이다. 코드 작성 전에 3가지 질문을 강제한다.

1. 이 코드는 테스트 가능하게 설계됐는가?
2. 핵심 동작은 무엇인가?
3. 인터페이스 변경이 필요한가?

여기서 흥미로운 건 friction 추가 위치다. Matt Pocock의 표현으로 "rushing produces bad outcomes"인 구간에만 의도적으로 마찰을 넣는다. 모든 단계에 절차를 넣지 않는다. 위험한 곳에만 안전벨트를 매는 방식이다.

Tooling & Setup (2개) — 환경 안전장치

git-guardrails-claude-code는 야간 자동화 돌릴 때 진짜 안전벨트다. git push, git reset --hard, git clean -fd 같은 비가역 명령을 hooks 단에서 막는다. AI가 새벽 3시에 --force로 main을 박살낼 가능성을 0으로 만든다.

Writing & Knowledge (4개) — 자기 확장의 핵심

write-a-skill이 메타 레벨이다. 스킬이 스킬을 만든다. 자기 확장 시스템이다. 비유하자면 도구를 만드는 도구를 만들고 있는 셈이다. 이 패턴이 30K stars의 두 번째 비밀이다. 사용자가 자기 워크플로우를 직접 추가할 수 있다.

설치 방법: npx 한 줄

vercel-labs/skills CLI(주간 다운로드 58만회)를 사용한다.

# 단일 스킬 프로젝트 설치
npx skills@latest add mattpocock/skills/tdd

# 글로벌 설치 (~/.claude/skills/)
npx skills add mattpocock/skills/tdd -g

# 전체 16개 스킬 일괄 설치
npx skills add mattpocock/skills --all

지원 에이전트가 49개를 넘는다. Claude Code, Codex, Cursor, OpenCode, Gemini CLI, GitHub Copilot, OpenClaw, Antigravity 등. 한 번 설치한 스킬을 모든 에이전트에서 재사용할 수 있다.

핵심 철학 4가지

저장소 README와 실제 스킬 구조를 분석하면 4가지 원칙이 일관되게 흐른다.

1. 프롬프트가 아니라 프로세스

스킬은 "이렇게 답해줘"가 아니다. "어떻게 일할지"의 정의다. 입력이 같아도 프로세스를 바꾸면 출력이 근본적으로 달라진다. AI에게 보내는 메시지가 아니라, AI가 사는 작업장 그 자체를 설계하는 것에 가깝다.

2. Progressive Disclosure

루트 SKILL.md 파일은 50줄 이하다. 상세는 references/ 디렉토리로 분리한다. 컨텍스트 토큰을 의도적으로 절약한다. AI가 "필요할 때만" 깊이 들어간다. 비유하자면 백과사전 1권의 차례만 처음에 보고, 필요한 챕터만 펴서 읽는 방식이다.

3. Vertical Slice 우선

TDD, 리팩토링, 이슈 분해 모두 vertical slice 단위로 작업한다. UI부터 DB까지 한 기능만 끝까지 통과시킨다. "레이어별 완성"이 아니라 "기능별 완성".

4. 자기 확장 (Self-Extending)

write-a-skill 자체가 새 스킬을 만들 수 있다. 사용자는 자기 코드베이스에 맞게 스킬을 추가하고 동료와 공유한다. npm 패키지처럼 진화한다.

"Skill Economy"의 시작

Vibe Sparking 매체가 명명한 "스킬 이코노미"의 시작점이 이 저장소다. 시각화하면 이렇다.

2025: 프롬프트 엔지니어링 (개인 노하우)
  ↓
2026 Q1: AGENTS.md / CLAUDE.md (프로젝트 단위 컨텍스트)
  ↓
2026 Q2: Agent Skills (재사용 가능한 워크플로우)
  ↓
2026+: Skill 레지스트리 (npm 같은 생태계)

증거가 더 있다. 2026년 4월 Matt Pocock은 "Claude Code for Real Engineers" 동영상 코스를 출시했다. Plan/Execute/Clear 워크플로우, AGENTS.md 패턴, Ralph Wiggum 자율 루프를 다룬다. 이 코스의 실전 토대가 곧 mattpocock/skills 저장소다. 즉 30K stars는 운이 아니다. 교육과 도구가 한 트랙으로 정렬된 결과다.

오늘 당장 시작하기 — 추천 5개 스킬

16개 다 설치할 필요는 없다. 처음 시작한다면 5개로 충분하다.

1. tdd — 어떤 코드베이스든 즉시 효과
2. grill-me — 큰 결정 앞에서 반드시 호출
3. to-prd — 회의 끝난 직후 호출, GitHub 이슈로 직행
4. write-a-skill — 자기 워크플로우를 스킬로 만들 때
5. git-guardrails-claude-code — 자동화 안전벨트

# 5개 일괄 설치
npx skills add mattpocock/skills/tdd
npx skills add mattpocock/skills/grill-me
npx skills add mattpocock/skills/to-prd
npx skills add mattpocock/skills/write-a-skill
npx skills add mattpocock/skills/git-guardrails-claude-code

마치며

mattpocock/skills 저장소가 던지는 메시지는 분명하다. AI는 도구가 아니라 동료다. 단, 워크플로우가 정의돼 있을 때만. 프로세스 없는 AI는 vibe coding이고, 프로세스 있는 AI는 real engineering이다.

오늘 npx 한 줄부터 시작해보자. tdd 스킬 하나만 설치해도 다음 PR이 달라진다.

출처

• mattpocock/skills (GitHub 공식)
• skills (npm 패키지)
• Matt Pocock's Skills: The Skill Economy Starts Here (Vibe Sparking)
• TDD Skill for Claude Code Analysis (resolvewith.me)
• Claude Code for Real Engineers Course