TypeScript 끝판왕 Matt Pocock, 본인 .claude/skills 폴더를 통째로 공개하다

Total TypeScript를 만든 Matt Pocock이 본인 .claude/skills 폴더를 깃허브에 올렸다. 레포 이름은 mattpocock/skills이고, 설명은 "Skills for Real Engineers. Straight from my .claude directory."로 박아두었다. 본인이 매일 쓰던 것을 그대로 던졌다는 뜻이다.

 

영어권 TypeScript 교육 시장에서 워낙 인지도가 높은 사람이라, 본인 AI 코딩 워크플로우를 통째로 공개하는 일은 흔치 않은 케이스다. 2026년 5월 1일 기준 별 4만 8천 개, 포크 3,900개 가까이 찍혔다. 2026년 2월 초에 공개됐으니 약 석 달 만에 이 정도면 상당한 화제다.

 

각설하고, Matt Pocock skills 레포 안을 카테고리별로 뜯어보고, 한국 개발자 입장에서 그대로 쓸 수 있는 스킬과 손봐야 하는 스킬을 가렸다. 5분 안에 따라 깔아보는 셋업도 마지막에 붙였다.

 

 

https://github.com/mattpocock/skills

GitHub - mattpocock/skills: Skills for Real Engineers. Straight from my .claude directory.

 

 

Matt Pocock은 누구인가, Total TypeScript의 그 사람

 

이름만 들어본 사람도 있을 테니 짧게 정리한다. Matt Pocock은 Total TypeScript라는 유료 워크샵 시리즈를 만든 사람이다. TypeScript Pro Essentials, Type Transformations, Advanced TypeScript Patterns 같은 워크샵이 모두 이 사람 작품이고, 트위터에서도 TypeScript 팁을 짧게 던지는 것으로 유명하다.

 

이 사람 워크플로우를 신뢰할 만한 이유는 두 가지로 압축된다. 본업이 콘텐츠 제작이라 코드 짜고 강의 만들고 글 쓰는 사이클을 매일 돌리고, 그 와중에 AI 도구를 진심으로 깎아 쓴다는 것이 첫째다. 둘째는 도메인 자체의 궁합이다. TypeScript는 정적 타입 체커가 잘 잡힌 언어라서, 타입 에러가 곧 빠른 피드백 루프가 되고, TDD나 디버깅 자동화와 잘 맞는다. 이 사람 스킬들도 그 강점 위에서 설계됐다.

 

.claude/skills 폴더가 무엇이길래 이렇게 난리인가

 

Claude Code skills 시스템 자체를 모르는 사람들을 위해 30초 요약한다.

 

Claude Code skills 시스템 30초 요약

 

스킬은 Claude Code가 특정 상황을 만나면 자동으로 호출하는 재사용 가능한 프롬프트 묶음이다. 구조는 단순하다.

 

~/.claude/skills/
└── 스킬이름/
    ├── SKILL.md          # 메인 진입점 (frontmatter + 본문)
    └── 보조파일.md        # 필요하면 더 추가

 

SKILL.md의 YAML 프론트매터에 name과 description이 들어가는데, 모델이 사용자 메시지를 읽고 이 디스크립션과 매칭되면 알아서 해당 스킬을 로드해 따라간다. 슬래시 커맨드처럼 명시적으로 부를 수도 있고, 디스크립션 매칭으로 알아서 발동될 수도 있다.

 

한 번 만들어두면 이 컴퓨터, 저 프로젝트에서 모두 쓸 수 있다는 점이 좋다. dotfiles처럼 자기 워크플로우가 자산이 되는 셈이다.

 

자기 스킬 공개 트렌드가 생긴 이유

 

2025년 후반부터 GitHub에 .claude/skills를 공개하는 사람이 늘기 시작했다. dotfiles 공개 트렌드의 AI 버전인 셈이다. 본인 워크플로우를 박제해두면 다른 사람이 베껴 쓰기 좋고, 자기 머릿속도 정리되며, 이 사람이 일하는 방식이 그대로 드러나니 채용/세일즈 측면의 자기 PR도 된다. Matt Pocock 정도의 이름값 있는 사람이 던지면 파급력은 상상 이상이다.

 

Matt Pocock skills 레포 안에 정확히 무엇이 있는가

 

레포 구조부터 살펴본다.

 

