AI 에이전트 협업의 완성: 요구사항 정렬부터 TDD와 설계까지

mattpocock/skills는 일상적인 소프트웨어 개발 작업을 돕는 에이전트 스킬을 모아둔 공개 GitHub 저장소입니다. 여기서 스킬이란 에이전트가 불러와 따르는 SKILL.md 파일을 가리킵니다. 이 저장소는 전체 184개 파일 중 39개의 SKILL.md 파일을 담고 있습니다. 2026년 2월 3일 GitHub에 처음 생성되었으며, 가장 최근 푸시는 2026년 11월 11일에 이루어졌습니다. 라이선스는 MIT로, 저작권 고지만 유지하면 자유롭게 사용, 복제, 수정, 배포할 수 있습니다.

GitHub 기준 스타 수는 322,007개로, 322,007개 계정이 이 저장소를 북마크했습니다. 포크 수는 27,000개로 다른 계정 아래 27,000개의 복사본이 존재합니다. 미해결 이슈(Open Issue)는 236개로, 아직 닫히지 않은 트래커 항목 236개가 남아 있습니다.

각 스킬은 가볍고 수정하기 쉬우며 유연하게 조합할 수 있습니다. README에 따르면 특정 모델에 얽매이지 않고 어디서나 동작합니다. 또한 개발 프로세스 전체를 독점하려 들지 않습니다. README에서는 프로세스를 통제하고 주도권을 빼앗아가려는 GSD, BMAD, Spec-Kit과 이 스킬셋을 대비하여 설명합니다.

어떤 역할을 하는가

README에서는 이 스킬들이 줄이고자 하는 네 가지 문제를 꼽습니다.

첫 번째는 요구사항 불일치(Misalignment)입니다. 사용자는 한 가지 결과를 기대했는데 에이전트가 엉뚱한 결과물을 내놓는 경우입니다. 해결책은 집중 질문(grilling) 세션입니다. 에이전트가 작업을 시작하기 전에 세부적인 질문을 던져 요구사항을 맞춥니다. 코드가 아닌 일반 작업에는 /grill-me를 쓰고, 코드 작업에는 문서 작성까지 함께 수행하는 /grill-with-docs를 씁니다.

두 번째는 장황한 설명(Too many words)입니다. 프로젝트 전용 용어가 없으면 에이전트는 하나의 개념을 표현하기 위해 긴 문장을 늘어놓습니다. 해결책은 공통 언어(Shared language)를 구축하는 것입니다. /grill-with-docs는 핵심 용어를 GLOSSARY.md에 기록하고, 중요한 결정 사항을 아키텍처 결정 기록(ADR)으로 남깁니다. README에 나오는 course-video-manager 예시를 보면, 강의 내용을 파일 시스템에 실제 파일로 생성하는 긴 설명 대신 'materialization cascade(구체화 연쇄)'라는 짧은 명칭을 붙여 소통합니다.

세 번째는 제대로 동작하지 않는 코드입니다. 목표를 공유했더라도 에이전트가 코드의 실제 동작을 확인하지 못하면 실패합니다. 해결책은 정적 타입 검사, 브라우저 접근, 자동화 테스트를 통한 피드백입니다. /tdd는 '실패하는 테스트 작성 -> 테스트를 통과할 때까지 코드 수정 -> 테스트 통과를 유지하며 리팩터링'으로 이어지는 레드-그린-리팩터(Red-Green-Refactor) 방식을 따릅니다. /diagnosing-bugs는 한 번에 한 단계씩 버그를 추적하며, 이전 단계를 끝내야 다음 단계로 넘어갑니다.

