Claude Code나 Codex가 요구사항을 잘못 이해하거나 테스트와 설계 검토를 건너뛰는 일을 반복한다면, mattpocock/skills로 필요한 작업 절차를 골라 보완할 수 있습니다. 질문으로 요구사항을 구체화하고, 용어를 문서에 남기고, 명세와 티켓을 거쳐 구현하는 지침 묶음입니다. 이미 팀의 스킬과 개발 절차가 자리 잡았다면 겹치는 부분을 먼저 비교합니다. 2026년 10월 8일 확인한 문서와 v1.3.1을 기준으로 설명합니다. 공식 저장소
한눈에 보기
| 궁금한 점 | 확인한 내용 |
|---|---|
| 어떤 프로젝트입니까? | AI 코딩 에이전트가 읽는 재사용 가능한 개발 절차를 제공합니다. |
| 어떤 문제에 맞습니까? | 요구사항 오해, 용어 혼선, 테스트 생략, 명세와 구현 사이의 단절을 다룹니다. |
| Codex에는 어떻게 설치합니까? | README의 npx skills@latest add mattpocock/skills로 필요한 스킬과 에이전트를 선택합니다. |
| Claude Code에는 무엇이 다릅니까? | 관리형 플러그인과 수정 가능한 스킬 파일 설치 중 하나를 고릅니다. |
| 설정은 무엇을 바꿉니까? | 작업 추적·문서 위치 설정과 기존 프로젝트 지침의 스킬 안내를 씁니다. |
| 비용은 어떻게 나뉩니까? | 스킬은 MIT로 제공하며 에이전트의 구독·모델 호출 비용은 별도입니다. |
| OS 지원은 확인됐습니까? | 이 묶음의 Windows·macOS·Linux별 공식 지원표와 실행 결과는 미확인입니다. |
| 도입 판단은 무엇입니까? | 특정 상황에 유용합니다. 필요한 절차 한두 개부터 비교합니다. |
설치와 구성은 README, 설정 변경 범위는 v1.3.1 설정 스킬, 이용 권리는 라이선스를 대조했습니다.
어떤 작업에 도움이 됩니까?
mattpocock/skills는 개발자 Matt Pocock이 공개한 에이전트 스킬 모음입니다. 스킬은 이름과 설명, 작업 지침이 담긴 SKILL.md 파일이며, Claude Code·Codex 같은 코딩 에이전트가 이를 읽어 작업에 적용합니다. 특정 앱을 대신 개발하는 서비스보다, 개발할 때 반복해서 쓰는 질문·설계·검증 방법을 제공합니다. 프로젝트 소개
예를 들어 “관리자 화면에 CSV 가져오기를 추가해 주세요”라는 요청에는 결정할 것이 많습니다. 같은 이메일이 두 줄에 나오면 어느 줄을 채택할지, 일부 행에 오류가 있으면 전체를 취소할지, 기존 고객 정보를 덮어쓸지에 따라 결과가 달라집니다. 이런 빈칸을 코드 작성 전에 드러내고 싶은 개발자에게 요구사항 인터뷰 스킬이 맞습니다.
grill-with-docs는 질문을 진행하는 grilling과 용어·결정사항을 정리하는 domain-modeling을 함께 불러오도록 작성돼 있습니다. 뒤의 스킬은 합의된 용어를 GLOSSARY.md에 기록하고, 되돌리기 어렵고, 맥락 없이 보면 의아하며, 실제 대안 사이에서 고른 결정이라는 세 조건을 모두 갖춘 경우에만 ADR을 제안합니다. ADR은 설계 결정을 왜 내렸는지 남기는 문서입니다. CSV의 “가져오기”를 새 고객 생성으로 한정할지 기존 고객 갱신까지 포함할지 정해 놓으면, 이후 명세와 코드에서 같은 말을 공유할 수 있습니다. 인터뷰 스킬, 용어·결정 기록 스킬
코드가 그럴듯해도 실제 동작을 확인하는 흐름이 약하다면 tdd를 따로 검토할 수 있습니다. 실패하는 테스트를 먼저 만들고, 동작을 구현한 뒤 구조를 개선하는 red-green-refactor 절차를 안내합니다. 이 지침을 활용하려면 프로젝트에 실행 가능한 테스트 경로가 있어야 효과를 확인할 수 있습니다. TDD 스킬
기존 도구와 무엇이 다릅니까?
이 묶음을 설치한 뒤에도 코드 읽기·편집·명령 실행은 사용하는 에이전트가 담당합니다. 추가되는 것은 작업을 진행하는 지침과 프로젝트별 설정입니다. 팀의 지침 파일에 “테스트를 작성합니다”라는 한 줄이 있었다면, 스킬은 테스트할 경계와 단계별 피드백을 더 구체적으로 재사용하게 합니다. 모델 선택이나 에이전트의 권한 승인은 기존 도구에서 관리합니다. 설치와 스킬 구성
대안과 비교할 때는 “모듈형이면 모든 절차가 수동”이라고 단순화하기보다 어떤 지침이 언제 호출되는지 봅니다. README는 사람이 호출하는 스킬과 에이전트가 상황에 맞춰 사용할 수 있는 스킬을 구분합니다. to-spec·implement-spec처럼 흐름을 시작하는 스킬은 사람이 선택하고, tdd·domain-modeling 같은 지침은 그 안에서도 사용합니다. Codex 네이티브 플러그인은 README에서 로드맵으로 안내하며, 현재 제시한 범용 설치 경로와 구분합니다. 호출 방식과 설치 안내
| 비교 대상 | 문서가 설명하는 접근 | 선택할 때 볼 점 |
|---|---|---|
| mattpocock/skills | 작고 수정 가능한 지침을 조합하며, 일부 스킬은 전체 구현 흐름도 맡습니다. | 현재 절차에서 부족한 단계만 가져올지 정합니다. |
| Superpowers | 조합 가능한 스킬과 초기 지침을 통해 요구사항·계획·테스트 중심 개발 흐름을 자동으로 시작합니다. | 에이전트가 절차를 먼저 제안하는 방식이 팀에 맞는지 비교합니다. |
| GitHub Spec Kit | 명세·계획·작업·구현을 구조화하고, 템플릿과 결과 문서를 제공합니다. | 공통 산출물 형식을 얼마나 표준화할지 비교합니다. |
Superpowers README와 Spec Kit README를 기준으로 비교했습니다. 두 대안도 맞춤 구성을 제공합니다. 팀이 이미 명세 템플릿과 테스트 규칙을 운영한다면 같은 지침을 또 설치하기보다 기존 파일에 빠진 단계가 있는지 살펴보는 것으로 충분할 수 있습니다.
어떻게 사용합니까?
다음은 공식 스킬의 역할에 맞춰 구성한 CSV 가져오기 예시입니다. 아래 입력과 예상 산출물은 사용 흐름을 설명하기 위해 만든 예시이며, 실제 실행 결과는 확인한 범위에서 구분합니다. 설치와 초기 설정을 마친 프로젝트의 에이전트 대화에서 진행합니다.
- 요구사항을 정리합니다.
/grill-with-docs에 “관리자만 고객 CSV를 가져옵니다. 이메일 중복과 오류 행 처리부터 함께 정하고 싶습니다”라고 전달합니다. “고객”, “중복”, “가져오기”의 의미를 합의하고 필요한 용어·설계 결정을 기록하는 흐름을 기대합니다. 이 스킬을 선택할 때는 호출 대상인grilling·domain-modeling도 사용할 수 있는지 확인합니다. 스킬의 호출 대상 - 합의한 대화로 명세를 만듭니다.
/to-spec은 현재 대화와 코드 이해를 바탕으로 문제·해결 방법·사용자 요구·구현 결정·테스트 결정을 정리합니다. 새 인터뷰를 시작하는 단계 대신, 앞에서 결정한 오류 처리와 중복 정책을 명세에 담습니다. 테스트 경계를 사용자와 대조한 뒤 설정한 작업 추적 위치에 명세를 게시하는 지침입니다. 명세 작성 절차 - 명세를 검증 가능한 티켓으로 나눕니다.
/to-tickets에는 방금 만든 명세를 전달합니다. 예시로 “정상 행 한 건을 화면부터 저장까지 가져오기”, “오류 행 보고”, “중복 처리”를 나눌 수 있습니다. 실제 분해는 프로젝트 구조에 맞추며, 앞선 작업이 끝나야 시작하는 티켓에는 의존 관계를 표시합니다. 제안된 분해를 사람이 승인하면 로컬 파일이나 외부 작업 추적기에 게시합니다. 티켓 분해와 게시 - 전체 명세를 구현합니다.
/implement-spec은 준비된 티켓을 의존 관계가 있는 작업 그래프로 읽고, 시작 가능한 티켓을 하위 에이전트에 맡깁니다. 각 작업은 별도 Git worktree·브랜치에서 진행하고, 결과를 하나의 통합 브랜치로 모아 코드 검토로 마무리합니다. 작업 추적기가 PR로 일을 닫거나 사용자가 요청한 경우에는 첫 병합 뒤 초안 PR을 여는 절차도 포함합니다. 병렬 구현 지침
기대하는 결과는 질문에 답한 대화만 남기는 것에서 나아가, 합의한 용어·명세·티켓·구현 브랜치가 서로 이어지는 상태입니다. 이 전체 흐름을 선택하면 문서 작성뿐 아니라 코드 변경, 테스트 실행, 브랜치 병합, 작업 상태 변경까지 이어집니다. 처음에는 인터뷰와 명세 단계까지만 사용하고 산출물을 검토한 뒤 구현 범위를 정할 수 있습니다. 에이전트마다 호출·하위 에이전트 지원이 다를 수 있어, 위 슬래시 표기는 README가 소개한 스킬 이름으로 읽고 설치한 에이전트의 호출 목록과 대조합니다.
설치와 이용 조건
수정 가능한 파일로 설치합니다
README가 Codex와 다른 에이전트에 제시하는 명령은 다음과 같습니다. 터미널에서 프로젝트 폴더를 연 뒤 실행하며, 설치 화면에서 스킬과 대상 에이전트를 고릅니다. 초기 설정용 setup-matt-pocock-skills도 선택합니다. 공식 시작 명령
npx skills@latest add mattpocock/skills
이 명령의 패키지는 skills이고 @latest는 설치 시점의 최신 CLI를 선택합니다. 글의 검토 버전 v1.3.1을 고정하는 옵션과는 다르므로 설치 때 받을 스킬 내용은 달라질 수 있습니다. Node.js·npm과 공개 저장소·패키지 다운로드를 위한 네트워크가 필요합니다. 확인일의 CLI main에 있는 package.json은 Node.js >=22.20.0을 요구합니다. CLI 패키지 정의
CLI는 프로젝트 설치를 기본으로 제공하며, 심볼릭 링크와 복사를 선택할 수 있습니다. 링크를 지원하지 않는 환경에서는 문서의 --copy 옵션을 검토합니다. 이 방식으로 받은 파일은 자동으로 갱신되지 않으며, 새 릴리스를 받으려면 npx skills update를 실행하라고 저장소 README가 안내합니다. 이 묶음의 OS별 공식 지원 여부는 Windows·macOS·Linux 모두 미확인으로 남깁니다. Node.js가 동작한다는 사실과 에이전트에서 전체 스킬 흐름이 작동한다는 판단은 따로 확인합니다. 설치 범위와 방법
Claude Code는 설치 경로 하나를 고릅니다
Claude Code의 세션 안에서는 README가 다음 명령을 안내합니다. 플러그인은 전체 묶음을 관리형·읽기 전용으로 설치합니다. 수정 가능한 CLI 설치와 함께 사용하면 같은 스킬이 중복되므로 원하는 관리 방식 하나를 선택합니다. 플러그인 설치 안내
/plugin install mattpocock-skills
초기 설정은 프로젝트 문서를 씁니다
에이전트에서 /setup-matt-pocock-skills를 실행하면 저장소를 살펴보고 작업 추적기·라벨·문서 위치를 정리합니다. v1.3.1은 GitHub 원격이 있으면 GitHub를, GitLab 원격이면 GitLab을 제안합니다. 로컬 Markdown을 고르면 티켓을 .scratch/<기능 이름>/ 아래 파일로 남기며, 그 밖의 추적기는 사용자의 설명대로 설정 문서를 씁니다. 선택 내용은 docs/agents/issue-tracker.md와 docs/agents/domain.md에 쓰며, triage가 설치돼 있을 때 라벨 설정 문서도 만듭니다.
설정 초안을 확인한 뒤 기존 CLAUDE.md를 우선 수정하고, 그것이 없으면 기존 AGENTS.md에 스킬 안내를 추가합니다. 둘 다 없을 때는 생성할 파일을 사용자에게 묻는 지침입니다. 따라서 스킬 설치 폴더뿐 아니라 프로젝트 지침과 설정 문서에 대한 쓰기 권한도 고려합니다. GitHub·GitLab 작업 추적을 선택하면 이후 티켓 게시에 해당 CLI의 인증과 권한이 필요하며, 로컬 파일을 선택하면 외부 이슈 게시를 줄일 수 있습니다. 설정 스킬의 변경 대상
기본 전송 설정을 확인합니다
skills CLI 문서는 익명 사용 통계를 기본으로 수집하며 스킬 이름·파일·시각을 포함한다고 설명합니다. 끄려면 설치 전에 환경 변수 DISABLE_TELEMETRY=1을 설정합니다. CLI 저장소는 DO_NOT_TRACK=1도 지원하고, 두 설정이 사용 통계와 보안 감사 요청을 끈다고 설명합니다. 환경 변수를 설정하는 문법은 사용하는 셸에 맞춥니다. CLI 통계 안내, 전송과 환경 변수
확인한 설치 안내는 특정 유료 모델 제공자를 기본으로 지정하는 대신 기존 코딩 에이전트를 사용합니다. 그 에이전트가 읽는 코드·대화의 모델 전송은 에이전트의 제공자와 계정 설정을 따릅니다. 작업 추적기를 외부 서비스로 정하면 명세·티켓도 그곳에 게시되므로, CSV 예시에서는 실제 고객 자료 대신 구조를 설명하는 샘플 입력으로 요구사항을 정리할 수 있습니다.
비용과 라이선스
저장소의 MIT 라이선스는 사용·수정·배포·판매를 허용하며, 복사본이나 상당 부분을 배포할 때 저작권과 허가 고지를 포함하는 조건을 둡니다. 상업 프로젝트에서 사용할 수 있고, 코드와 문서는 현 상태로 제공됩니다. 스킬 묶음 자체에 대한 별도 유료 이용 가격표는 확인 자료에서 미확인입니다. MIT 원문
실제 지출은 사용하는 Claude Code·Codex 등의 구독이나 모델 API, 병렬 작업을 돌리는 환경에서 계산합니다. implement-spec처럼 여러 하위 에이전트를 쓰는 절차에서는 각 작업의 모델 사용량이 누적될 수 있습니다. README의 토큰 절약 설명은 프로젝트 측 주장으로 읽고, 팀의 작업 시간과 호출 비용은 같은 규모의 과제를 비교해 판단합니다. 설치 안내에는 이 공개 스킬을 받기 위한 모델 API 키 입력 단계가 제시돼 있지 않습니다. 설치 안내, 병렬 작업 구조
한계와 유지보수
2026년 10월 4일 릴리스된 v1.3.1은 implement-spec·pr·retro를 정식 Engineering 묶음에 반영했습니다. 명세를 병렬 구현하는 지침, PR 본문을 쓰는 지침, 세션 뒤 개발 환경 개선점을 찾는 지침을 함께 관리합니다. 용어 문서 관례도 CONTEXT.md·CONTEXT-MAP.md에서 GLOSSARY.md·GLOSSARY-MAP.md로 바뀌었습니다. 스킬이 새 이름만 찾으므로 이전 버전으로 만든 문서는 git mv로 이름을 바꾸라고 안내합니다. 같은 릴리스에서 resolving-merge-conflicts 스킬은 대체 없이 빠졌습니다. v1.3.1 릴리스
Claude Code 공식 마켓플레이스 설치는 저장소의 최신 릴리스보다 수일에서 수주 늦을 수 있다고 README가 안내합니다. 10월 5일 열린 이슈 #1164에는 설치·갱신 후에도 v1.2.3에 머문다는 사용자 보고가 있으며, 받은 원문에서 열린 상태이고 연결된 수정 PR은 없습니다. 같은 문제가 있다면 자신의 설치 버전을 릴리스와 대조해 볼 수 있습니다. 사용자 보고 #1164
README는 claude plugin list로 설치 버전을 보고 CHANGELOG.md와 비교하는 방법을 안내합니다. 저장소를 직접 추적하려면 공식 마켓플레이스 설치를 제거하고 다음 경로로 전환하며, /plugin의 Marketplaces에서 자동 갱신을 켭니다. Anthropic 외 마켓플레이스의 자동 갱신은 기본으로 꺼져 있다고 설명합니다. 갱신 지연과 전환 안내
claude plugin uninstall mattpocock-skills@claude-plugins-official
claude plugin marketplace add mattpocock/skills
claude plugin install mattpocock-skills@mattpocock
지침 파일은 결정론적인 검사 프로그램과 성격이 다릅니다. 릴리스 기록에는 이름만 언급한 다른 스킬이 안정적으로 로드되지 않아 호출 지침을 Skill tool 사용으로 명시한 수정도 있습니다. 설치한 뒤에는 필요한 스킬이 실제로 호출되는지, 정한 테스트와 작업 범위를 따르는지 살펴볼 수 있습니다. 호출 지침 수정 기록
확인한 범위
문서 확인: 공식 저장소의 설치 안내, v1.3.1 릴리스와 커밋 24fe0ef, 같은 태그의 설정·인터뷰·명세·티켓·구현 스킬, 이슈 #1164, MIT 라이선스를 대조했습니다. 설치기의 조건과 기본 전송은 별도 skills CLI 문서·저장소를 확인했습니다. 한국에서의 계정별 접근, 한국어 인터뷰 품질, OS별 실행 결과는 미확인입니다.
CSV 사례는 공식 지침을 이어 사용하는 예시입니다. 설치와 작업은 직접 실행하지 않았습니다.
도입 판단
요구사항 질문과 문서 정리가 자주 빠지는 팀이라면 특정 상황에 유용한 묶음입니다. 작업별 지침을 골라 자기 개발 방식에 맞게 손볼 수 있습니다. 모든 기능에 긴 인터뷰와 병렬 구현을 적용하기보다, 현재 가장 자주 놓치는 단계부터 가져오는 방식이 이 묶음의 장점과 맞닿습니다.
다음 행동은 작은 기능 하나에서 인터뷰로 정한 용어와 명세가 실제 변경 요구를 충분히 담는지 비교하는 것입니다. 초기에는 로컬 작업 추적을 선택하고 설정 문서의 변경분을 검토한 뒤, 티켓 게시와 구현까지 넓힐 수 있습니다. 이미 같은 절차를 운영한다면 스킬 내용을 기존 규칙과 대조하고, 전체 개발 흐름을 자동으로 제안받고 싶다면 Superpowers도 함께 비교합니다. OS 지원과 하위 에이전트 호출을 먼저 확인하려는 팀은 전체 병렬 구현 도입을 뒤로 미룰 수 있습니다.
참고한 자료
모든 자료는 2026년 10월 8일 확인했습니다. 기능 스킬은 v1.3.1에 고정하고, 설치 안내와 CLI 조건은 확인일의 공개 문서를 사용했습니다.
- mattpocock/skills 공식 저장소: 소개·설치·호출 구분·플러그인 갱신 안내를 확인했습니다.
- v1.3.1 릴리스: 기준 커밋·추가 스킬·문서 이름·호출 지침 수정을 확인했습니다.
- 초기 설정 스킬: 설정 초안과 변경할 파일을 확인했습니다.
- grill-with-docs·domain-modeling: 인터뷰와 용어·결정 기록의 연결을 확인했습니다.
- to-spec·to-tickets·implement-spec·tdd: 명세·작업 분해·병렬 구현·테스트 지침을 확인했습니다.
- 이슈 #1164: 플러그인 갱신 지연에 대한 사용자 보고를 확인했습니다.
- MIT 라이선스: 상업적 사용과 고지 조건을 확인했습니다.
- skills CLI 문서·CLI 저장소·패키지 정의: 설치 범위·전송 설정·Node.js 조건을 확인했습니다.
- Superpowers·GitHub Spec Kit: 절차의 호출 방식과 산출물을 비교했습니다.
