Skills For Real Engineers: Matt Pocock이 정리한, 실전 엔지니어링을 위한 Claude Code 스킬 모음

9bow · 6월 12, 2026, 11:30오전

Skills For Real Engineers 소개

Skills For Real Engineers(이하 skills)는 Total TypeScript와 ai-hero.dev로 잘 알려진 매트 포코크(Matt Pocock)가 자신의 ~/.claude 디렉토리에서 매일 사용하는 에이전트 스킬(Agent Skill)을 그대로 공개한 오픈소스 프로젝트입니다. 이 저장소는 "Vibe Coding"이 아닌 "실전 엔지니어링(Real Engineering)"을 코딩 에이전트와 함께 수행하기 위한 작은 단위의 스킬들을 모아 두었습니다. 게시 시점에 이미 75,000개가 넘는 GitHub 스타가 모일 정도로 빠르게 확산되며, 매트 포코크가 운영하는 6만 명 이상의 뉴스레터 구독자층과 함께 Claude Code, Codex 등 다양한 코딩 에이전트 사용자의 표준 워크플로우 후보로 자리잡고 있습니다.

이 프로젝트가 흥미로운 이유는 GSD(Get Shit Done), BMAD, Spec-Kit 같이 프로세스 전체를 통째로 가져가는 거대한 프레임워크와 달리, 각 스킬이 "작고(small)", "수정하기 쉽고(easy to adapt)", "조합 가능한(composable)" 단위라는 점입니다. 한 스킬이 한 가지 실패 모드(failure mode)에 대응하도록 설계되어 있기 때문에, 사용자는 필요한 스킬만 골라서 자신의 저장소에 설치하고 원하는 대로 손볼 수 있습니다. 모델 종속성이 없어 Claude Code 외에 다른 코딩 에이전트와도 함께 쓸 수 있는 점도 장점입니다.

매트 포코크는 이 스킬들이 "코딩 에이전트가 흔히 보이는 실패 모드"를 해결하기 위한 시도라고 설명합니다. 에이전트가 사용자의 의도를 잘못 이해하거나(misalignment), 지나치게 장황한 결과물을 내놓거나(verbose), 동작하지 않는 코드를 만들거나(broken), 점점 누더기처럼 변해가는(ball of mud) 네 가지 문제를 각각 다른 스킬로 다루며, 이를 위해 도메인 주도 설계(DDD), 테스트 주도 개발(TDD), 진단 루프(Diagnosis Loop) 같은 소프트웨어 공학 고전들을 에이전트가 따라 할 수 있는 형태로 정리해 두었습니다.

Skills For Real Engineers가 해결하는 4가지 실패 모드

매트 포코크는 README에서 이 스킬 모음을 만들게 된 동기를 다음 4가지 실패 모드로 정리합니다. 각 항목은 그가 Claude Code, Codex 같은 코딩 에이전트를 사용하면서 반복적으로 마주친 문제와, 이를 줄이기 위해 도입한 스킬을 연결해 보여 줍니다.

1) 에이전트가 내가 원하는 것을 하지 않는다(Misalignment): 가장 흔한 실패 모드는 의사소통의 격차입니다. 사용자는 자신이 무엇을 원하는지 정확히 모르고, 에이전트는 이를 추측해서 결과물을 만듭니다. 이를 메우기 위해 매트 포코크는 "그릴링 세션(Grilling Session)" 개념을 도입했고, /grill-me와 /grill-with-docs 스킬을 통해 에이전트가 작업 시작 전에 사용자에게 끈질기게 질문하며 의도를 정렬하도록 만듭니다.

