Skills For Real Engineers 완전 가이드: Matt Pocock의 AI Agent 스킬 라이브러리

Skills For Real Engineers란?

한 줄 요약: Skills For Real Engineers(저장소 이름 Matt Pocock Skills)는 Matt Pocock이 실제 엔지니어를 위해 만든 AI Agent 스킬 라이브러리로, Matt Pocock이 일상적으로 사용하는 .claude 디렉터리 관행에서 비롯되었습니다.

그 정체성은 분명합니다. vibe coding을 위한 장난감이 아니라 '실제로 엔지니어링을 하는' 일상 도구함입니다. 저자는 이 스킬들이 Claude Code, Codex 등 코딩 Agent에서 반복해서 마주친 흔한 실패 패턴을 고치기 위해 만들어졌다고 말합니다.

GSD, BMAD과의 차이

GSD, BMAD, Spec-Kit 같은 방식은 '프로세스를接管'하려고 합니다. 그런데 그렇게 하는 순간 통제권도 함께 빼앗기고, 프로세스에 문제가 생기면 원인을 찾기 어려워집니다. Skills For Real Engineers는 정반대 방향을 택합니다.

• 작고 가벼움: 각 스킬이 독립적으로 사용 가능하며, 거대한 통합 프레임워크를 지향하지 않습니다.
• 조합 가능: 필요에 따라 골라 쓰고 자유롭게 다듬어 자신의 저장소에 맞출 수 있습니다.
• hack 가능: 스킬은 곧 저장소 안의 평범한 파일이므로, 이해가 안 되면 고치면 됩니다.
• 모델 무관: 특정 모델에 묶이지 않으며 Claude, Codex, Cursor 등 어디서든 쓸 수 있습니다.
• 엔지니어링 기반: 《The Pragmatic Programmer》《Domain-Driven Design》 같은 고전 엔지니어링 원칙에 기반을 두며, prompt 테크닉을 쌓는 방식이 아닙니다.

제품 포지셔닝

실제 엔지니어링 습관을 가진 개발자를 대상으로 합니다. 정적 타이핑, 자동화된 테스트, 레드-그린 리팩터링 같은 실제 피드백으로 Agent를约束해 '맹목적 비행'을 막는 것이 목적입니다. 이 스킬 라이브러리는 호스팅 서비스를 제공하지도, 아키텍처를 대신 결정해 주지도 않습니다. 재사용 가능한 대화·프로세스 인터페이스만 제공할 뿐입니다.

핵심 기능

스킬은 슬래시 명령 형태로 Agent에 제공되며, 크게 몇 가지 그룹으로 나뉩니다.

요구사항 정렬

• /grill-me: 강도 높은 질문 세션을 통해 코딩 전에 요구사항과 결정 분기를 완전히 정렬합니다. 비코딩 시나리오에서도 쓸 수 있습니다.
• /grill-with-docs: grilling에 더해 프로젝트 공유 언어와 아키텍처 결정 기록(ADR)을 함께 만듭니다.
• /zoom-out: Agent가 국소 코드를 벗어나 시스템 전체 관점에서 설명하도록 요구합니다.

개발과 검증

• /tdd: Agent가 레드-그린 리팩터링 루프를 수행하도록 이끌며, 기능을 구축하거나 결함을 고칠 때 수직 슬라이스(vertical slice) 단위로 한 번에 하나씩 진행합니다.
• /diagnose: 체계화된 진단 루프 — 재현→최소화→가설→계측→수정→회귀 테스트.
• /prototype: 실행 가능한 터미널 프로토타입이나 여러 UI 변형을 빠르게 만들어 설계를 검증합니다.

작업과 계획

• /triage: 상태 머신 기반으로 Issue를 단계별로 분류·배정하며, 사용자 정의 라벨 어휘를 지원합니다.
• /to-prd: 현재 대화 맥락을 자동으로 종합해 PRD로 만들고 GitHub Issue로 제출합니다.
• /to-issues: 계획이나 PRD를 독립적으로 맡을 수 있는 수직 슬라이스 작업으로 분해합니다.

아키텍처와 협업

• /improve-codebase-architecture: CONTEXT.md와 ADR을 근거로 모듈 심화 기회를 찾아내고, 아키텍처 볼(architecture ball)을 정리합니다.
• /caveman: 통신 모드를 극도로 압축해 기술적 정밀도를 유지하면서 약 75%의 token 소모를 줄입니다.
• /handoff: 현재 세션을 인수인계 문서로 압축해 다른 Agent가 끊김 없이 이어서 작업하게 합니다.
• /teach: 현재 디렉터리를 상태가 유지되는 교육 공간으로 삼아, 여러 세션에 걸쳐 새로운 스킬이나 개념을 가르칩니다.
• /write-a-skill: 규격화된 구조로 새 스킬을 만들며, 점진적 공개와 리소스 패키징을 지원합니다.