네 번째는 수정하기 어려운 코드베이스입니다. 코드 작성 속도가 빨라지면 설계의 무질서도가 높아질 수 있습니다. 해결책은 일상 작업 중에 꾸준히 설계를 점검하는 것입니다. /to-spec은 사양서를 작성하기 전에 변경 사항이 어떤 모듈에 영향을 미치는지 묻습니다. README에서는 단순한 인터페이스 뒤에 풍부한 동작을 담은 구조를 '깊은 모듈(deep module)'로 설명합니다. /improve-codebase-architecture는 이러한 구조로 개선할 후보들을 HTML 리포트로 정리한 뒤, 사용자가 선택한 항목을 집중 질의합니다. 단, 코드베이스를 직접 뜯어고치지는 않습니다.

동작 방식

사용자 호출 스킬(user-invoked skill)은 사용자가 직접 입력해야만 실행되며, 전체 흐름을 조율(orchestrate)합니다. 모델 호출 스킬(model-invoked skill)은 사용자가 직접 입력할 수도 있고 작업 상황에 맞춰 에이전트가 스스로 선택할 수도 있으며, 반복 적용할 수 있는 규칙을 담고 있습니다. 사용자 호출 스킬은 모델 호출 스킬을 부를 수 있지만, 또 다른 사용자 호출 스킬을 연속해서 부를 수는 없습니다.

초기 설정을 마치면 /grill-with-docs가 변경 사항을 면밀히 질문하고 용어집과 ADR을 업데이트합니다. /to-spec은 추가 질문 없이 앞선 대화를 바탕으로 사양서를 발행합니다. /to-tickets는 먼저 완료해야 할 작업의 우선순위를 정해 로컬 텍스트나 트래커의 의존성 링크 형태로 티켓을 나눕니다. /implement는 이 티켓들을 구현하면서 합의된 지점에서 /tdd를 실행하고, 커밋하기 전에 /code-review를 거칩니다.

설치 및 첫 실행

에이전트당 하나의 설치 경로만 선택해야 합니다. 플러그인은 자동으로 업데이트됩니다. 반면 skills.sh 복사본은 프로젝트 내에서 직접 수정할 수 있지만 수동으로 업데이트해야 합니다. 두 방식을 함께 쓰면 프로젝트 안에 모든 스킬이 중복으로 들어갑니다.

claude plugin install mattpocock-skills@claude-plugins-official
codex plugin marketplace add mattpocock/skills
codex plugin add mattpocock-skills@mattpocock
copilot plugin marketplace add mattpocock/skills
copilot plugin install mattpocock-skills@mattpocock
gemini skills install https://github.com/mattpocock/skills.git --path skills/engineering
gemini skills install https://github.com/mattpocock/skills.git --path skills/productivity
npx skills@latest add mattpocock/skills -a <agent>

Claude Code는 기본적으로 플러그인을 자동 업데이트합니다. Codex는 시작할 때 업데이트합니다. Copilot의 경우 ~/.copilot/settings.json에서 mattpocock/skills GitHub 마켓플레이스의 autoUpdate 항목을 true로 설정합니다. VS Code에서는 'Chat: Install Plugin From Source'를 실행하고 https://github.com/mattpocock/skills를 입력하면 되며, 매일 자동으로 업데이트됩니다. Gemini는 자체 업데이트를 지원하지 않으므로 두 gemini 명령어를 다시 실행해야 합니다. 다른 에이전트의 경우 -a 옵션에 cursor, opencode, devin, windsurf, amp, pi 등을 지정할 수 있고, -a를 생략하면 설치 도구가 직접 묻습니다. 가져올 스킬을 고를 때는 setup-matt-pocock-skills를 꼭 포함해야 합니다. 업데이트할 때는 npx skills@latest update를 실행한 다음, 새로 추가된 스킬이 있다면 add를 다시 실행합니다.

사용 방법

/setup-matt-pocock-skills

이슈 트래커 종류, 트리아지 라벨, 새 문서를 저장할 폴더 위치를 묻습니다.

/grill-with-docs

세부적인 질문을 던진 뒤 해당 세션에서 GLOSSARY.md와 ADR 문서를 업데이트합니다.

/tdd