mattpocock/skills/
├── .claude-plugin/
├── .out-of-scope/
├── docs/adr/
├── scripts/
├── skills/
│   ├── deprecated/
│   ├── engineering/
│   ├── misc/
│   ├── personal/
│   └── productivity/
├── CLAUDE.md
├── CONTEXT.md
├── LICENSE       # MIT
└── README.md

 

skills/ 안에 카테고리는 5개다. deprecated, personal을 빼고 보면 핵심은 engineering, productivity, misc 세 폴더다. 각각에 들어 있는 스킬을 풀어본다.

 

엔지니어링 폴더가 9개로 가장 두꺼우니 이것이 본진이다. 본진은 표로 정리한다.

 

스킬	한 줄 설명
`tdd`	Red-Green-Refactor 루프 자동화. 사용자가 "TDD로", "테스트 먼저" 같은 말을 꺼내면 자동 호출
`diagnose`	어려운 버그/성능 회귀를 6단계(피드백 루프 구축→재현→가설→계측→수정+회귀테스트→정리/사후분석)로 풀어가는 루프
`triage`	들어온 이슈/버그 분류
`to-issues`	대화 내용을 깃허브 이슈 형태로 변환
`to-prd`	대화 내용을 PRD(제품 기획 문서)로 변환
`grill-with-docs`	문서 업데이트와 함께 가는 플래닝 세션
`zoom-out`	디테일에 빠져 있을 때 한 발 빼서 전체 그림 보기
`improve-codebase-architecture`	코드베이스 아키텍처 개선
`setup-matt-pocock-skills`	초기 셋업용 (이슈 트래커, 문서 선호 등 입력받음)

 

흥미로운 것은 이 폴더에 TypeScript 전용 스킬이 따로 없다는 점이다. Matt Pocock = TypeScript 사람이라고 생각하고 들어가면 약간 김이 빠진다. 대신 TDD, 디버깅, PRD 같은 일반 엔지니어링 워크플로우 스킬에 집중되어 있는데, AI 시대에도 기본기가 답이라는 신호로 읽힌다.

 

생산성 폴더는 3개다. grill-me는 사용자 계획이나 디자인을 끝까지 추궁(grill)해서 합의에 도달할 때까지 인터뷰하는 스킬이고, caveman은 토큰 75%를 줄이는 초압축 커뮤니케이션 모드다. 관사고 군더더기고 모두 빼고 핵심만 말하라는 것이다. 마지막으로 write-a-skill이 있는데, 새 스킬을 만들 때 쓰는 스킬, 즉 스킬을 만드는 스킬이다.

 

caveman은 디스크립션이 진짜 웃긴데, "talk like caveman", "less tokens" 같은 말이 트리거다. 글자 그대로 원시인처럼 말하라는 것이다. 토큰 비용에 신경 쓰는 사람한테는 꽤 실용적이다.

 

grill-me는 개인적으로 가장 인상 깊었던 스킬이다. 사용자가 무언가 만들어달라고 하면 바로 코드를 짜는 것이 아니라, 의사결정 트리의 모든 가지를 하나씩 질문해서 합의를 본 뒤에 진행한다. AI가 미리 추측하고 코드를 박아놨다가 갈아엎는 비용을 줄이려는 의도다.

 

미스크 폴더에는 4개가 들어 있다. git-guardrails-claude-code는 git의 위험한 명령(force push, hard reset 같은 것)에 가드레일을 거는 스킬, migrate-to-shoehorn은 shoehorn이라는 라이브러리로 테스트 마이그레이션을 도와주는 것이다. scaffold-exercises는 강의/튜토리얼용 연습문제 스캐폴딩이라서 Matt Pocock이 본인 강의 만들 때 쓰던 것을 그대로 공개한 모양인데, 일반 개발자에게는 큰 의미가 없을 수 있다. setup-pre-commit은 pre-commit 훅 셋업이다.

 

가장 흥미로웠던 스킬 3개를 꼽다

 

전부 다 좋지만 그 중에서 진짜로 베껴 쓰고 싶었던 것 셋만 골랐다.

 

1. tdd: 진짜로 동작하는 TDD 루프

 

디스크립션은 "Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD..." 이런 식이다.

 

핵심은 본문에 박힌 안티 패턴 경고다. "절대 테스트를 다 쓰고 나서 구현 다 하지 말라(horizontal slicing 금지)"라고 못 박아두었다. 즉 "테스트 10개 → 구현 10개" 식이 아니라, 한 슬라이스씩 vertical로 가야 한다는 것이다. 이걸 강제하는 스킬은 흔치 않다.

 

