유행 레포 딥다이브 · phuryn/pm-skills 분석

PM Skills 딥다이브
— AI를 프로덕트 매니저로 만드는 마크다운 65장의 생태계

PRD·OKR·로드맵·디스커버리 — 프로덕트 매니저(PM)의 전 과정을 마크다운 파일 한 장씩으로 인코딩한 Claude Code 스킬 마켓플레이스. ⭐11.9k · 68개 스킬 · 9개 플러그인 · 42개 워크플로우. "바이브코딩 다음은 바이브 PM"의 신호탄. (저장소: phuryn/pm-skills · MIT 라이선스 · 큐레이터 Paweł Huryn)
목차
  1. 프로젝트 한줄 요약
  2. 왜 주목받는가
  3. 스킬 구성·규약 스택 지도
  4. 구조 심화: 4계층 아키텍처
  5. 디렉토리 구조 해부
  6. 학습 포인트 (영역별)
  7. 시스템 요구사항 (사용 환경)
  8. 직접 해볼 수 있는 실습 과제
  9. 심화 학습 로드맵
  10. 핵심 키워드 사전
  11. 참고 링크

1프로젝트 한줄 요약

PM Skills가 정확히 무엇을 하는 레포인가

PM Skills프로덕트 매니저의 업무 방법론(프레임워크)을 마크다운 파일에 미리 박아두고, 필요할 때 AI가 자동으로 끌어다 쓰게 하는 스킬 모음 레포다. "PRD 검토해줘"라고 말하면 AI가 알아서 create-prd라는 지침서 파일을 끌어와 그 절차대로 일한다. 사람이 매번 프레임워크를 떠먹여줄 필요가 없어진다.

용어
PM (Product Manager, 프로덕트 매니저)
"무엇을·왜 만들지"를 정하는 직무. 사용자가 진짜 원하는 것을 찾고, 어떤 기능을 어떤 순서로 만들지 결정하고, 결과가 비즈니스에 효과가 있었는지 측정한다. 개발자는 "어떻게 만들지"를, PM은 "무엇을 만들지"를 정한다.
한 컷 비유

"신입 PM 옆에 항상 펼쳐져 있는, 업계 최고들의 노하우가 적힌 매뉴얼 65권"

일반 AI에게 "우선순위 매겨줘"라고 하면 그럴듯한 텍스트만 준다. PM Skills는 거기에 "RICE 공식을 이 순서로 적용하고, 이 표 양식으로 출력하라"는 검증된 절차를 입힌다.

핵심은 코드가 아니라 마크다운이라는 점이다. 실행 환경도, 빌드도 없다. 그냥 텍스트 파일 한 장 한 장이 "이 주제가 나오면 이렇게 일해라"는 지침서다. ⭐11.9k · 68개 스킬 · 9개 플러그인 · 42개 커맨드.

2왜 주목받는가

트렌딩 이유와 그냥 AI에게 묻는 것 대비 강점
기존 방식의 불편함
매번 처음부터 프레임워크를 떠먹여야 했다

PM이 AI를 쓰려면 매번 "RICE 우선순위 매기는 법은…", "OKR 작성 규칙은…", "PRD는 8섹션으로…"라고 처음부터 설명해야 했다. 일반 AI는 "텍스트"를 주지 "구조"를 주지 않는다. 결과물의 품질이 그날그날의 프롬프트 운빨에 좌우됐다.

PM Skills의 해법
프레임워크를 마크다운에 인코딩 → 자동 로드

Teresa Torres, Marty Cagan, Alberto Savoia 같은 PM 사상가들의 프레임워크를 미리 65장에 박아두고, 대화 맥락에 맞으면 자동으로 컨텍스트에 끌어온다. 디스커버리부터 런칭까지 PM의 전 과정이 슬래시 명령어 한 줄로 돌아간다. "바이브코딩의 PM 버전"이라 불릴 만하다.

"개발자 도구가 아닌데도" 트렌딩한 이유

