Matt Pocock Skills 설치 가이드: Claude Code 플러그인·skills.sh 선택과 첫 저장소 설정

Matt Pocock Skills를 처음 쓴다면 설치 방법을 두 개 모두 적용하지 말고 사용 중인 에이전트와 파일 수정 필요성으로 하나만 고르면 됩니다. Claude Code에서 관리형 번들을 쓰려면 공식 플러그인, Codex 또는 Agent Skills 호환 에이전트에서 쓰거나 프로젝트 안의 스킬 파일을 직접 바꾸려면 skills.sh 경로가 맞습니다.

설치 자체가 끝은 아닙니다. 대상 저장소에서 /setup-matt-pocock-skills를 한 번 실행해 이슈 트래커와 문서 위치를 정하고, 생성된 설정 파일을 확인한 뒤 /ask-matt로 첫 작업에 맞는 흐름을 찾는 순서로 진행하세요. 여기서 말하는 Claude Code는 일반 데스크톱 앱과 다른 개발용 에이전트 환경입니다. 필요하면 데스크톱 AI 프로그램과 Claude 앱의 차이도 함께 확인할 수 있습니다.

먼저 결론: Claude Code 플러그인과 skills.sh 중 하나만 선택하기

조건	선택 경로	관리 방식
Claude Code에서 표준 설치 경로를 쓰고 싶다	공식 마켓플레이스 플러그인	관리형·읽기 전용 번들
Codex 또는 기타 Agent Skills 호환 에이전트를 쓴다	skills.sh	스킬 파일을 프로젝트에 복사
설치한 스킬 파일을 직접 수정하고 싶다	skills.sh	직접 편집 가능, 업데이트는 명시적으로 실행

공식 README는 두 방식을 함께 쓰면 동일한 스킬이 중복 설치될 수 있다고 안내합니다. 따라서 같은 저장소에서 플러그인과 skills.sh 설치를 겹치지 마세요. 범용 AI 서비스의 선택 기준이 아니라 개발 저장소의 에이전트 지침을 어떻게 배치·관리할지의 문제라는 점도 구분할 필요가 있습니다. 관련 관점은 AI 도구 선택 기준에서 보완할 수 있습니다.

Matt Pocock Skills는 무엇인가: 일반 프롬프트 모음이 아닌 저장소용 에이전트 스킬 묶음

Matt Pocock Skills는 엔지니어링 작업에 사용할 수 있는 에이전트 스킬 묶음입니다. 단순히 복사해 붙여 넣는 일반 프롬프트 목록과 달리, 에이전트가 저장소 맥락에서 특정 흐름을 선택하도록 돕는 구조입니다.

예를 들어 ask-matt는 사용자가 직접 호출하는 라우터 스킬입니다. 현재 상황에 맞는 스킬 또는 작업 흐름을 안내하지만, 그 자체가 구현 작업을 수행하는 스킬은 아닙니다. 따라서 설치 후 곧바로 자동 개발이 시작된다고 기대하기보다, 저장소 설정과 필요한 슬래시 명령 호출을 별도 단계로 봐야 합니다.

설치 전 조건: 사용할 에이전트, 현재 저장소, 중복 설치 여부 확인

에이전트: Claude Code인지, Codex 또는 다른 Agent Skills 호환 에이전트인지 확인합니다.
현재 위치: 설정할 대상 Git 저장소를 열어 둡니다. 설정 스킬은 저장소의 git remote와 CLAUDE.md, GLOSSARY.md를 읽습니다.
기존 설치: 플러그인과 로컬 파일 설치가 이미 함께 존재하지 않는지 확인합니다.
문서명: 과거 자료의 CONTEXT.md 설명 대신 현재 문서의 GLOSSARY.md 계열 명칭을 기준으로 봅니다.

Claude Code에서 설치하기: `claude plugins install mattpocock-skills`와 `/plugin install mattpocock-skills`

Claude Code 사용자는 공식 마켓플레이스 플러그인 경로를 우선 선택할 수 있습니다. 터미널에서 설치하려면 다음 명령을 사용합니다.

claude plugins install mattpocock-skills

Claude Code 세션 안에서는 다음 슬래시 명령도 공식 README에 안내돼 있습니다.

/plugin install mattpocock-skills

이 방식은 전체 스킬 묶음을 관리형·읽기 전용으로 설치하는 경로입니다. 저장소 안의 일반 파일처럼 스킬을 직접 고쳐야 하는 요구가 있다면 아래 skills.sh 방식을 선택하는 편이 맞습니다. 검색 결과에 보이는 과거 /plugin marketplace add mattpocock/skills 방식보다 현재 README의 기본 설치 경로를 우선하세요.

