Matt Pocock Skills: 설계·테스트·리뷰 절차를 잡아 주는 개발 스킬 모음
AI 개발 도구가 요구사항 정리, 설계, 테스트, 코드 검토를 일정한 절차로 수행하도록 돕는 개발 업무 스킬 모음이에요.
주요 기능
- 질문을 통해 요구를 명확히 하고 공통 용어집·아키텍처 결정 기록을 작성하는 흐름을 제공한다.
- 대화 내용을 명세와 작은 작업 티켓으로 나누고 TDD·디버깅·구조 개선·코드 리뷰로 이어지는 스킬을 제공한다.
- 업무 인계·학습·질문지·문서 작성 등 비개발 생산성 스킬도 포함한다.
- 사람이 명시적으로 호출하는 조정용 스킬과 모델이 상황에 맞게 불러오는 재사용 스킬을 구분한다.
구조
실행 서버나 완성 애플리케이션이 아니라 skills/engineering 및 skills/productivity 안의 SKILL.md와 참고 문서를 에이전트가 읽는 구조다. 플러그인 매니페스트는 배포 대상 스킬을 명시한다. package.json은 private인 릴리스 관리 저장소이며 버전 1.3.2와 Changesets 개발 의존성만 둔다. 별도 런타임 npm 앱으로 오해해 npm start를 실행하는 종류가 아니다. link-skills.sh는 유지보수자용으로 설치 지원 대상이 아니라고 코드에 명시한다.
누구에게 쓸모 있나요
이미 Claude Code·Codex·Copilot 등의 코딩 에이전트를 쓰며 팀의 요구사항·테스트·검토 절차를 일관되게 만들려는 개발자. 소프트웨어 개발 경험을 대체해 주는 제품은 아니다.
설치 전 준비
선택한 AI 에이전트와 프로젝트 파일 접근이 필요하다. 플러그인 설치는 호스트의 지원 버전에 의존하고 범용 skills CLI 경로는 Node/npm 환경이 필요하다. GitHub 이슈·PR 작업은 gh와 저장소 접근, GitLab은 glab 등이 필요할 수 있지만 로컬 Markdown 이슈 방식을 선택할 수도 있다. 저장소가 모든 호스트·OS의 최소 버전을 지정한다고 확인하지 못했다.
- Claude Code·Codex·GitHub Copilot CLI/VS Code: 네이티브 플러그인 설치 안내
- Gemini CLI 및 Cursor·OpenCode 등: 스킬 파일 설치 경로 안내
- 스킬 문서는 OS 독립적이나 셸·CLI·호스트별 지원 차이 존재; Windows에서 bash 유지보수 스크립트의 동작은 검증하지 않음
설치 방법
- 에이전트별로 플러그인 또는 편집 가능한 파일 복사 중 한 경로를 선택한다. 둘 다 설치하면 동일 스킬이 중복 노출될 수 있다.
- 문서상 Claude Code 설치 예시: claude plugin install mattpocock-skills@claude-plugins-official — 이번 작업에서는 실행하지 않았다. Codex·Copilot·Gemini와 기타 호스트는 README의 각 전용 절차를 따른다.
- 설치 후 프로젝트마다 /setup-matt-pocock-skills를 한 번 호출한다. 이슈 저장 위치, triage 라벨, 용어집/ADR 경로를 정하고 제안 내용을 검토한다.
- 플러그인은 호스트별 자동 갱신 정책을 사용하고 skills CLI 파일 복사 경로는 수동 갱신한다. 저장소의 scripts/link-skills.sh는 일반 사용자 설치 방법으로 사용하지 않는다.
사용 방법
- 어떤 흐름을 선택할지 모르겠으면 /ask-matt를 호출하고 프로젝트와 목표를 설명한다.
- 초기 기획은 /grill-with-docs로 요구·용어·결정을 정리한 후 /to-spec과 /to-tickets로 명세·작업을 구체화한다.
- 구현은 /implement 또는 /implement-spec의 성격을 확인해 선택하고, /tdd로 테스트 피드백을 얻은 뒤 /code-review와 /pr 결과를 직접 검토한다.
- 업무가 중단되면 /handoff로 전달 내용을 남기고 저장된 용어집·ADR·이슈를 다음 세션에서도 사용한다. 스킬 이름·동작은 버전별로 바뀔 수 있어 설치본 문서를 기준으로 한다.
비용과 API 키
스킬 저장소 자체는 MIT 무료이며 전용 API 키·서비스 계정이 없다. 실제 작업을 수행하는 AI 호스트의 구독 또는 모델 호출 비용과 이슈 추적 서비스의 요금은 별도다. 여러 에이전트를 쓰는 스킬은 모델 호출량과 자원 사용이 늘어날 수 있다.
라이선스
LICENSE 원문과 package.json에서 MIT를 확인했다. 복사·수정·재배포 시 저작권 및 허가 고지를 유지해야 하며 결과의 정확성에 대한 보증은 없다.
주의사항과 알려진 이슈
- 스킬은 모델에게 주는 절차이므로 그대로 준수된다는 보장이 없다. 질문 방식·근거 확인·브랜치 범위·테스트 판단을 사람이 확인해야 한다.
- 일부 스킬은 이슈 생성·라벨 수정·문서·코드 변경·커밋/PR 등 외부 쓰기 작업으로 이어진다. 실행 전에 권한·대상을 제한하고 결과 diff를 검토해야 한다.
- 미완성(in-progress)·misc·deprecated 디렉터리는 일반 배포 스킬과 성숙도가 다르다. 저장소에 존재한다는 이유로 모든 항목을 일괄 활성화하면 안 된다.
- 유지보수자용 link-skills.sh는 기존 일반 디렉터리를 삭제한 후 심볼릭 링크를 만들 수 있는 코드가 있어 사용자 설정을 건드릴 수 있다. 공식 설치 경로를 사용한다.
#1338 설계 후보 간 사실 충돌을 비교에서 놓친 보고
공통 근거 파일을 전달해도 한 하위 에이전트가 잘못된 라이브러리 전제를 사용했다는 열린 보고. 여러 설계안 비교가 사실 검증을 대신하지 못한다.
#1331 PR 설명과 실제 브랜치 변경 범위 불일치
작업 트리만 확인해 다른 브랜치의 이력이 전달된 사례를 보고했다. PR 설명뿐 아니라 대상 브랜치 대비 diff·커밋을 검토해야 한다.
확인 범위
확인 날짜: 2026-10-29
확인한 범위: 공식 GitHub의 지정 커밋 README·매니페스트·주요 구현/안전 문서·라이선스와 릴리스/열린 이슈를 읽은 정적 분석. 설치·실행·로그인·API 호출은 하지 않음.
확인 한계: 아래 설치·사용 절차는 공식 문서에 기재된 방법을 재정리한 것이며 직접 실행 검증 결과가 아님. 모든 OS·모델·브라우저 조합, 전체 의존성 보안, 모든 이슈를 검증하지 않음. 최신 안정 릴리스는 v1.3.2이며 현재 main에는 이후 implement-spec 변경 커밋이 포함되어 있어 릴리스와 구분했다.
확인 커밋: a496f5513d4a4cf889bc48e189e579f4b0bdf6aa