Skills For Real Engineers — Matt Pocock의 에이전트 스킬 컬렉션 완벽 가이드

Skills For Real Engineers — Matt Pocock의 에이전트 스킬 컬렉션 완벽 가이드

도입: 바이브 코딩이 아니라 진짜 엔지니어링을 위한 스킬

AI 코딩 에이전트가 코드를 대신 작성해주는 시대. 그런데 막상 실무에 투입되면 "이건 아니야" 싶은 결과물이 돌아오는 경험, 누구나 한 번쯤 해봤을 것이다. Matt Pocock은 바로 이 문제 의식에서 출발했다. 그는 TypeScript 교육자로 수만 명에게 TS를 가르친 인물로, 최근 'Skills for Real Engineers'라는 GitHub 저장소를 공개하며 화제를 모으고 있다.

이 저장소는 그가 매일 실제 프로젝트에서 사용하는 에이전트 스킬 컬렉션이다. 2026년 2월 첫 커밋 이후 약 90일 만에 64,600 스타, 5,600 포크를 기록하며 순수 프롬프트 기반 저장소로는 이례적인 성장세를 보이고 있다. 놀라운 건, 가장 많은 스타를 받은 '스킬' 프롬프트라는 점이다.

> "저는 바이브 코딩(vibe coding)이 아닙니다. 실제 엔지니어링(real engineering)을 위한 스킬을 만듭니다."

> — Matt Pocock

왜 기존의 AI 개발 방법은 실패하는가

Matt Pocock은 Claude Code, Codex 등 코딩 에이전트에서 반복적으로 나타나는 4가지 실패 패턴을 정리했다.

실패 패턴 1: 에이전트가 원하는 것을 이해하지 못한다

가장 흔한 문제는 misalignment, 즉 개발자와 에이전트 간의 의사소통 격차다. 인간이 원하는 것을 완벽히 설명하는 것은 불가능에 가깝고, 에이전트는 이를 오묘하게 잘못 해석한다. 전통적인 소프트웨어 공학의 격언인 "아무도 정확히 무엇을 원하는지 모른다"는 이 시대에도 여전하다.

해결책: /grill-me 또는 /grill-with-docs 스킬. 에이전트에게 상세한 질문을 던지게 하여 프로젝트 시작 전 충분히 고민하고|align|하는 과정이다.

실패 패턴 2: 에이전트가 너무 장황하다

도메인 전문가와 개발자가 서로 다른 언어를 쓰는 것처럼, 에이전트도 프로젝트 맥락 없이 지나치게 장황한 설명을 생성한다.

해결책: 공유 언어(Ubiquitous Language) 구축. /grill-with-docs 스킬에 내장된 이 기법은 프로젝트만의 간결한 용어 사전을 만들어, "materialization cascade"처럼 20단어를 3단어로 압축한다. 변수명, 함수명, 파일명이 일관되게명명되므로 에이전트의 토큰 소모도 줄어든다.

실패 패턴 3: 코드가 실제로 동작하지 않는다

대 문제를 해결했더라도, 에이전트가 작성한 코드가 실제로 실행되면 버그가 발생한다. 피드백 루프가 없으면 에이전트는 맹목적으로 코딩한다.

해결책:

• /tdd: 실패하는 테스트를 먼저 작성하는 TDD 사이클을 에이전트에게 알려준다

• /diagnose: 재현 → 최소화 → 가설 → 계측 → 수정 → 회귀 테스트의 절차적 디버깅 루프

실패 패턴 4: 코드베이스가 진흅 공단이 된다

에이전트는 코딩 속도가 빠르지만, 그만큼 엔트로피 증가 속도도 빠르다. Kent Beck의 조언처럼 "매일 설계에 투자해야" 하지만, 에이전트 환경에서는 이를 어떻게 실현해야 할지 막막하다.

해결책:

• /to-prd: 먼저 PRD를 작성하며 어떤 모듈을 건드릴지 점검

• /zoom-out: 전체 시스템 맥락에서 코드 설명

• /improve-codebase-architecture: 이미 복잡해진 코드베이스를 구조적으로 개선

핵심 스킬 레퍼런스

Matt Pocock이 매일 사용하는 엔지니어링 스킬 목록이다.

스킬	기능
/setup-matt-pocock-skills	레포별 설정 (이슈 트래커, 트라이지 라벨, 문서 레이아웃)
/grill-me	비코드 업무용 그릴링 세션
/grill-with-docs	도메인 모델 Challenges + CONTEXT.md/ADR 자동 업데이트
/triage	이슈 트라이지를 위한 상태 머신
/diagnose	버그 및 성능 회귀 분석 루프
/tdd	레드-그린-리팩터 TDD 사이클
/to-issues	계획/스펙을 수직 슬라이스 단위 GitHub 이슈로 분해
/to-prd	대화 맥락을 PRD로 변환해 GitHub 이슈로 제출
/improve-codebase-architecture	코드베이스 아키텍처 개선 기회 발견
/zoom-out	전체 시스템 맥락에서의 코드 설명

30초 퀵스타트

다음 명령어로 설치할 수 있다.

npx skills@latest add mattpocock/skills

에이전트(Claude Code, Cursor 등)를 실행한 뒤 /setup-matt-pocock-skills를 호출하면, 이슈 트래커 선택, 트라이지 라벨 설정, 문서 저장 위치 설정을 마치고 바로 사용할 준비가 된다.

배경 철학: 소프트웨어 공학의 영속성

Matt Pocock의 스킬이 특별한 이유는 단순히 "프롬프트 모음"이 아니라 수십 년의 소프트웨어 공학 경험을 에이전트 시대에 맞게 재해석했다는 점이다.

그의 조언은 이렇다:

> "작은 스텝을 밟으세요. 피드백 비율이 당신의 속도 제한입니다. 너무 큰 작업은 절대 들이기지 마세요."

에이전트가 아무리 강력해져도, 기본기는 변하지 않는다. 다만 그 기본기를 에이전트와 어떻게 공유하느냐가 핵심 과제가 된 것이다.

결론: 에이전트와 협업하는 새 패러다임

Matt Pocock의 Skills for Real Engineers는 "에이전트에게 일을 시키는 방법"에서 "에이전트와 함께 일하는 방법"으로 패러다임을 전환하게 해준다. 바이브 코딩이 아닌, 실제로 동작하는 소프트웨어를 만들기 원한다면 이 저장소는 필수 도구다.

핵심 정리:

• misalignment 해결: /grill-me, /grill-with-docs

• 장황함 해결: 공유 언어(ubiquitous language) + CONTEXT.md

• 품질 문제: /tdd, /diagnose

• 아키텍처 관리: /improve-codebase-architecture, /zoom-out

---

tags: AI,Coding Agent,Claude Code,Matt Pocock,Software Engineering,Developer Tools,TDD,Engineering Skills

📚 출처

• https://github.com/mattpocock/skills

---

📚 출처

• https://news.hada.io/topic?id=29259