공유 언어 메커니즘

CONTEXT.md로 프로젝트 용어 체계를 세우는 것은 이 스킬 모음에서 저자가 가장 높이 평가하는 기법입니다. 저자가 관찰한 현상은 이렇습니다. Agent는 보통 프로젝트에 그냥 투입되어 전문 용어(jargon)를 작업하면서 추측해야 하므로, 원래 한 단어면 충분한 일을 스무 단어로 풀어냅니다.

예를 들어 '어떤 코스의 한 section 안에 있는 lesson이 made real(파일 시스템에 자리를 얻는 것)이 되는 문제'를 'materialization cascade에 문제가 있다'로 바꾸면 한 문장으로 설명 비용을 크게 줄일 수 있고, 이런 간결함은 세션이 거듭될수록 복리로 쌓입니다. 공유 언어는 또 다음을 가져옵니다: 변수·함수·파일 이름이 공유 언어로 일관되게 지어지고, 에이전트가 코드베이스를 더 쉽게 탐색할 수 있으며, 에이전트가 생각할 때 쓰는 token도 줄어듭니다.

Skills For Real Engineers 사용법

두 가지 진입 경로가 있고, 두 가지 철학이 대응됩니다. 둘 중 하나만 선택해야 합니다.

경로 1: Claude Code 플러그인

• 전체 스킬이 관리되는 읽기 전용 번들로 설치됩니다. 저자가 새 버전을 배포하면 자동으로 업데이트되므로, fork가 아니라 '구독'에 가깝습니다.
• Claude Code 공식 마켓플레이스에 이미 등록되어 있어 소스를 먼저 추가할 필요 없이 업데이트가 자동으로 도착합니다.
• 네이티브 Codex 플러그인은 로드맵에 있습니다(.agents/adr/0002-ship-as-a-claude-code-plugin.md 참고).

경로 2: skills 설치기

npx skills@latest add mattpocock/skills를 실행하고 대상 Agent를 선택한 뒤 /setup-matt-pocock-skills를 체크합니다. 설치기가 어떤 스킬을 가져갈지, 어떤 코딩 Agent에 설치할지를 직접 고르게 해 줍니다. 스킬은 저장소에 일반 파일로 기록되어 당신이 소유하고 편집할 수 있으며, 뒤에서 자동으로 업데이트되지 않습니다. 필요할 때 npx skills update로 최신 변경분을 당겨오면 됩니다.

주의: 두 경로를 동시에 설치하면 모든 스킬이 두 벌씩 생깁니다.

초기화와 일상 리듬

1. Agent에서 /setup-matt-pocock-skills를 저장소당 한 번 실행합니다. 어떤 Issue 추적기를 쓸지(GitHub, Linear 또는 로컬 파일), triage 할 때 어떤 라벨을 붙일지(/triage가 이 라벨을 사용합니다), 생성된 문서를 어느 디렉터리에 저장할지를 묻습니다.
2. 변경 전마다 /grill-me 또는 /grill-with-docs로 요구사항을 정렬합니다.
3. 개발 중에는 /tdd로 품질을 보장합니다.
4. 버그를 만나면 /diagnose로 체계적 진단을 시작합니다.
5. 아키텍처 유지보수는 /improve-codebase-architecture를 정기적으로 실행해 코드 부패를 막습니다.

설치와 구성은 약 30초면 끝나며, GitHub, Linear 또는 로컬 파일을 Issue 추적기로 지원합니다.

활용 시나리오

• 요구사항 정렬과 계획: 프로젝트를 시작하거나 기능을 변경하기 전에 /grill-me 또는 /grill-with-docs로 Agent와 강도 높은 질문을 주고받아 요구사항·결정 분기·도메인 용어가 완전히 일치하는지 확인합니다.
• 테스트 주도 개발: 코드 품질이 중요한 상황에서 /tdd로 Agent가 레드-그린 리팩터링 루프를 수행하게 하고, 수직 슬라이스로 기능을 구축하거나 결함을 고치며 모든 변경에 자동화 테스트가 함께하도록 합니다.
• 복잡한 버그 진단: 재현이 어려운 성능 회귀나 논리 결함을 만났을 때 /diagnose로 체계화된 진단 루프(재현→최소화→가설→계측→수정→회귀 테스트)를 가동합니다.
• 아키텍처 지속 관리: 크고 오래 유지되는 코드베이스에서 /improve-codebase-architecture를 정기적으로 실행해 CONTEXT.md와 ADR을 바탕으로 모듈 심화 기회를 찾고, Agent가 코드 부패를 가속하지 않도록 유지보수성을 지킵니다.
• 세션 간 협업: /handoff로 세션을 압축하고 /caveman로 token 소모를 줄여, 긴 작업과 여러 사람·여러 Agent가 이어받는 작업에 적합합니다.

장점