관점이 레포가 의미하는 것
대상 확장AI 에이전트 활용이 개발자의 전유물에서 비개발 직무(PM)로 확장되는 신호탄
스킬 표준2026년 Claude Code의 새 개념인 스킬이 코드 외 영역에서도 통한다는 실전 증명
지식의 패키징책 한 권 분량의 방법론을 설치 가능한 패키지로 배포 — 노하우 유통 방식의 변화
진입 장벽마크다운만 읽고 쓸 줄 알면 누구나 자기 직무용 스킬을 만들 수 있음

3스킬 구성·규약 스택 지도

이 레포는 "코드 스택"이 아니라 "스킬 구성·파일 규약 스택"이다

이 레포에는 빌드 도구도, 런타임도 거의 없다. 대신 파일 포맷과 규약(컨벤션)이 곧 기술 스택이다. 무엇으로 이루어져 있는지 층층이 보자.

구성 비중 (파일 종류 기준)

Markdown ████████████████████████ ~95% ← SKILL.md · 커맨드 .md (핵심 콘텐츠) JSON ███ ~3% ← marketplace.json · plugin.json (메타데이터) Python █ ~2% ← validate_plugins.py (구조 검증 1개) 문서 (README/CLAUDE/AGENTS/CONTRIBUTING.md)

콘텐츠 / 핵심 구성 단위

요소역할상세
SKILL.md스킬 본체YAML 프론트매터 + 절차서 본문. 자동 로드되는 도메인 지식 (총 68장)
커맨드 .md워크플로우슬래시(/)로 수동 호출하는 다단계 절차 (총 42개)
plugin.json플러그인 메타각 플러그인의 이름·설명·버전. .claude-plugin/ 안에 위치
marketplace.json마켓 매니페스트레포 전체를 마켓플레이스로 선언. 어떤 플러그인이 들어있는지 목록화

규약 / 호스트 환경

기술역할상세
Claude Code주 실행 호스트스킬 자동 로드 + 커맨드 슬래시 실행을 모두 지원
Claude CoworkGUI 호스트Customize → Browse plugins로 마켓플레이스 추가 (권장 경로)
YAML Frontmatter트리거 규약스킬 머리말. AI가 "언제 이 스킬을 꺼낼지" 판단하는 근거
타 AI 어시스턴트스킬만 이식SKILL.md.gemini/skills/·.cursor/skills/로 복사 가능 (커맨드는 미지원)

검증 / 운영

기술역할상세
validate_plugins.py구조 검증플러그인 폴더 구조·메타데이터 규약 위반을 잡는 파이썬 스크립트
MIT License라이선스자유 사용·수정·재배포 가능. 자기 마켓플레이스로 포크하기 쉬움
GitHub 배포유통 채널claude plugin marketplace add {계정}/{레포} 한 줄로 설치

4구조 심화: 4계층 아키텍처

마켓플레이스 → 플러그인 → 스킬 → 커맨드, 레고처럼 쌓인다

Claude Code의 확장 시스템은 4단계 계층이다. 위에서 아래로 점점 잘게 쪼개진다.

