🆓 Matt Pocock Skills 완벽 가이드 - AI 코딩 에이전트 실무 필수 스킬 (30 초 설치)

안녕하세요! 오늘은 AI 코딩 에이전트 사용자를 위한 실무 필수 스킬 팩인 Matt Pocock Skills 에 대해 알아보겠습니다. 이 스킬들은 Claude Code, Cursor, Codex 등 어떤 AI 코딩 에이전트에서도 작동하며, 수십 년의 소프트웨어 엔지니어링 경험을 바탕으로 만들어졌습니다. Matt Pocock 는 Total TypeScript 로 유명한 개발 교육자이며, 그가 직접 매일 사용하는 스킬들을 공개했습니다. 특히 /grill-me, /grill-with-docs, /tdd 스킬은 실제로 코드 품질을 크게 향상시켜 줍니다.

이 블로그에서는 Matt Pocock Skills 의 30 초 설치 방법, 주요 스킬 7 가지 사용법, 실제 프로젝트에 적용하는 방법을 단계별로 자세히 알아보겠습니다. 그럼 바로 시작해볼까요?

 

🤖 Matt Pocock Skills 란 무엇인가요?

Matt Pocock Skills 는 AI 코딩 에이전트가 **실제 엔지니어링**을 할 수 있도록 도와주는 작은 규모의 스킬 모음입니다. GSD, BMAD, Spec-Kit 같은 접근 방식은 프로세스를 소유하면서 통제권을 빼앗고 버그를 찾기 어렵게 만듭니다. 반면 이 스킬들은 **작고, 적응하기 쉬우며, 조합 가능**하도록 설계되었습니다.

핵심 개념: 스킬 (Skill) 이란 AI 에이전트에게 특정 작업을 수행하는 방법을 가르치는 프롬프트의 집합입니다. 각 스킬은 마크다운 파일로 작성되며, AI 에이전트의 설정 폴더에 설치하여 사용합니다.

왜 필요한가요?

AI 코딩 에이전트를 사용해 본 개발자라면 누구나 한 번쯤 겪는 일반적인 실패 모드들이 있습니다:

문제	설명	해결 스킬
요구사항 불일치	에이전트가 내가 원하는 것을 이해하지 못함	/grill-me, /grill-with-docs
지나친 상세 설명	에이전트가 20 단어로 설명할 것을 1 단어로 끝냄	CONTEXT.md (공유 언어)
코드 품질 저하	피드백 루프 없이 잘못된 코드 생성	/tdd, /diagnose
코드베이스 복잡도 증가	AI 가 생성한 코드로 인해 엔트로피 증가	/improve-codebase-architecture

🚀 30 초 설치 방법 (완벽 가이드)

설치는 매우 간단합니다. 단 4 단계, 30 초면 끝납니다.

Step 1: skills.sh 인스톨러 실행

터미널을 열고 다음 명령어를 실행합니다:

npx skills@latest add mattpocock/skills

이 명령어는 skills.sh 인스톨러를 다운로드하고 실행합니다. `npx`를 사용하므로 별도의 전역 설치가 필요 없습니다.

Step 2: 사용할 스킬 선택

인스톨러가 실행되면 사용할 스킬을 선택합니다. 처음에는 다음 3 가지를 추천합니다:

✓ /grill-me          - 요구사항 명확화
✓ /grill-with-docs   - 문서화와 함께 그릴링
✓ /setup-matt-pocock-skills - 설정 스킬 (필수!)

Tip: /setup-matt-pocock-skills는 반드시 선택하세요. 이 스킬은 다른 스킬들이 작동하기 위한 설정을 자동으로 완료합니다.

Step 3: AI 에이전트 선택

스킬을 설치할 AI 코딩 에이전트를 선택합니다:

에이전트	지원 여부	추천도
Claude Code	✅ 완전 지원	⭐⭐⭐⭐⭐
Cursor	✅ 완전 지원	⭐⭐⭐⭐⭐
Codex	✅ 완전 지원	⭐⭐⭐⭐
Windsurf	✅ 완전 지원	⭐⭐⭐⭐

Step 4: 설정 스킬 실행

AI 에이전트에서 /setup-matt-pocock-skills 명령어를 실행합니다. 이 스킬은 다음 3 가지를 설정합니다:

1. 이슈 트래커 선택: GitHub, Linear, 로컬 파일 중 선택
2. 트리아지 라벨 정의: /triage 스킬이 사용할 라벨 vocabulary
3. 문서 저장 위치: CONTEXT.md, ADR 등을 저장할 폴더