Codex·기타 에이전트에서 설치하기: `npx skills@latest add mattpocock/skills`와 스킬 선택

Codex와 기타 호환 에이전트에는 공식 README가 skills.sh 설치 경로를 안내합니다.

npx skills@latest add mattpocock/skills

실행 과정에서는 대상 에이전트와 설치할 스킬을 선택합니다. 이 방식은 스킬 파일을 저장소에 일반 파일로 복사하므로 필요하면 직접 수정할 수 있습니다. 반대로 복사된 파일은 자동으로 최신화되지 않으므로 업데이트 시에는 다음 명령을 명시적으로 실행해야 합니다.

npx skills update

첫 실행: `/setup-matt-pocock-skills`로 이슈 트래커·문서 위치 설정하기

설치 직후에는 대상 저장소에서 /setup-matt-pocock-skills를 한 번 실행하세요. 이 스킬은 이슈 트래커, triage 라벨, 문서 저장 위치를 저장소별로 설정하기 위한 프롬프트 기반 흐름입니다.

설정할 저장소를 현재 작업 대상으로 엽니다.
/setup-matt-pocock-skills를 호출합니다.
스킬이 읽은 git remote, CLAUDE.md, GLOSSARY.md 정보를 확인합니다.
이슈 트래커·라벨·문서 위치에 대한 질문에 답하고, 제안된 내용이 맞는지 확인합니다.

기대 결과는 docs/agents/ 아래의 저장소 설정 문서입니다. 대표적으로 issue-tracker.md와 domain.md가 작성되며, triage 스킬이 설치된 경우 triage-labels.md도 생성될 수 있습니다. 즉 설치 성공과 저장소별 운영 맥락 설정 완료는 다른 상태입니다.

설치 확인과 첫 사용: 생성 파일 확인 후 `/ask-matt`로 작업 흐름 선택하기

설정 뒤에는 파일과 호출 결과를 각각 확인합니다.

docs/agents/issue-tracker.md, docs/agents/domain.md가 생성됐는지 확인합니다.
triage 스킬을 설치했다면 docs/agents/triage-labels.md도 확인합니다.
CLAUDE.md 또는 AGENTS.md의 Agent skills 관련 블록이 현재 저장소 맥락과 맞는지 확인합니다.
이후 /ask-matt를 실행해 현재 하려는 작업에 맞는 스킬 또는 흐름이 안내되는지 봅니다.

/ask-matt의 결과는 구현 완료 표시가 아니라 다음 작업 경로를 정하기 위한 안내입니다. 라우팅 결과가 현재 업무와 맞지 않는다면 먼저 setup 단계에서 기록한 이슈 트래커·도메인·문서 위치 정보를 다시 살피는 것이 순서입니다.

업데이트·오류 대응: 플러그인 버전 지연, 스킬 미탐지, 중복 설치 점검

2026년 10월 16일 확인 기준 GitHub Releases의 최신 표시 릴리스는 v1.3.1입니다. 다만 GitHub 저장소 릴리스와 Claude Marketplace 반영 시점은 다를 수 있으며, 공식 README도 마켓플레이스 반영이 며칠 또는 몇 주 늦어질 수 있다고 설명합니다.

최신 스킬이 보이지 않을 때: 플러그인과 저장소 릴리스의 반영 시점 차이인지 Releases와 Marketplace를 대조합니다.
스킬이 전혀 탐지되지 않을 때: skills.sh 설치 시 올바른 대상 에이전트를 선택했는지와 CLI 업데이트 상태를 확인합니다.
동일 명령이 여러 번 보일 때: 플러그인 설치와 skills.sh 파일 설치가 겹치지 않았는지 확인하고 한 경로만 남깁니다.
파일 설치본을 최신화할 때: 자동 갱신을 기대하지 말고 npx skills update를 실행합니다.

최종 선택: Claude Code에서 수정할 필요 없이 공식 관리형 설치를 원하면 플러그인을 고르고, Codex·호환 에이전트를 쓰거나 스킬 파일을 저장소별로 조정해야 한다면 skills.sh를 고르세요. 그 다음에는 반드시 해당 저장소에서 setup을 한 번 실행하고, 생성된 docs/agents/ 파일과 /ask-matt의 라우팅 결과까지 확인해야 첫 온보딩이 끝납니다.