Claude Code 'Grill Me' 스킬 완전 가이드 - 설치부터 grill-with-docs 활용까지

Matt Pcock(https://github.com/mattpocock)

 

Claude Code로 작업하다 보면 "AI가 내 계획의 약점을 찾아줬으면" 하는 순간이 있습니다. 코드를 쓰기 전에 설계를 검증하고 싶은데, 스스로 맹점을 찾기는 어렵죠. Matt Pocock이 공개한 Grill Me 스킬은 바로 그 역할을 합니다. 단순한 QA 도구를 넘어, 결정 트리의 모든 분기를 철저히 파고드는 인터뷰 도구입니다.

 

출처 : https://www.aihero.dev/my-grill-me-skill-has-gone-viral

 

1. Grill Me 스킬이란?

Grill Me는 TypeScript 교육으로 유명한 Matt Pocock이 개인 Claude Code 환경에서 사용하던 커스텀 스킬을 GitHub에 공개하면서 알려졌습니다. 공식 설명은 간결합니다.

 

"계획이나 설계에 대해 집요하게 인터뷰하여, 결정 트리의 각 분기를 하나씩 해소하면서 공유된 이해에 도달한다."

 

핵심은 한 번에 하나씩 질문하고, 각 질문마다 권장 답변을 함께 제시한다는 점입니다. AI가 단순히 "이 부분은 어떻게 할 건가요?"라고 묻는 게 아니라, "저라면 B 방법을 쓰겠습니다. 이유는 X입니다. 어떻게 생각하세요?"처럼 구체적인 의견을 먼저 냅니다. GitHub 공개 후 빠르게 주목을 받았으며, 개발 외 분야(코스 설계, 비즈니스 플랜)에도 적용한다는 사례가 속속 등장했습니다.

 

2. Matt Pocock Skills 전체 목록

Grill Me는 Matt Pocock의 GitHub 저장소 mattpocock/skills에서 관리되는 20개 스킬 중 하나입니다. 저장소는 Engineering, Productivity, Misc 세 카테고리로 구성됩니다.

 

Engineering 스킬 — 매일 쓰는 개발 작업용:

 

스킬	설명
diagnose	버그·성능 저하를 재현→최소화→가설→수정→회귀테스트 순으로 체계적 진단
grill-with-docs	CONTEXT.md·ADR 기반으로 계획을 도메인 모델에 검증하고 문서 인라인 업데이트
triage	상태 머신을 통해 이슈 분류
improve-codebase-architecture	CONTEXT.md와 ADR 기반으로 코드베이스 구조 개선 기회 발굴
setup-matt-pocock-skills	저장소별 이슈 추적·레이블·문서 레이아웃 초기 설정
tdd	Red-Green-Refactor 루프 기반 테스트 주도 개발
to-issues	계획을 독립적인 GitHub 이슈 단위로 분해
to-prd	현재 대화 내용을 PRD로 변환 후 이슈 제출
zoom-out	코드에 대한 상위 수준 맥락과 아키텍처 관점 제시
prototype	설계 검증을 위한 프로토타입 신속 구축

 

Productivity 스킬 — 코드 외 일반 워크플로우:

 

스킬	설명
grill-me	계획·설계의 결정 항목 전체를 철저히 인터뷰하여 약점 도출
caveman	토큰 사용량 약 75% 절감하는 초압축 소통 모드
handoff	현재 대화를 다른 에이전트가 이어받을 수 있도록 압축 정리
write-a-skill	새로운 스킬을 구조에 맞게 작성하는 도우미

 

Misc 스킬 — 특수 상황용:

 

스킬	설명
git-guardrails-claude-code	위험한 git 명령어를 사전 차단하는 훅 설정
migrate-to-shoehorn	타입 어설션을 @total-typescript/shoehorn으로 일괄 마이그레이션
scaffold-exercises	연습 디렉토리 구조 자동 생성
setup-pre-commit	Husky pre-commit 훅 설정

 

3. grill-me vs grill-with-docs — 무엇이 다른가

두 스킬 모두 계획을 검증한다는 목표는 같지만, 검증 기준이 다릅니다. grill-me는 계획 자체의 논리적 완결성을 검사하고, grill-with-docs는 기존 코드베이스 문서(CONTEXT.md, ADR)와의 정합성을 추가로 검사합니다.

 

항목	grill-me	grill-with-docs
검증 기준	계획의 논리 자체	계획 + 기존 도메인 문서
용어 검증	없음	CONTEXT.md 용어와 충돌 즉시 지적
문서 업데이트	없음	결정 시 CONTEXT.md·ADR 인라인 갱신
엣지 케이스	결정 트리 분기 탐색	구체적 시나리오로 도메인 경계선 검증
추천 대상	새 프로젝트, 초기 설계	기존 코드베이스에 기능 추가 시

 

grill-with-docs의 핵심 원칙: CONTEXT.md는 구현 세부사항 없이 용어집으로만 관리합니다. ADR은 세 조건(변경 비용이 큼 + 미래 독자 설명 필요 + 실제 트레이드오프 존재)을 모두 만족할 때만 생성합니다.

 

4. 설치 및 사용 방법

스킬은 Claude Code의 .claude/skills/ 디렉토리에 SKILL.md 파일로 추가합니다. Matt Pocock의 저장소를 통째로 클론하거나 필요한 스킬만 개별 복사할 수 있습니다.

 

Step 1: 저장소 클론

git clone https://github.com/mattpocock/skills.git

 

Step 2: 원하는 스킬을 프로젝트 디렉토리에 복사

cp -r skills/skills/productivity/grill-me .claude/skills/grill-me

 

Step 3: Claude Code 세션에서 스킬 호출

/grill-me 또는 /grill-with-docs

 

Step 4: Claude가 첫 번째 질문을 던집니다. 계획의 어떤 부분을 검증할지 간단히 설명하면 됩니다.

 

Step 5: 질문-답변을 반복합니다. Claude는 한 번에 하나의 질문과 권장 답변을 제시하며, 모든 결정 분기가 해소될 때까지 계속합니다.

 

5. 실전 활용과 시사점

Matt Pocock이 공개 후 커뮤니티에서 보고된 주요 활용 사례는 세 가지 방향으로 수렴합니다.

 

코딩 전 설계 검증: 새 API 구조나 데이터 모델을 구현하기 전에 grill-me로 잠재적 문제를 사전 발굴합니다. 코드를 짜고 나서 리팩토링하는 것보다 설계 단계에서 약점을 잡는 것이 훨씬 효율적입니다.

 

기존 코드베이스 기능 추가: grill-with-docs를 통해 새 기능이 기존 도메인 언어와 충돌하지 않는지 확인합니다. "account"처럼 과하게 쓰이는 용어가 새 기능에서 다른 의미로 쓰이면 즉시 알림을 받습니다.

 

개발 외 분야 적용: 온라인 코스 커리큘럼 설계, 비즈니스 론칭 계획 등에 활용한다는 사례도 보고됐습니다. 스킬 자체는 소프트웨어 외 맥락에도 충분히 동작합니다.

 

20개 스킬 모두 github.com/mattpocock/skills에서 무료로 확인하고 즉시 사용할 수 있습니다. 코드를 쓰기 전에 설계를 충분히 검증하는 습관이 필요하다면, grill-me 하나만으로도 개발 흐름이 크게 달라집니다.