/setup-matt-pocock-skills

이제 준비 완료! Bam - you're ready to go.

 

💡 추천 스킬 Top 7 (실무 사용법)

70 개 이상의 스킬 중에서 실무에서 가장 유용하게 쓰이는 7 가지를 소개합니다.

1. /grill-me - 요구사항 명확화

사용 시기: 새로운 기능 개발을 시작하기 전, 계획이나 디자인에 대해 논의할 때

핵심 기능: AI 가 당신에게 집요하게 질문을 던져서 모든 결정 트리를 해결합니다. "무엇을 만들고 싶은가요?"로 시작해서 "그 기능의 엣지 케이스는 무엇인가요?"까지 모든 경우를 따집니다.

사용 예시:

2. /grill-with-docs - 문서화와 함께 그릴링

사용 시기: 기존 도메인 모델과 맞춰야 할 때, 용어를 명확히 하고 싶을 때

/grill-me의 업그레이드 버전으로, CONTEXT.md와 ADR (Architecture Decision Record) 를 자동으로 업데이트합니다.

실제 사례: "There's a problem when a lesson inside a section of a course is made 'real'" → "There's a problem with the materialization cascade"

공유 언어를 사용하면 에이전트가 더 간결하게 소통하고, 토큰 사용량을 줄이며, 코드베이스 탐색이 쉬워집니다.

3. /tdd - 테스트 주도 개발

사용 시기: 새로운 기능 추가, 버그 수정, 회귀 테스트 작성

Red-Green-Refactor 루프를 강제하는 TDD 스킬입니다:

단계	설명	결과
Red	실패하는 테스트 먼저 작성	❌ 테스트 실패
Green	테스트를 통과하는 최소한의 코드 작성	✅ 테스트 통과
Refactor	코드 정리 (동작 유지)	✨ 깔끔한 코드

4. /diagnose - 디버깅 루프

사용 시기: 어려운 버그, 성능 저하, 이해하기 힘든 문제

체계적인 디버깅 루프를 따릅니다:

1. Reproduce: 문제를 재현하는 방법 찾기
2. Minimize: 최소 재현 사례 만들기
3. Hypothesize: 가설 수립
4. Instrument: 로깅/디버깅 도구 추가
5. Fix: 수정 적용
6. Regression-test: 재발 방지 테스트 작성

5. /triage - 이슈 분류

사용 시기: GitHub Issues 나 Linear 티켓을 정리할 때

상태 머신을 통해 이슈를 자동으로 분류합니다:

/triage

AI: "새로운 이슈를 확인했습니다:
- 제목: '로그인 시 500 에러'
- 라벨: bug, high-priority
- 담당자: unassigned

이 이슈를 triage 하겠습니다:
1. 재현 가능한지 확인
2. 심각도 평가
3. 적절한 라벨 할당
4. 담당자 지정 제안"

6. /improve-codebase-architecture - 아키텍처 개선

사용 시기: 코드베이스가 Ball of Mud 가 되어갈 때 (며칠에 한 번 실행)

AI 코딩으로 인한 소프트웨어 엔트로피를 해결합니다. CONTEXT.md의 도메인 언어와 docs/adr/의 결정 사항을 참고하여 개선 기회를 찾습니다.

주의: 이 스킬은 며칠에 한 번 실행하는 것을 추천합니다. 너무 자주 실행하면 과도한 리팩토링이 발생할 수 있습니다.

7. /zoom-out - 시스템 전체 관점

사용 시기: 낯선 섹션의 코드를 이해할 때

에이전트에게 코드베이스 전체 시스템의 맥락에서 설명을 요청합니다:

/zoom-out

사용자: "이 authentication 모듈이 어떻게 작동하나요?"
AI: "전체 시스템 관점에서 설명드리겠습니다:

1. 이 모듈은 사용자 인증을 담당합니다
2. JWT 토큰을 생성/검증합니다
3. 다른 모듈과의 관계:
   - User Module: 사용자 데이터 조회
   - Session Module: 세션 관리
   - API Gateway: 인증 미들웨어"

📊 다른 AI 스킬과 비교

Matt Pocock Skills 를 다른 인기 AI 스킬과 비교해 보겠습니다.