┌─────────────────────────────────────────────────────────────┐ │ ① 마켓플레이스 (MARKETPLACE) │ │ = 깃허브 레포 전체. PM Skills 레포 1개 = 마켓플레이스 1개 │ │ marketplace.json 이 "안에 뭐가 들었는지" 선언 │ │ ┌───────────────────────────────────────────────────────┐ │ │ │ ② 플러그인 (PLUGIN) × 9 │ │ │ │ 설치 단위. 도메인별 묶음 │ │ │ │ pm-execution / pm-product-discovery / ... │ │ │ │ .claude-plugin/plugin.json 으로 정의 │ │ │ │ ┌──────────────────────┐ ┌────────────────────────┐ │ │ │ │ │ ③ 스킬 (SKILL) × 68 │ │ ④ 커맨드 (COMMAND) × 42 │ │ │ │ │ │ skills/*/SKILL.md │ │ commands/*.md │ │ │ │ │ │ 자동 로드 │ │ /슬래시 수동 호출 │ │ │ │ │ │ = 도메인 지식 │ │ = 다단계 워크플로우 │ │ │ │ │ └──────────────────────┘ └────────────────────────┘ │ │ │ └───────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────┘
대형마트 비유

마켓플레이스는 대형 마트 한 곳이다. 플러그인은 그 안의 코너(과일 코너, 정육 코너...)다. 스킬은 코너에 진열된 상품 하나하나, 커맨드는 "장보기 코스 추천"처럼 여러 상품을 한 번에 담아주는 묶음 서비스다.

사용자는 마트 전체를 사들일 필요 없이 "오늘은 과일·정육 코너만"처럼 필요한 플러그인만 골라 설치한다.

9개 플러그인 — 각 코너에 뭐가 들었나

플러그인스킬/커맨드다루는 PM 영역
pm-product-discovery13 / 5아이디어 발굴, 실험, 가정 검증, OST, 인터뷰
pm-product-strategy12 / 5비전, 비즈니스 모델, 가격 책정, 경쟁 지형
pm-execution16 / 11PRD, OKR, 로드맵, 스프린트, 회고, 릴리즈 노트
pm-market-research7 / 3페르소나, 세그먼테이션, 여정 지도, 시장 규모
pm-data-analytics3 / 3SQL 생성, 코호트 분석, A/B 테스트 분석
pm-go-to-market6 / 3비치헤드 세그먼트, ICP, 메시징, 그로스 루프
pm-marketing-growth5 / 2마케팅 아이디어, 포지셔닝, 가치 제안, 네이밍
pm-toolkit4 / 5이력서 검토, 법률 문서, 교정 등 잡다한 도구함
pm-ai-shipping2 / 5vibe-coding으로 만든 AI 앱 문서화·보안·테스트커버리지·Ship Packet 컴파일

스킬 vs 커맨드 — 같은 마크다운, 다른 동작

용어
Skill (스킬, 자동 로드되는 도메인 지식)
대화 중 관련 주제가 나오면 AI가 알아서 끌어오는 마크다운. "PRD 검토해줘"라고 하면 create-prd 스킬이 슬쩍 컨텍스트에 들어와 AI가 더 똑똑하게 답한다. 사용자가 명시적으로 부르지 않아도 발동한다.
용어
Command (커맨드, 수동 호출하는 워크플로우)
/pm-execution:write-prd "사진 태깅 기능"처럼 슬래시로 직접 부른다. 보통 여러 단계로 구성된 절차다: "① 기능 이해 → ② 질문으로 컨텍스트 수집 → ③ PRD 생성 → ④ 후속 제안".
사무실 비유

스킬은 책장에 꽂힌 참고 매뉴얼이다. 일하다 모르는 게 나오면 자동으로 꺼내 펼치고, 끝나면 다시 꽂는다.

커맨드는 결재 양식이다. "이 양식 채워 올려라"라고 명시적으로 지시하면 정해진 순서대로 빈칸을 채워 결과를 낸다. 커맨드의 진짜 가치는 여러 스킬을 순서대로 엮어 한 번에 돌리는 것이다.

커맨드 동작 예시

/write-prd 커맨드의 4단계

Step 1 — 사용자가 입력한 한 문장("사진 자동 태깅 기능")을 분석. Step 2 — 부족한 정보를 질문으로 채운다("타겟 사용자는?", "성공 지표는?"). Step 3create-prd 스킬을 호출해 8섹션 PRD 생성. Step 4 — "이제 프리모템이나 유저 스토리 분해를 해보겠어?"라고 후속을 제안한다.

사용자 입장에서는 단 한 줄로 PRD 작성 전 과정이 끝난다. 진정한 의미의 워크플로우 오케스트레이션(여러 단계를 한 줄로 묶기).

5디렉토리 구조 해부

레포 루트와 플러그인 1개 내부를 함께 본다

레포 루트 (마켓플레이스 레벨)

phuryn/pm-skills/ ├── .claude-plugin/ # ⭐ 마켓플레이스 매니페스트 │ └── marketplace.json # "이 레포에 어떤 플러그인이 있나" 선언 ├── .docs/images/ # README용 이미지 ├── pm-product-discovery/ # ┐ ├── pm-product-strategy/ # │ ├── pm-execution/ # │ 9개 플러그인 폴더 ├── pm-market-research/ # │ (각각이 독립 설치 단위) ├── pm-data-analytics/ # │ ├── pm-marketing-growth/ # │ ├── pm-go-to-market/ # │ ├── pm-toolkit/ # │ ├── pm-ai-shipping/ # ┘ ├── validate_plugins.py # ⭐ 구조 검증 스크립트 ├── README.md # 설치법 · 스킬 목록 ├── CLAUDE.md # AI에게 주는 레포 작업 지침 ├── AGENTS.md # 에이전트용 작업 절차 ├── CONTRIBUTING.md # 기여 가이드 └── LICENSE # MIT

플러그인 1개 내부 (예: pm-execution)

pm-execution/ ├── .claude-plugin/ │ └── plugin.json # 이 플러그인의 이름·설명·버전 ├── skills/ # ⭐ 자동 로드되는 지식 (16장) │ ├── create-prd/ │ │ └── SKILL.md # YAML 머리말 + 절차서 본문 │ ├── write-okrs/ │ │ └── SKILL.md │ └── ... (sprint-plan, retro 등) ├── commands/ # ⭐ 슬래시 워크플로우 (11개) │ ├── write-prd.md # /pm-execution:write-prd │ ├── sprint.md # /pm-execution:sprint (plan|retro|release) │ └── ... └── README.md

핵심 규약: 플러그인은 .claude-plugin/plugin.json(메타) + skills/(자동 지식) + commands/(수동 워크플로우)의 3종 세트로 구성된다. 이 폴더 모양만 똑같이 베끼면 누구나 자기 도메인 플러그인을 만들 수 있다.

6학습 포인트 (영역별)

이 레포에서 무엇을 배울 수 있는가

A. 스킬 설계 — "지식을 절차로 쓰는 법"

배울 것: 좋은 SKILL.md는 백과사전이 아니라 절차서다. 보통 네 가지가 들어간다 — ① 무엇을 하는지(개요), ② 어떤 프레임워크로(체크리스트·템플릿), ③ 결과물의 모양(출력 포맷), ④ 다음에 뭘 하면 좋은지(후속 제안). 65개 실전 예시로 이 패턴을 익힐 수 있다.

함정
"그냥 정보를 잔뜩 적어두기"

스킬을 백과사전처럼 만들면 AI가 길을 잃는다. 정보의 나열이 아니라 "이 순서로, 이 양식에 맞춰, 이런 결과를 내라"는 절차가 명확해야 한다.

해결책
단계별 가이드 + 출력 템플릿을 함께 제공

"먼저 가정을 5가지 유형으로 분류하라. 각 가정에 확신 수준을 매기라. 표 형식으로 정리하라"처럼 절차가 보이게 쓴다. 그리고 표 모양 예시까지 보여준다. AI가 그대로 따라 하기 쉬워진다.

B. YAML 프론트매터 — 트리거 설계

배울 것: 스킬 머리말의 description을 어떻게 쓰느냐가 "AI가 이 스킬을 제때 꺼내느냐"를 결정한다. 트리거 문구가 모호하면 발동이 안 되고, 너무 광범위하면 엉뚱한 데서 발동한다. 65개의 잘 다듬어진 description이 좋은 레퍼런스다.

C. 4계층 확장 시스템 — 패키징과 배포

배울 것: 마켓플레이스 → 플러그인 → 스킬/커맨드로 이어지는 모듈 구조. marketplace.jsonplugin.json의 역할 분담, 그리고 claude plugin marketplace add 한 줄로 노하우를 배포하는 유통 모델을 통째로 배운다.

D. 인코딩된 PM 프레임워크 — 도메인 지식

배울 것: OST(기회 솔루션 트리), RICE/ICE 우선순위, JTBD, 비즈니스 모델 캔버스, 프리토타이핑, 프리모템, Kano 모델, North Star 지표 등 교과서에서나 듣던 프레임워크가 "어떻게 절차로 변환되는지"를 실물로 본다. PM 입문 교재로도 손색없다.

E. 커맨드 오케스트레이션 — 워크플로우 합성

배울 것: 단일 스킬을 넘어 여러 스킬을 순서대로 엮는 법. /discover(아이디어→가정→우선순위→실험)처럼 한 커맨드 안에서 다단계 절차를 합성하는 설계 패턴.

F. 구조 검증 자동화

배울 것: validate_plugins.py가 어떻게 플러그인 폴더 구조·메타데이터 규약 위반을 잡아내는지. 규약 기반 프로젝트에서 "사람이 실수해도 CI가 막아주는" 안전망 설계의 작은 본보기다.

7시스템 요구사항 (사용 환경)

하드웨어가 아니라 "어디서 어떻게 돌리나"

이 레포는 마크다운 모음이라 무거운 하드웨어가 필요 없다. 관건은 어떤 호스트(실행 환경)에서 쓰느냐다.

항목요구사항비고
실행 호스트Claude Code(CLI) 또는 Claude Cowork스킬+커맨드 둘 다 쓰려면 Claude 계열 필요
계정Claude 구독 또는 Anthropic API 키AI 추론 비용 발생
네트워크인터넷 연결 필수모델 통신 + 마켓플레이스 설치
Git설치 시 내부적으로 사용marketplace add가 레포를 가져옴
Python(선택) validate_plugins.py 실행 시스킬 사용 자체엔 불필요. 기여·검증 때만
로컬 디스크수 MB (텍스트 파일)코드·바이너리 없음

설치 방법별 비교

방법장점단점
Cowork GUI클릭만으로 마켓 추가 (공식 권장)커맨드라인보다 일괄 설치는 번거로움
Claude Code CLImarketplace add + install로 빠르고 자동화 친화터미널 사용에 익숙해야 함
타 AI 수동 복사Gemini·Cursor 등에서도 스킬만 재사용 가능커맨드(슬래시 워크플로우)는 미지원
# Claude Code CLI — 마켓 추가 후 원하는 플러그인만 설치
claude plugin marketplace add phuryn/pm-skills
claude plugin install pm-execution@pm-skills
claude plugin install pm-product-discovery@pm-skills

8직접 해볼 수 있는 실습 과제

난이도별 5가지 과제
과제 1

설치 후 PRD 한 장 뽑아보기 ★ 초급 30분

가장 작은 한 발. pm-execution 플러그인만 깔고 PRD 커맨드를 한 줄 친 뒤, AI가 어떤 질문을 던지고 어떤 구조로 답하는지를 관찰한다.

claude plugin marketplace add phuryn/pm-skills → claude plugin install pm-execution@pm-skills → /pm-execution:write-prd "반려동물 건강 관리 앱" → AI가 채워달라는 빈칸(타겟·성공 지표 등)에 주목
과제 2

스킬 적용 전/후 비교 ★ 초급 1시간

같은 요청("이 기능 우선순위 매겨줘")을 ① 플러그인 없이 ② pm-product-discovery 설치 후로 두 번 시켜보고, 결과의 구조 차이(RICE 표가 나오는지 등)를 비교한다.

관찰 포인트: 스킬이 없을 때는 줄글, 있을 때는 점수 공식·표·후속 제안이 따라오는지. 이게 "텍스트 vs 구조"의 실체다.
과제 3

나만의 SKILL.md 한 장 쓰기 ★★ 중급 2시간

자기 직무에서 반복되는 작업(회의록 정리, 주간 보고 등) 하나를 골라 마크다운 한 장으로 절차를 적는다. YAML 머리말 + 4요소(개요·절차·출력 포맷·후속) 구조를 직접 경험한다.

경로: .claude/skills/my-skill/SKILL.md → 머리말에 name·description(트리거 문구) → 본문에 "① ~하라 ② ~하라" 절차 + 출력 표 예시 → 같은 작업 전/후 비교
과제 4

가상 제품으로 전 과정 한 바퀴 ★★★ 고급 4시간

머릿속 아이디어(예: 동네 카페 멤버십 앱)로 디스커버리 → 전략 → PRD → 런칭까지 커맨드를 순서대로 돌려본다. PM이 실제로 하는 일의 전체 모양이 보인다.

# 디스커버리 → 전략 → 실행 → GTM 순서
/pm-product-discovery:discover  "동네 카페 멤버십 앱"
/pm-product-strategy:strategy
/pm-execution:write-prd
/pm-go-to-market:plan-launch
과제 5

나만의 플러그인 + 마켓플레이스 배포 ★★★ 고급 4시간+

자기 회사 도메인(HR·마케팅·영업)에 맞는 스킬 3개 + 커맨드 2개를 묶어 플러그인을 만들고, marketplace.json으로 패키징해 깃허브에 공개한다. 동료가 한 줄로 설치할 수 있게 된다.

구조: PM Skills의 폴더 모양을 그대로 베끼기 → .claude-plugin/plugin.json + skills/ + commands/ → validate_plugins.py로 구조 검증 → marketplace.json 작성 → git push → 동료는 claude plugin marketplace add {계정}/{레포}로 설치

9심화 학습 로드맵

4주 학습 플랜

1주차: 써보며 감 잡기

요일학습 내용실습
마켓플레이스·플러그인 설치pm-execution 설치, 첫 PRD 생성
스킬 자동 로드 체감플러그인 유/무 결과 비교
커맨드 슬래시 호출/write-prd, /sprint 직접 실행
8개 플러그인 영역 훑기각 플러그인 README로 역할 파악
출력 포맷 관찰표·체크리스트가 어떻게 나오는지 기록

2주차: 스킬 뜯어보기

요일학습 내용실습
SKILL.md 구조 분석create-prd 파일 정독
YAML 프론트매터description 트리거 문구 비교
4요소 패턴 식별개요·절차·출력·후속을 표시해보기
나만의 SKILL.md 작성반복 업무 1개를 스킬로
스킬 적용 효과 측정전/후 품질·시간 비교 기록

3주차: PM 프레임워크 학습

요일학습 내용실습
디스커버리 (OST·인터뷰)/discover로 기회 트리 그리기
우선순위 (RICE·ICE·MoSCoW)가상 기능 목록 점수화
전략 (비즈니스/린 캔버스)/strategy로 캔버스 작성
검증 (프리토타이핑·프리모템)PRD에 프리모템 후속 적용
지표 (North Star·A/B)/north-star로 핵심 지표 정의

4주차: 만들고 배포하기

요일학습 내용실습
플러그인 구조 설계plugin.json + 폴더 뼈대
커맨드 오케스트레이션스킬 2개를 엮는 커맨드 작성
구조 검증validate_plugins.py 돌리기
마켓플레이스 매니페스트marketplace.json 작성
깃허브 공개·설치 테스트동료가 add로 설치되는지 확인

10핵심 키워드 사전

이 레포를 이해하는 데 꼭 필요한 용어들
키워드설명
마켓플레이스플러그인을 모아 배포하는 최상위 단위. 깃허브 레포 1개 = 마켓플레이스 1개
플러그인스킬+커맨드를 묶은 설치 단위. PM Skills엔 9개
스킬 (Skill)자동 로드되는 도메인 지식 마크다운(SKILL.md). 총 68장
커맨드 (Command)슬래시로 수동 호출하는 다단계 워크플로우. 총 42개
SKILL.md스킬 본체 파일. YAML 머리말 + 절차서 본문 구조
YAML 프론트매터파일 맨 앞 --- 블록. 이름·설명·트리거 조건을 적어 AI가 발동 여부 판단
marketplace.json레포를 마켓플레이스로 선언하고 포함 플러그인을 목록화하는 매니페스트
plugin.json개별 플러그인의 이름·설명·버전 메타데이터
PRD제품 요구사항 문서. 기능·대상·동작·성공 지표를 한 문서로. 보통 8섹션
OKRObjectives & Key Results. 목표와 핵심 결과로 방향·성과를 정렬하는 기법
OSTOpportunity Solution Tree(Teresa Torres). 목표→기회→해결책→실험으로 가지치기
RICEReach×Impact×Confidence÷Effort 우선순위 점수 공식
JTBDJobs To Be Done. "사용자가 이 제품을 고용해 해결하려는 일"로 니즈를 보는 관점
프리토타이핑Pretotyping(Alberto Savoia). 만들기 전에 "맞는 걸 만드는가"부터 싸게 검증
프리모템Pre-mortem. "6개월 뒤 망했다 치고 왜 망했나"를 미리 묻는 리스크 부검
North Star 지표제품의 핵심 가치를 대표하는 단 하나의 북극성 지표
CoworkClaude의 GUI 작업 환경. 마켓플레이스를 클릭으로 추가하는 권장 경로
워크플로우 오케스트레이션여러 스킬을 한 커맨드로 순서대로 엮어 한 줄로 실행하는 것

11참고 링크

더 깊이 파고들 때 유용한 자료들