구현 코드를 고치기 전에 에이전트가 실패하는 테스트를 먼저 작성하도록 유도합니다.

내부 구조

최상위 디렉터리 항목은 .agents, .changeset, .claude-plugin, .github, .gitignore, .out-of-scope, AGENTS.md, CHANGELOG.md, CLAUDE.md, CONTRIBUTING.md, GLOSSARY.md, LICENSE, README.md, SCOPE.md, docs, package-lock.json, package.json, scripts, skills입니다. 전체 184개 파일로 이루어진 트리 구조 안에서 39개의 SKILL.md 파일이 스킬의 세부 동작을 정의합니다.

README에 언급된 사용자 호출 엔지니어링 스킬로는 ask-matt, grill-with-docs, triage, improve-codebase-architecture, setup-matt-pocock-skills, to-spec, to-tickets, implement, implement-spec이 있습니다. tdd와 diagnosing-bugs는 테스트와 디버깅 루프를 담당합니다. 다른 엔지니어링 스킬을 쓰기 전에 저장소마다 초기 설정을 한 번씩 실행해야 합니다. 트래커는 GitHub, GitLab, 로컬 파일뿐 아니라 텍스트로 설명할 수 있는 다른 시스템도 지원합니다.

비교

스타 수는 동일한 날짜 기준입니다. 스타 수는 저장소를 저장한 계정 수일 뿐 품질을 직접 나타내지는 않으며, 비교 대상 저장소마다 목적도 서로 다릅니다.

저장소	스타 수	역할
morluto/rea	452,684	에이전트로 앱 동작을 네이티브 바이너리 수준까지 리버스 엔지니어링
mattpocock/skills	322,007	방향 정렬, 공통 언어, 테스트, 설계를 돕는 경량 스킬셋
obra/superpowers	316,290	에이전트 스킬 프레임워크 및 개발 방법론
affaan-m/ECC	301,358	스킬, 메모리, 보안을 아우르는 에이전트 하네스 시스템

이 넷 중에서는 morluto/rea의 스타 수가 가장 많습니다. mattpocock/skills는 리버스 엔지니어링 도구나 거대한 방법론이 아니라, 이미 쓰고 있는 에이전트에 가볍게 얹어 쓰는 스킬 모음입니다. affaan-m/ECC는 스킬, 본능, 메모리, 보안, 리서치 우선 개발(research-first development)을 아우르는 에이전트 하네스 성능 최적화 시스템입니다.

한계점

동일한 에이전트에 플러그인 방식과 skills.sh 복사 방식을 함께 설치하지 마십시오. 모든 스킬이 중복으로 등록됩니다. 플러그인 설치는 자체적으로 업데이트되지만, Gemini와 npx 경로는 명령어를 다시 실행해 주어야 합니다.

이 스킬들은 개발 프로세스 전체를 통제하지 않습니다. /to-spec은 추가 인터뷰를 진행하지 않으므로, 대화가 충분히 무르익지 않았다면 사양서 역시 모호하게 작성됩니다. /improve-codebase-architecture는 설계 개선 후보 목록만 보여줄 뿐 레거시 코드베이스를 알아서 재구성하지 않습니다. 사용자 호출 스킬이 다른 사용자 호출 스킬을 직접 실행할 수도 없으므로, 조율 명령어를 직접 입력하거나 /ask-matt에 다음에 입력할 명령어를 물어봐야 합니다. 설정은 저장소마다 저장되므로 다른 저장소에서 쓰려면 /setup-matt-pocock-skills를 다시 실행해야 합니다.

mattpocock/skills는 개발자가 프로세스의 주도권을 쥔 채로 변경 사항을 검토하고, 용어를 정의하며, 테스트를 먼저 작성하고, 설계를 점검할 수 있도록 돕는 간결하고 수정 가능한 절차들의 모음입니다.

출처: GitHub 저장소 mattpocock/skills, https://github.com/mattpocock/skills