2) 에이전트가 너무 장황하다(Verbosity): 도메인 전문가와 개발자가 다른 언어를 쓰는 것처럼, 에이전트는 프로젝트의 전문 용어를 처음부터 추측하며 1단어로 충분한 자리에 20단어를 씁니다. 이를 줄이기 위해 매트 포코크는 CONTEXT.md라는 공유 언어 문서를 만드는 워크플로우를 제안합니다. 예를 들어 "강의 섹션 안의 레슨이 실제 파일 시스템에 자리잡는 시점의 문제"라고 풀어 쓰는 대신, 한 번 약속해 둔 "materialization cascade"라는 짧은 용어로 부르는 방식입니다. /grill-with-docs가 이 공유 언어를 만들고 ADR(Architecture Decision Record)에 결정을 기록하도록 안내합니다.

3) 코드가 작동하지 않는다(Broken Code): 사용자와 에이전트가 무엇을 만들지 정렬했더라도, 에이전트가 만들어내는 코드가 동작하지 않는 경우가 많습니다. 매트 포코크는 이 문제를 "피드백 루프(feedback loop)"의 부재로 진단하고, 정적 타입, 브라우저 접근, 자동화된 테스트라는 세 가지 피드백 루프를 강조합니다. 특히 /tdd 스킬은 레드-그린-리팩터(red-green-refactor) 사이클을 강제하여 에이전트가 실패하는 테스트부터 먼저 작성하도록 유도하고, /diagnose 스킬은 어려운 버그를 재현(reproduce) → 최소화(minimise) → 가설(hypothesise) → 계기 설치(instrument) → 수정(fix) → 회귀 테스트(regression-test) 순서로 풀도록 합니다.

4) 진흙공 같은 코드베이스가 만들어진다(Ball of Mud): 에이전트가 코딩 속도를 끌어올린 만큼 "소프트웨어 엔트로피(software entropy)"도 빠르게 증가합니다. 매트 포코크는 이를 막기 위해 켄트 벡(Kent Beck), 존 오스터하우트(John Ousterhout) 같은 고전적 소프트웨어 설계 원칙을 다시 끌어옵니다. /to-prd는 PRD를 작성하기 전에 어떤 모듈을 건드릴지 묻고, /zoom-out은 코드를 전체 시스템 맥락에서 설명하도록 시키며, /improve-codebase-architecture는 이미 누더기가 된 코드베이스를 며칠에 한 번씩 정리하는 데 활용합니다.

Skills For Real Engineers의 카테고리별 핵심 스킬

skills 저장소는 모든 스킬을 세 가지 카테고리로 정리합니다. 각 스킬은 skills/<카테고리>/<스킬명>/SKILL.md 파일에 정의되어 있어 코딩 에이전트가 그대로 읽어 들일 수 있습니다.

Engineering 카테고리(코드 작업용 핵심 스킬): 다음 스킬들이 매트 포코크가 매일 사용하는 코드 관련 스킬입니다.

/diagnose: 재현 가능한 버그와 성능 회귀(regression)를 다루는 진단 루프입니다.
/grill-with-docs: 기존 도메인 모델과 비교하며 계획을 다듬고, CONTEXT.md와 ADR을 함께 갱신하는 그릴링 세션입니다.
/triage: 이슈를 상태 머신(state machine)으로 분류하는 트리아지 도구입니다.
/improve-codebase-architecture: 도메인 언어와 ADR을 근거로 코드베이스를 "더 깊고(deep)" 단순하게 다듬는 리팩터링 루프입니다.
/setup-matt-pocock-skills: 이슈 트래커, 트리아지 라벨, 도메인 문서 위치 등 저장소별 설정을 한 번에 구성합니다.
/tdd: 레드-그린-리팩터 사이클을 강제하는 테스트 주도 개발 스킬입니다.
/to-issues: 계획, 스펙, PRD를 독립적으로 잡을 수 있는 수직 슬라이스(vertical slice) 이슈로 분해합니다.
/to-prd: 이미 대화한 내용을 바탕으로 별도 인터뷰 없이 PRD를 GitHub 이슈로 제출합니다.
/zoom-out: 낯선 코드 영역에 대해 더 높은 수준의 맥락을 설명하도록 에이전트를 유도합니다.
/prototype: 한 번 쓰고 버리는 프로토타입을 만들어 상태/비즈니스 로직 또는 UI 변형을 탐색합니다.