• 가볍고 조합 가능: 무거운 프레임워크를 거부하고, 각 스킬이 독립적으로 쓰이며 자유롭게 다듬어 맞출 수 있습니다.
• 모델 무관: Claude, Codex, Cursor 등 어디서든 사용할 수 있습니다.
• 엔지니어링 기반: prompt 테크닉이 아니라 고전 엔지니어링 원칙 위에 세워졌습니다.
• 공유 언어 메커니즘: CONTEXT.md가 Agent 간 커뮤니케이션 비용과 token 소모를 크게 줄여 줍니다.
• 피드백 루프: 정적 타이핑, 자동화 테스트, 레드-그린 리팩터링 같은 실제 피드백을 강조합니다.
• 개조 용이성: skills 경로를 쓰면 스킬이 곧 저장소 안의 편집 가능한 파일입니다.

한계

• 이 스킬들은 end-to-end 프로세스 관리자가 아닙니다. 공유 언어나 ADR 규율이 없는 팀은 CONTEXT.md와 결정 기록을 스스로 관리해야 합니다.
• /triage의 라벨 체계는 초기화 설정에 의존하므로, 설정이 잘못되면 분류 효과가 떨어질 수 있습니다.
• 두 설치 경로는 상호 배타적입니다. 같이 설치하면 스킬이 중복됩니다.
• 네이티브 Codex 플러그인은 아직 로드맵 단계이며, Codex 사용자는 현재 스킬 파일 설치 경로를 이용해야 합니다.
• 구체적인 지원 범위, 명령 세부 사항, 업데이트 주기는 달라질 수 있습니다.

가격·이용 가능 여부 검증 안내

이번 사실 테이블에는 가격, 구독 비용, 라이선스 조건 정보가 포함되어 있지 않으므로 추측하지 않습니다. 유료 여부, 라이선스 방식, 사용 가능한 설치 채널, 최신 버전 상태는 제품 공식 사이트 https://github.com/mattpocock/skills%EC%99%80 사용 중인 Agent의 공식 플러그인 마켓페이지에서 직접 확인한 뒤 결정하세요.

자주 묻는 질문(FAQ)

특정 모델에 묶이나요?

아닙니다. 공식 표현은 모델 무관이며 Claude, Codex, Cursor 등 어디서든 사용할 수 있습니다.

설치하면 바로 쓸 수 있나요?

초기화가 필요합니다. Agent에서 /setup-matt-pocock-skills를 한 번 실행해 Issue 추적기, 분류 라벨, 문서 디렉터리를 구성한 뒤에야 /triage 같은 스킬이 정상적으로 작동합니다.

플러그인과 설치기 중 무엇을 골라야 하나요?

저자의 업데이트를 따라가고 관리되는 읽기 전용 번들을 원하면 Claude Code 플러그인을 선택하세요. 파일을 소유하고 개조하며 업데이트 시점을 직접 통제하려면 npx skills@latest add mattpocock/skills를 쓰세요. 둘을 동시에 설치하지 마세요.

GSD, BMAD과 충돌하나요?

저자의 설계 의도는 대안을 제공하는 것입니다. GSD, BMAD, Spec-Kit은 프로세스를接管해서 도움을 주는 대신 통제권을 가져가고 프로세스 내부의 문제를 해결하기 어렵게 만듭니다. 이 스킬 모음은 작고 가볍고, 조합 가능하며, hack 가능한 방식을 택합니다. 혼용 여부는 팀의 규율에 달렸습니다.

가장 먼저 써 볼 만한 스킬은 무엇인가요?

저자는 /grill-with-docs가 이 저장소 전체에서 가장 강력한 기법일 수 있다고 봅니다. 강도 높은 질문 세션이면서, AI와 공유 언어를 함께 만들고 설명하기 어려운 결정을 ADR로 기록해 주기 때문입니다.

대안

• GSD, BMAD, Spec-Kit: 개발 프로세스를接管하려는 무거운 프레임워크. 통제권이 줄고 프로세스 문제를 추적하기 어렵습니다.
• 一泽 Eze가 오픈소스로 공개한 Agent Skill: '인터넷 검색 방법'에 초점을 둔 스킬입니다.
• Jesse Vincent이 오픈소스로 공개한 Agentic 스킬 프레임워크 겸 소프트웨어 개발 방법론 플러그인.
• AI 코딩 어시스턴트 전용으로 설계된 오픈소스 AI 디자인 Skill.
• 일반적 접근: 팀 습관에 맞춰 직접 .claude 또는 프로젝트 스킬 파일을 유지·조립합니다.

원자료

• 제품 공식 사이트·저장소: https://github.com/mattpocock/skills

이 스킬들의 변경 사항과 저자가 새로 만드는 스킬을 따라잡고 싶다면, 약 60,000명의 개발자가 구독 중인 뉴스레터에 가입할 수 있습니다.