Matt Pocock skills 완전 정리: 2026년 AI 코딩 스킬 저장소가 17만 스타를 넘긴 이유
퀀텀점프클럽 정상록6 min read0 viewsMatt Pocock skills 완전 정리: 2026 AI 코딩 스킬 저장소가 17만 스타를 넘긴 이유
AI한테 코딩을 시켰는데 결과물이 자꾸 산으로 간 적 있으신가요. 2026년 7월 기준, 이 문제를 정면으로 다룬 GitHub 저장소 하나가 개발자 사이에서 화제입니다. TypeScript 교육으로 유명한 Matt Pocock이 자신의 .claude 폴더를 통째로 공개한 Matt Pocock skills(mattpocock/skills)인데요. 2026년 2월 3일에 만들어져 5개월여 만에 스타 17만 개(2026년 7월 16일 실측 172,414개)를 넘겼고, 지금도 실시간으로 늘고 있습니다.
에이전트 스킬: AI 코딩 에이전트에게 무엇을, 어떤 순서로, 어떤 가드레일을 지키며 할지 정해주는 재사용 가능한 작업 설명서. 지식을 알려주는 시스템 프롬프트와 달리, 반복 가능한 절차를 정해줍니다.
무엇이 이렇게 많은 개발자를 끌어당겼을까요. 이 글에서 저장소의 철학, 대표 스킬, 설치법, 그리고 팀이나 1인기업이 당장 적용할 점까지 정리했습니다.
목차
- Matt Pocock skills, 무엇이길래 17만 스타인가
- 바이브코딩이 아니라 진짜 엔지니어링인 이유
- AI 코딩의 4대 실패 모드와 처방
- 가장 유명한 스킬 grill-me
- user-invoked vs model-invoked
- 설치와 기본 워크플로우
- 팀·1인기업이 지금 적용할 점
- 자주 묻는 질문(FAQ)
Matt Pocock의 skills, 무엇이길래 17만 스타인가
한마디로, AI 코딩 에이전트에게 "이럴 땐 이렇게 일해라"를 정해주는 작은 작업 설명서 모음입니다. 저장소 태그라인부터 "Skills for Real Engineers. Straight from my .claude directory"예요. 자기가 매일 쓰는 실전 스킬을 그대로 꺼내 놓았다는 뜻이죠.
여기서 스킬(skill)과 시스템 프롬프트를 구분하면 이해가 빨라집니다. 시스템 프롬프트가 에이전트에게 "무엇을 아는지"를 알려준다면, 스킬은 "무엇을, 어떤 순서로, 어떤 가드레일을 지키며 할지"를 알려줍니다. 지식이 아니라 반복 가능한 절차인 거죠. Claude Code, Codex, Cursor처럼 Agent Skills 표준을 따르는 에이전트라면 어디서나 돌아갑니다. 라이선스는 MIT라 상업적으로도 자유롭게 쓸 수 있고요.
Matt Pocock은 Total TypeScript와 AI Hero를 운영하는 교육자이자 Vercel·Stately를 거친 엔지니어입니다. 그가 "요즘 이렇게 일한다"를 코드로 박제한 셈이라, 팔로워가 많은 것도 초기 확산에 한몫했습니다. 한 해설에 따르면 공개 첫 주에만 스타 26,000개가 붙었다고 합니다.
'바이브코딩'이 아니라 '진짜 엔지니어링'인 이유
저장소의 슬로건은 "바이브코딩(vibe coding)이 아니라 진짜 엔지니어링"입니다. 여기엔 분명한 문제의식이 깔려 있어요.
GSD, BMAD, Spec-Kit 같은 무거운 프레임워크는 개발 프로세스를 통째로 대신 소유합니다. 처음엔 편하지만, 대신 통제권을 내주게 되고 중간에 뭔가 틀어졌을 때 고치기가 어려워집니다. Matt은 정반대로 갔습니다. 스킬을 작게, 조합 가능하게, 어떤 모델에서도 동작하게 설계했어요. 그리고 "직접 뜯어고쳐서 네 것으로 만들어라"를 원칙으로 못 박았습니다.
이 철학은 설치 방식에도 그대로 드러납니다. 뒤에서 다시 설명하겠지만, 하나는 파일을 복사해 마음껏 편집하는 방식이고 다른 하나는 읽기 전용으로 구독하는 방식이에요. 통제권을 얼마나 쥘지 사용자가 고르게 한 거죠.
AI 코딩의 4대 실패 모드와 처방
Matt이 스킬을 만든 이유는 AI 코딩에서 반복되는 실패 네 가지를 잡기 위해서입니다. 흥미로운 건, 처방이 전부 오래된 엔지니어링 기본기라는 점이에요.
1. 에이전트가 내가 원한 걸 안 만든다. 소프트웨어 개발의 가장 흔한 실패는 정렬 실패입니다. 개발자가 이해했다고 생각했는데 결과물을 보면 전혀 아닌 상황이죠. 처방은 grill-me·grill-with-docs로, 에이전트가 사람을 거꾸로 심문해 만들기 전에 방향을 맞춥니다.
2. 에이전트가 너무 장황하다. 프로젝트 초기엔 개발자와 도메인 전문가가 서로 다른 언어로 말합니다. 에이전트도 마찬가지라, 한 단어면 될 걸 스무 단어로 설명하죠. 처방은 에릭 에반스의 도메인 주도 설계에서 온 공유 언어(ubiquitous language)입니다. 프로젝트 용어를 CONTEXT.md에 문서화해 사람과 에이전트가 같은 말을 쓰게 합니다.
3. 코드가 안 돌아간다. 정렬이 맞아도 결과물이 엉망일 수 있습니다. 이때 필요한 건 피드백 루프예요. tdd 스킬은 실패하는 테스트를 먼저 쓰고(red), 통과시키고(green), 다듬는(refactor) 순서를 강제합니다.
4. 진흙 공(ball of mud)을 만들었다. 에이전트가 코딩 속도를 높이면 소프트웨어 복잡도도 그만큼 빨리 쌓입니다. 처방은 설계에 매일 투자하는 것이에요. codebase-design과 improve-codebase-architecture가 진흙탕이 된 코드를 구조적으로 구해냅니다.
가장 유명한 스킬: grill-me와 거꾸로 심문
이 저장소에서 제일 인기 있는 스킬은 grill-me입니다. Matt 본인도 "grill-me 스킬이 바이럴을 탔다"고 밝혔죠.
발상이 재밌습니다. 보통은 우리가 AI에게 질문하잖아요. grill-me는 반대로 AI가 사람을 심문합니다. "이 기능 만들 때 이 경우는 어떻게 처리할 거예요?", "이건 왜 이렇게 정했어요?" 하고 한 번에 한 질문씩, 결정 트리의 모든 가지가 풀릴 때까지 캐묻습니다.
grill-me는 코드베이스가 없을 때(커리큘럼 설계나 의사결정 같은 순수 사고 도구)에 쓰고, grill-with-docs는 코드베이스가 있을 때 씁니다. 후자는 심문에 도메인 모델링을 얹어서, 정리된 용어는 CONTEXT.md 용어집에, 되돌리기 어려운 결정은 ADR(아키텍처 결정 기록)에 남깁니다. 대화가 끝나도 정렬이 문서로 살아남는 거죠.
또 하나 눈여겨볼 스킬은 code-review입니다. 최신 버전에서 Fowler의 "Bad Smells in Code" 12종을 상시 베이스라인으로 삼도록 강화됐어요. 저장소 코딩 표준을 지켰는지 보는 Standards 축과 원래 요구사항을 충실히 구현했는지 보는 Spec 축을, 서로 오염되지 않게 병렬로 검토합니다.
user-invoked vs model-invoked: 스킬 설계의 핵심 축
스킬을 이해하는 가장 중요한 열쇠는 "누가 호출하는가"입니다.
user-invoked 스킬은 사람이 이름을 직접 쳐야 실행됩니다. grill-me처럼 판을 짜는 오케스트레이션 스킬이죠. 에이전트가 자동으로 부를 수 없어서 문맥(context)을 차지하지 않지만, 대신 사람이 그 존재를 기억해야 합니다.
model-invoked 스킬은 사람도 부르고 에이전트가 상황에 맞으면 자동으로 집어듭니다. tdd나 code-review처럼 몸에 밴 규율이에요. 편하지만, 설명(description)이 매 턴 문맥에 상주하는 비용을 냅니다.
Matt은 이 두 부하(문맥 부하와 사람의 기억 부하)를 저울질해 "꼭 자동이어야 하나"를 따져 스킬을 나눕니다. user-invoked가 기억하기 벅찰 만큼 많아지면, ask-matt 같은 라우터 스킬 하나로 정리하고요. 스킬을 잘 쓰는 것만큼이나 스킬을 잘 설계하는 것도 하나의 학문이라는 걸 보여주는 대목입니다.
설치와 기본 워크플로우
설치도 철학이 둘입니다.
첫째, npx skills@latest add mattpocock/skills를 실행하면 스킬 파일이 내 프로젝트로 복사됩니다. 마음껏 고쳐서 내 것으로 만드는 쪽이에요. Codex나 Cursor 같은 다른 에이전트에도 이 방식으로 오늘 바로 설치됩니다.
둘째, Claude Code 플러그인으로 설치하면 스킬 세트를 읽기 전용 번들로 구독합니다. Matt이 새 버전을 내면 자동으로 따라오는 쪽이죠. 직접 관리하지 않고 늘 최신 상태로 쓰고 싶다면 이쪽이 맞습니다.
설치 후 기본 흐름은 이렇습니다. 아이디어 → /to-spec(스펙 작성) → /to-tickets(작업 쪼개기) → /implement(구현). 구현 단계에서 미리 합의한 지점마다 tdd가 red-green 엔진으로 돌고, 커밋 직전에 code-review가 붙어 마무리합니다.
팀·1인기업이 지금 적용할 점
개발팀이든 혼자 일하는 1인기업이든, 이 저장소에서 바로 가져갈 교훈이 있습니다.
- 만들기 전에 정렬부터. 큰 기능을 시작하기 전에 에이전트가 나를 심문하게 두세요. 30분의 심문이 며칠의 헛삽질을 막습니다.
- 용어를 문서로. 프로젝트 고유 용어를
CONTEXT.md한 곳에 모으면, 사람도 에이전트도 같은 언어로 말하게 됩니다. - 피드백 루프를 먼저. 타입 체크, 자동 테스트, 브라우저 접근 같은 피드백이 없으면 에이전트는 눈 감고 나는 셈이에요. TDD 루프를 붙이세요.
- 설계에 매일 투자. 며칠에 한 번씩 코드 구조를 점검하는 습관이 진흙탕을 막습니다.
핵심은 하나로 모입니다. 도구가 좋아질수록, 사람이 무엇을 원하는지 먼저 또렷하게 만드는 일이 더 중요해진다는 것. AI 시대에도 소프트웨어 엔지니어링의 기본기는 그대로입니다.
자주 묻는 질문 (FAQ)
Q. Claude Code에서만 쓸 수 있나요?
아니요. Agent Skills 표준을 따르는 에이전트라면 Claude Code뿐 아니라 Codex, Cursor에서도 씁니다. skills.sh 설치 방식이 여러 하네스를 지원합니다.
Q. 무료인가요?
네. MIT 라이선스라 개인·상업 프로젝트 모두 자유롭게 사용·수정할 수 있습니다.
Q. grill-me와 grill-with-docs 중 뭘 써야 하나요?
코드베이스가 있으면 grill-with-docs(도메인 모델링과 문서화까지), 없으면 grill-me(순수 심문)를 쓰면 됩니다.
Q. 스킬을 직접 고쳐도 되나요?
그게 저장소의 원칙입니다. npx skills add 방식으로 설치하면 파일이 복사되니 마음껏 편집해 내 프로젝트에 맞게 바꾸세요. 반대로 손대지 않고 늘 최신으로 쓰고 싶으면 플러그인 구독을 선택하면 됩니다.
마무리
Matt Pocock skills가 17만 스타를 모은 이유는 화려한 자동화가 아니라, 오래된 엔지니어링 기본기를 AI 시대에 맞게 다시 꺼내 놓았기 때문입니다. 만들기 전에 정렬을 맞추고, 용어를 문서로 남기고, 테스트로 피드백을 받고, 설계에 매일 투자하는 네 가지. 도구가 아무리 빨라져도 이 습관이 결과의 질을 가릅니다. 오늘 프로젝트 하나에 grill-me부터 붙여 보세요. 그 30분이 며칠의 헛삽질을 아껴 줄 겁니다.