Productivity 카테고리(일반 워크플로우 도구): 코드에 한정되지 않는 범용 생산성 스킬입니다. /caveman은 토큰 사용량을 약 75% 줄이는 초압축 커뮤니케이션 모드이고, /grill-me는 비코드 작업에서 결정 트리의 모든 가지를 끝까지 묻는 인터뷰 도구입니다. /handoff는 현재 대화를 다른 에이전트가 이어받을 수 있도록 핸드오프 문서로 압축하고, /write-a-skill은 점진적 개시(progressive disclosure)와 번들 리소스 구조를 갖춘 새 스킬을 만드는 메타 스킬입니다.

Misc 카테고리(가끔 쓰는 보조 스킬): /git-guardrails-claude-code는 push, reset --hard, clean 같은 위험한 git 명령을 Claude Code 훅(hook)으로 사전에 차단하고, /migrate-to-shoehorn은 테스트 파일의 as 타입 단언을 @total-typescript/shoehorn으로 옮기는 마이그레이션 스킬입니다. /scaffold-exercises와 /setup-pre-commit은 각각 강좌용 연습 디렉토리 구조와 Husky 기반 pre-commit 훅 설정을 자동화합니다.

Skills For Real Engineers 설치 및 사용법

설치는 매트 포코크가 함께 공개한 skills.sh 설치 도구를 통해 진행합니다. 사용 중인 에이전트와 저장소에 맞춰 30초 안에 스킬을 설치하고, /setup-matt-pocock-skills로 초기 설정을 마치는 흐름입니다.

# 1) skills.sh 설치 도구로 mattpocock/skills 모음을 추가합니다
npx skills@latest add mattpocock/skills

# 2) 설치 마법사가 띄워 주는 목록에서 사용할 스킬과 대상 에이전트(Claude Code, Codex 등)를 선택합니다.
#    이때 `/setup-matt-pocock-skills` 스킬을 반드시 함께 선택해야 합니다.

# 3) 에이전트(예: Claude Code) 안에서 초기 설정을 실행합니다
/setup-matt-pocock-skills

/setup-matt-pocock-skills는 사용할 이슈 트래커(GitHub, Linear, 로컬 파일 중 선택), 트리아지에 사용할 라벨, 문서를 저장할 디렉토리를 차례대로 묻고 그 결과를 저장소 안의 설정 파일에 기록합니다. 이후 /triage, /to-issues, /to-prd, /diagnose, /tdd, /improve-codebase-architecture, /zoom-out 등이 이 설정을 공유하며 동작합니다.

매트 포코크는 /grill-with-docs를 매번 변경 작업 전에 실행할 것을 강력히 권장합니다. 그릴링 세션이 의도 정렬(intent alignment)과 공유 언어(shared language) 구축, ADR 작성까지 한 번에 처리하기 때문에, 이후 단계인 PRD 작성과 이슈 분해, 구현, 디버깅 모두에서 일관된 도메인 용어와 결정 근거를 활용할 수 있습니다. 이미 누더기가 된 코드베이스에는 며칠에 한 번 /improve-codebase-architecture를 돌려 점진적으로 정리하는 운영 패턴을 제안합니다.

Skills For Real Engineers의 라이선스

이 프로젝트는 MIT 라이선스로 공개되어 있어 개인 및 상업적 목적으로 자유롭게 사용할 수 있으며, 자신의 저장소에 맞게 스킬을 수정·재배포하는 것도 가능합니다. 자세한 조건은 저장소의 LICENSE 파일을 참고해 주세요.

Skills For Real Engineers 홈페이지

Skills For Real Engineers 프로젝트 GitHub 저장소

Skills For Real Engineers 뉴스레터

더 읽어보기

이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다.

파이토치 한국 사용자 모임이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일로 보내드립니다!
텔레그램(Telegram)이나 Slack/Discord/Teams/Dooray/GoogleChat 등으로도 새 글 알림을 받으실 수 있습니다.

아래쪽에 좋아요를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~