2. caveman: 토큰 비용 75% 컷

 

API 비용을 줄이려고 만든 게 아니라 사고의 군더더기를 줄이려고 만든 느낌이 강하다. 며칠 caveman 모드로 작업해보니 모델 답변이 진짜 짧아지는데, 짧은 답이 더 정확하게 느껴지는 것이 신기하다. 자기 합리화하는 텍스트가 줄어드니 결정에 필요한 정보만 남는 효과로 보인다.

 

3. grill-me: AI에게 인터뷰 당하기

 

이 스킬을 켜고 쓰면 진짜 귀찮다. 한 번에 하나씩 질문을 던지고, 추천 답변까지 같이 줘서 결정하라고 강요한다. 며칠 전 단순한 캐싱 레이어 하나 붙이려다 grill-me로 12개 질문을 받았는데, 그 중 "캐시 무효화 기준이 mtime이냐 컨텐츠 해시냐"라는 질문에서 결정이 뒤집혔다. 처음에는 그냥 mtime으로 박을 생각이었는데 인터뷰하면서 mtime이 git checkout으로 바뀌는 케이스를 놓쳤다는 것을 깨달았다. 잘못된 방향으로 5시간 코드 짜는 비용보다 12분 인터뷰가 훨씬 쌌다.

 

솔직히 평범했던 스킬들

 

좋은 얘기만 하면 균형이 안 맞으니 평범한 영역도 짚어둔다. 가장 큰 것은 TypeScript 전용 스킬이 없다는 점이다. Total TypeScript를 만든 사람 레포라는 기대를 갖고 들어가면 약간 김이 빠진다. 자기 도메인 전문성은 따로 박지 않았고, 일반 엔지니어링 스킬이 더 중요하다고 본 모양이다.

 

misc/migrate-to-shoehorn이나 scaffold-exercises 같은 것은 본인 컨텍스트에 너무 의존적이라 다른 사람이 그대로 쓸 일이 없다. personal/, deprecated/ 폴더도 비슷한 결이다. 또 루트에 있는 CLAUDE.md, CONTEXT.md 같은 문서는 본인 프로젝트 컨벤션이 박혀 있어서 그대로 베끼면 안 되는 참고용이다.

 

한국 개발자 입장에서 그대로 쓸 수 있는 것 vs 수정해야 하는 것

 

스킬 15개를 OK / 손봐야 함 / 안 가져와도 됨으로 분류해봤다.

 

스킬	그대로 OK?	비고
`tdd`	O	언어 무관, 한국어 환경에서도 그대로 동작
`diagnose`	O	디버깅 루프는 만국 공통
`grill-me`	O	영어로 질문 와도 한국어로 답해도 OK
`caveman`	O	한글로 써도 토큰 절약됨
`triage`	O	일반 워크플로우라 그대로 됨
`zoom-out`	O	그대로 사용 가능
`git-guardrails-claude-code`	O	git 위험 명령은 만국 공통
`setup-pre-commit`	O	pre-commit 훅도 그대로 OK
`to-issues`	△	깃허브/지라 등 본인 트래커에 맞게 살짝 수정
`to-prd`	△	PRD 템플릿이 한국 회사 양식과 다를 수 있음
`improve-codebase-architecture`	△	한국어 코멘트/네이밍 컨벤션 반영하면 더 좋음
`grill-with-docs`	△	사내 문서 시스템(노션, 컨플루언스)에 맞게 손봐야 함
`setup-matt-pocock-skills`	△	초기 셋업용. 한국 환경(노션, 슬랙 등)으로 답하면 됨
`migrate-to-shoehorn`	X	Matt 본인 라이브러리 마이그레이션용
`scaffold-exercises`	X	강의 만드는 사람 아니면 안 씀

 

표를 합쳐 보면 8개는 그대로 베껴 써도 되고, 5개는 살짝 손보면 되며, 2개는 굳이 안 가져와도 된다. 시작점으로는 충분히 든든한 기본 셋이다.

 

Matt Pocock skills 따라하기 5분 가이드

 

진짜 5분 안에 끝난다.

 

먼저 ~/.claude/ 폴더가 이미 있는지 확인한다. 없으면 Claude Code부터 깔아야 한다. 그다음 레포 README에 박아둔 공식 셋업 명령어 한 줄을 실행한다.

 

npx skills@latest add mattpocock/skills

 