기능	Matt Pocock	Claude Skills	Cursor Rules
에이전트 호환성	모든 에이전트	Claude 전용	Cursor 전용
스킬 수	70+	커뮤니티 제작	커뮤니티 제작
문서화 통합	✅ CONTEXT.md, ADR	제한적	제한적
TDD 지원	✅ 완전 지원	부분 지원	부분 지원
설치 시간	30 초	5 분	5 분
가격	무료 (오픈소스)	무료	무료

🔧 실제 프로젝트에 적용하기

실제 프로젝트에서 Matt Pocock Skills 를 어떻게 활용할지 시나리오별로 알아보겠습니다.

시나리오 1: 새로운 기능 개발

# 1. 요구사항 명확화
/grill-me

# 2. 문서화 while 개발
/grill-with-docs

# 3. TDD 로 구현
/tdd

# 4. 전체 시스템 관점에서 검토
/zoom-out

시나리오 2: 어려운 버그 디버깅

# 1. 체계적인 디버깅
/diagnose

# 2. 버그 수정 후 테스트 추가
/tdd

# 3. 재발 방지 테스트 작성
/tdd (regression test)

시나리오 3: 코드베이스 정리

# 1. 현재 상태 파악
/zoom-out

# 2. 아키텍처 개선 기회 발견
/improve-codebase-architecture

# 3. 우선순위 정해서 리팩토링
/tdd (리팩토링용 테스트 작성)

❓ 자주 묻는 질문 (FAQ)

Q1. 모든 AI 에이전트에서 작동하나요?

네! Matt Pocock Skills 는 에이전트에 독립적으로 설계되었습니다. Claude Code, Cursor, Codex, Windsurf 등 어떤 AI 코딩 에이전트에서도 작동합니다. 스킬은 마크다운 파일일 뿐이기 때문에 호환성 문제가 없습니다.

Q2. 유료인가요?

완전 무료입니다. 오픈소스 (MIT 라이선스) 로 공개되어 있으며, GitHub 에서 자유롭게 포크하고 수정할 수 있습니다.

Q3. 얼마나 자주 업데이트되나요?

Matt Pocock 이 직접 관리하며, 새로운 스킬이 추가되거나 기존 스킬이 개선됩니다. 뉴스레터 (60,000 명 구독) 를 통해 업데이트 소식을 받을 수 있습니다.

Q4. 직접 스킬을 만들 수 있나요?

네! /write-a-skill 스킬을 사용하면 새로운 스킬을 쉽게 만들 수 있습니다. 적절한 구조, 점진적 공개, 번들 리소스를 포함한 올바른 스킬을 생성합니다.

Q5. 초보자에게도 적합한가요?

네, 하지만 기본적인 소프트웨어 엔지니어링 지식은 필요합니다. TDD, ADR, 도메인 주도 설계 같은 개념을 알면 더 효과적으로 사용할 수 있습니다. 모르는 개념이 있다면 AI 에이전트에게 설명을 요청하세요.

🎯 맺음말

지금까지 Matt Pocock Skills 에 대해 알아보았습니다. Matt Pocock Skills 는 Claude Code, Cursor, Codex 등 어떤 AI 코딩 에이전트에서도 작동하는 오픈소스 스킬 모음입니다. 특히 /grill-me, /grill-with-docs, /tdd 스킬은 요구사항 명확화, 문서화, 테스트 주도 개발을 통해 코드 품질을 크게 향상시켜 줍니다.

다만 이 스킬들은 기본적인 소프트웨어 엔지니어링 지식을 가정하므로, TDD 나 도메인 주도 설계 같은 개념에 익숙하지 않다면 AI 에이전트에게 설명을 요청하면서 사용하는 것이 좋습니다.

 

여러분도 한번 GitHub 에서 Matt Pocock Skills 를 설치하고 30 초 설정으로 AI 코딩 에이전트의 생산성을 높여보시길 추천드리면서 저는 다음 시간에 더 유익한 정보를 가지고 다시 찾아뵙겠습니다. 감사합니다.

https://fornewchallenge.tistory.com/

 

 

---

📚 참고 문헌 및 출처

• Matt Pocock. (2025-2026). Skills For Real Engineers. Retrieved from https://github.com/mattpocock/skills
• Total TypeScript. (2026). Skills Newsletter. Retrieved from https://www.aihero.dev/s/skills-newsletter
• David Thomas & Andrew Hunt. The Pragmatic Programmer. Retrieved from Amazon
• Eric Evans. Domain-Driven Design. Retrieved from Amazon
• Kent Beck. Extreme Programming Explained. Retrieved from Amazon
• John Ousterhout. A Philosophy Of Software Design. Retrieved from Amazon