이거 한 방이면 ~/.claude/skills/mattpocock-skills/ 같은 경로에 깔린다(정확한 경로는 명령어 출력에서 확인). npx skills는 별도 CLI인데, 여러 사람의 스킬 레포를 합쳐 쓸 수 있게 만든 도구다.

 

설치가 끝나면 Claude Code를 켜고 셋업 스킬을 돌리면 된다.

 

/setup-matt-pocock-skills

 

이슈 트래커를 무엇을 쓰는지(깃허브, 리니어, 지라), 문서를 어디에 쓰는지(노션, 컨플루언스) 같은 것을 물어본다. 답변하면 컨피그가 자동으로 작성된다.

 

테스트는 코딩 작업 하나 시켜보고 /grill-me나 /tdd 같은 슬래시 커맨드를 직접 쳐보면 된다. 자동 매칭이 동작하는지 보려면 "이거 TDD로 만들어줘" 같이 디스크립션과 겹치는 단어를 던지면 된다.

 

라이선스는 MIT라서 그대로 베껴서 사내 또는 본인 환경에서 써도 OK다. 어디 공개할 거면 출처/원작자 표기는 권장한다.

 

 

출처: totaltypescript.com

 

그래서 이거 진짜 쓸 만한가, 솔직 평가

 

좋은 점부터 보면, 이 사람이 매일 쓰는 것이라 빈말이 없는 실전 검증 프롬프트라는 점, MIT 라이선스라 그대로 가져다 써도 되는 점, 엔지니어링 스킬 9개가 워낙 잘 짜여 있어서 본인 첫 스킬 셋업의 베이스로 쓰기 좋다는 점이 강점이다. caveman이나 grill-me 같은 창의적인 스킬은 영감 자극용으로도 쓸 만하다.

 

다만 아쉬운 점도 있다. 전부 영어 베이스라 디스크립션 자동 매칭을 쓸 거면 본인이 영어로 프롬프트 던질 때 가장 정확하게 발동한다. TypeScript 전용 스킬이 없다 보니 Matt Pocock 도메인 전문성을 직접 베끼는 것은 아니고, personal/이나 deprecated/처럼 본인 컨텍스트 의존 폴더가 섞여 있어서 그대로 다 깔면 군더더기가 생긴다. migrate-to-shoehorn 같은 본인 라이브러리 의존 스킬은 클론할 때 빼는 것이 정신 건강에 좋다.

 

추천 대상은 이미 Claude Code를 어느 정도 써본 사람, 본인 스킬 셋업을 시작하는 사람, TDD나 디버깅 워크플로우를 강제하고 싶은 사람이다. 비추천 대상은 Claude Code를 처음 깐 사람(먼저 기본부터 익히는 것이 낫다), 그리고 한국어로만 작업하는 사람(영어 디스크립션 매칭 한계가 있어서 본인 워크플로우를 한국어로 다시 짜는 것이 나을 수도 있다)이다.

 

Matt Pocock skills가 던지는 진짜 교훈

 

Matt Pocock skills를 뜯어보면서 가장 강하게 남는 것은 결국 기본기 위에 짓는 워크플로우라는 점이다. TypeScript 끝판왕인 사람이 정작 자기 스킬 폴더에 박아둔 것은 TDD, 디버깅, 코드 리뷰 같은 일반 엔지니어링 도구였다. AI가 발전한다고 기본기를 패스하면 안 된다는 신호처럼 읽혔다.

 

워크플로우 자체가 공유 가능한 자산이 된 점도 인상적이다. dotfiles 공개하던 시대가 .claude 폴더 공개하는 시대로 넘어왔다는 것이다. 본인 Claude Code skills 셋업을 깃허브에 올려두면 자기 PR이자 커뮤니티 기여가 된다.

 

그래서 권장 순서는 이것이다. Matt Pocock skills 레포를 그대로 베껴 깔고, 검증된 9개 엔지니어링 스킬을 베이스로 쓰면서, 자기 도메인(한국어 글쓰기, 사내 컨벤션 등)에 맞는 스킬을 위에 얹어가는 식이다. 처음부터 스킬을 짜려고 하면 막막한데, 누가 만들어둔 베이스 위에서 추가하는 것은 훨씬 쉽다. 다음 단계는 본인 ~/.claude/skills/ 폴더를 공개하는 것이다. 본인 워크플로우를 박제해두면 6개월 뒤 자기 자신이 가장 고마워하게 된다.