새소식
300x250
AI/Skills
PM Skills 분석 : 8개 PM 플러그인과 36개 워크플로우 - PM Skills Marketplace로 혼자서 PM 팀처럼 일하기
- -
728x90
안녕하세요! 갓대희 입니다.
AI에게 그냥 단순히 "PRD 좀 써줘"라고 하면 나오는 게 텍스트 덩어리이다.
구조도, 우선순위 기준도, 검증 방법도 없다. PM Skills Marketplace는 이 지점을 공략한다고 한다. "제네릭 AI는 텍스트를 주면서, 우리는 구조를 제공한다".
이 프로젝트는 65개 PM 스킬과 36개 체인드 워크플로우를 8개 플러그인으로 묶어서 제공한다.
MIT 라이선스 오픈소스로, GitHub에서 누구나 사용할 수 있다. Paweł Huryn이 The Product Compass Newsletter에서 큐레이팅했다.
이번 글에서는 이 프로젝트의 아키텍처와 8개 플러그인별 기능, 소스코드 구조, 활용법등을 살펴보려고 한다.
목차
- 소개 및 대안 비교
- 설치 및 시작하기
- 핵심 기능: 8개 플러그인 상세
- pm-product-discovery —
/discover/brainstorm/triage-requests등 5개 명령어 - pm-product-strategy —
/strategy/business-model/pricing등 5개 명령어 - pm-execution —
/write-prd/plan-okrs/sprint등 10개 명령어 - pm-market-research —
/research-users/competitive-analysis/analyze-feedback3개 명령어 - pm-data-analytics —
/write-query/analyze-cohorts/analyze-test3개 명령어 - pm-go-to-market —
/plan-launch/growth-strategy등 3개 명령어 - pm-marketing-growth —
/market-product/north-star2개 명령어 - pm-toolkit —
/review-resume/proofread등 5개 명령어
- pm-product-discovery —
- 기술 아키텍처 분석
- 소스코드 핵심 분석
- 활용법 및 통합 방법
- 실전 사용 예시: PM 워크플로우
- 제한사항 및 주의사항
- 트러블슈팅 Q&A
1. 소개 및 대안 비교
PM Skills Marketplace는 Claude Code, Cowork, Gemini CLI, Cursor, OpenCode 등 다양한 AI 어시스턴트에서 PM 업무를 자동화하는 스킬 모음이다.
단순히 AI에게 질문하는 것과의 차이점은, 검증된 PM 프레임워크를 구조화된 스킬로 내장했다는 점이다.
6명의 저자(Teresa Torres의 Continuous Discovery Habits, Marty Cagan의 INSPIRED, Dan Olsen의 The Lean Product Playbook 등) 이론이 스킬 설계에 반영되어 있다.
2. 설치 및 시작하기
세 가지 환경에서 설치할 수 있다. 목적에 따라 선택하면 된다.
2.1 Claude Code CLI
개발자 환경이라면 CLI 설치가 직접적이다. marketplace를 추가한 뒤 개별 플러그인을 설치하는 2단계 방식이다.
# Step 1: 마켓플레이스 추가
claude plugin marketplace add phuryn/pm-skills
그다음 사용할 플러그인을 개별 설치한다.
# Step 2: 플러그인 개별 설치
claude plugin install pm-toolkit@pm-skills
claude plugin install pm-product-strategy@pm-skills
claude plugin install pm-product-discovery@pm-skills
claude plugin install pm-market-research@pm-skills
claude plugin install pm-data-analytics@pm-skills
claude plugin install pm-marketing-growth@pm-skills
claude plugin install pm-go-to-market@pm-skills
claude plugin install pm-execution@pm-skills팁 — 모든 플러그인이 필요하지 않을 수 있다. 가장 자주 쓰이는 것부터 먼저 설치하고, 필요에 따라 추가하자.
2.1.1 설치 확인
설치 후 다음 두 가지로 정상 동작을 확인한다.
확인 1: 플러그인 목록 조회
# Claude Code 세션 내 슬래시 명령어로 확인
/plugin marketplace list설치한 플러그인 이름(예: pm-product-discovery@pm-skills)이 목록에 표시되면 정상이다.
확인 2: 명령어 테스트
Claude Code 세션에서 슬래시 명령어를 입력해본다.
/discover B2B SaaS 대시보드 아이디어"명령어를 찾을 수 없다"는 오류가 나오면 marketplace 추가 단계를 다시 확인하자. 정상이라면 Discovery 워크플로우가 시작된다.
2.2 Claude Cowork (GUI)
개발자가 아닌 PM도 사용할 수 있는 방법이다. GUI에서 marketplace를 추가한다.
- Customize (좌측 하단) 열기
- Browse plugins → Personal → + 클릭
- Add marketplace from GitHub 선택
phuryn/pm-skills입력
2.3 기타 AI 어시스턴트
Skills는 SKILL.md 파일 형식을 사용하므로 Gemini CLI, Cursor, OpenCode, Codex CLI, Kiro 등에서도 사용할 수 있다. 각 도구의 skills 디렉토리에 스킬 폴더를 복사하면 된다. 다만 명령어(Commands, 슬래시 커맨드)는 Claude 전용 기능이므로 다른 AI에서는 사용할 수 없다. 스킬만 복사해서 사용해야 한다.
| 도구 | 복사 경로 | 작동 범위 |
|---|---|---|
| Gemini CLI | .gemini/skills/ |
스킬만 |
| OpenCode | .opencode/skills/ |
스킬만 |
| Cursor | .cursor/skills/ |
스킬만 |
| Codex CLI | skills 디렉토리 | 스킬만 |
| Kiro | skills 디렉토리 | 스킬만 |
PM 라이프사이클 → 8개 플러그인 역할 분담
|
발견
pm-product-discovery
/discover
|
전략
pm-product-strategy
/strategy
|
실행
pm-execution
/write-prd
|
리서치
pm-market-research
7개 스킬
|
데이터
pm-data-analytics
3개 스킬
|
GTM
pm-go-to-market
/plan-launch
|
성장
pm-marketing-growth
/north-star
|
유틸
pm-toolkit
5개 명령어
|
3. 핵심 기능: 8개 플러그인 상세
8개 플러그인은 PM 업무 라이프사이클 전체를 커버한다. 발견에서 전략, 실행, 런칭, 성장까지. 각 플러그인은 스킬(도메인 지식 블록)과 명령어(스킬을 체이닝하는 워크플로우)로 구성된다.
3.1 pm-product-discovery (13개 스킬, 5개 명령어)
명령어
/discover /brainstorm /triage-requests 외 2개발견 핵심 프레임워크
opportunity-solution-tree— Teresa Torres의 Continuous Discovery Habits 기반 4단계 구조 (Desired Outcome → Opportunities → Solutions → Experiments)continuous-discovery— 지속적 발견 프로세스 가이드
아이디어 발상·검증
brainstorm-ideas— PM, Designer, Engineer 세 관점에서 각각 5개 아이디어 생성identify-assumptions— 아이디어별 핵심 가정 식별prioritize-assumptions— 위험도/검증 비용 매트릭스로 가정 우선순위 결정brainstorm-experiments— 우선 가정에 대한 검증 실험 설계
사용자 리서치
summarize-interview— 사용자 인터뷰 요약 및 인사이트 추출
/discover 체인: brainstorm-ideas → identify-assumptions → prioritize-assumptions → brainstorm-experiments
4개 핵심 스킬에 컨텍스트 파악·발견 계획 수립·다음 단계 제안 등 오케스트레이션이 추가되어 총 7단계 워크플로우로 동작한다.
3.2 pm-product-strategy (12개 스킬, 5개 명령어)
명령어
/strategy /business-model /pricing 외 2개전략 분석 프레임워크
swot-analysis— SWOT 분석 (Strengths, Weaknesses, Opportunities, Threats)ansoff-matrix— Ansoff 성장 매트릭스 기반 전략 도출lean-canvas— Ash Maurya의 Lean Canvas 작성
비즈니스·가치 설계
business-model— 비즈니스 모델 캔버스 설계value-proposition— 가치 제안 캔버스 구축
12개 스킬은 검증된 전략 프레임워크를 구조화한 것이다. /strategy 명령어는 이 스킬들을 상황에 맞게 체이닝하여 전략 캔버스, 경쟁 포지셔닝, 핵심 차별화 요소를 산출한다.
3.3 pm-execution (15개 스킬, 10개 명령어)
명령어
/write-prd /plan-okrs /sprint /write-stories /plan-launch 외 5개
계획 수립
create-prd— 8섹션 PRD 템플릿 (Summary/Contacts/Background/Objective/Market Segment/Value Proposition/Solution/Release)brainstorm-okrs— Christina Wodtke의 Radical Focus 기반 OKR 3세트 생성, KR 3개 권장outcome-roadmap— 아웃풋을 아웃컴으로 변환하는 로드맵 작성user-stories— 3C(Card/Conversation/Confirmation) + INVEST 기준, 스토리당 acceptance criteria 4~6개
실행 관리
sprint-plan— 이론 capacity 70% 기본값, 15~20% 버퍼 예약, Definition of Ready 확인test-scenarios— QA 테스트 시나리오 생성
/plan-okrs 체인: Context 수집 → brainstorm-okrs → 품질 검증 → 표 형식 제시
Objective + KR 표(Baseline/Target/Owner), Alignment Map, Scoring Guide(목표 구간 0.7~0.9)를 산출한다.
/sprint 3가지 모드: plan · retro · release-notes
plan → (스프린트 진행) → retro → release-notes 순서로 자연스럽게 연결된다. retro에서는 Start/Stop/Continue, 4Ls, Sailboat 3가지 포맷을 선택할 수 있다.
/write-stories 3가지 포맷: user · job · wwa
기능 설명이나 PRD를 입력하면 유저 스토리로 분해한다. 완료 후 test scenarios 생성, 스프린트 capacity 추산을 제안한다.
3.4 pm-market-research (7개 스킬, 3개 명령어)
명령어
/research-users /competitive-analysis /analyze-feedback사용자 이해
user-personas— 3개 페르소나 생성, 각각 JTBD/Pain/Gain + One Unexpected Insight + Product Fit Assessment 포함user-segmentation— 사용자 세그먼트 분류customer-journey-map— 7단계 여정 지도 (Awareness → Consideration → Acquisition → Onboarding → Engagement → Retention → Advocacy), 아하 모먼트·이탈 트리거 식별
시장·경쟁 분석
competitor-analysis— 직접 경쟁사 5개 + 간접 경쟁사 2~3개, 포지셔닝 2x2 매트릭스, 12~18개월 리스크 분석market-segments— 시장 세그먼트 분석market-sizing— 시장 규모 추정 (TAM/SAM/SOM)
/research-users 체인: user-personas → user-segmentation + market-segments → customer-journey-map
완료 후 "인터뷰 스크립트 생성할까요?", "세그먼트별 감성 분석할까요?" 등 후속 커맨드를 제안한다.
3.5 pm-data-analytics (3개 스킬, 3개 명령어)
명령어
/write-query /analyze-cohorts /analyze-test데이터 분석 도구
sql-queries— 자연어 → SQL 변환, BigQuery/PostgreSQL/MySQL/Snowflake/SQL Server 다중 dialect, CTE 우선cohort-analysis— CSV/Excel/JSON 데이터 직접 읽기, pandas 분석 스크립트 + 리텐션 히트맵 생성ab-test-analysis— 샘플 사이즈 공식(n = (Z^2 x 2 x p x (1-p)) / MDE^2), scipy.stats Python 스크립트, Ship/Extend/Stop 판단
/write-query: 자연어 질문 → 스키마 파악 → sql-queries 스킬 적용 → SQL 생성
완료 후 "cohort analysis version도 만들까요?"라고 제안하여 /analyze-cohorts로 자연스럽게 연계된다.
3.6 pm-go-to-market (6개 스킬, 3개 명령어)
명령어
/plan-launch /growth-strategy 외 1개GTM 전략 도구
gtm-strategy— Go-to-Market 전략 수립beachhead-segment— 초기 진입 시장 세그먼트 정의ideal-customer-profile— ICP(Ideal Customer Profile) 수립growth-loops— 성장 루프 설계competitive-battlecard— 경쟁사 배틀카드 작성
/plan-launch 체인: beachhead segment 정의 → ICP 수립 → GTM 전략 수립
런칭 준비에 필요한 분석 도구를 순차적으로 체이닝한다. 경쟁 배틀카드와 성장 루프 설계까지 연결된다.
3.7 pm-marketing-growth (5개 스킬, 2개 명령어)
명령어
/market-product /north-star마케팅·포지셔닝
marketing-ideas— 채널·메시지·참여 근거가 포함된 5개 마케팅 아이디어 생성positioning-ideas— 경쟁사 5개 식별, 포지셔닝 갭 분석, 차별화된 포지셔닝 문장 제시value-prop-statements— 태그라인·엘리베이터 피치·랜딩 페이지 히어로 등 컨텍스트별 가치 제안 문장product-name— 브랜드 적합성, 기억성, 도메인·상표 가용성을 고려한 5개 제품 이름 제안
성장 지표
north-star-metric— NSM + 3~5개 입력 지표 정의. 비즈니스를 Attention/Transaction/Productivity 3가지 게임으로 분류 후 7개 검증 기준으로 평가
/market-product 체인: marketing-ideas → positioning-ideas → value-prop-statements → product-name
마케팅 아이디어부터 제품 이름까지 4단계를 체이닝하는 마케팅 툴킷 워크플로우다.
/north-star 체인: NSM 정의 → 입력 지표 식별 → 카운터 지표 설정
6단계 프레임워크로 North Star Metric을 수립한다.
3.8 pm-toolkit (4개 스킬, 5개 명령어)
명령어
/review-resume /proofread 외 3개문서·법률 도구
review-resume— 이력서 리뷰 및 개선 제안draft-nda— NDA(비밀유지계약) 초안 작성privacy-policy— 프라이버시 정책 문서 생성grammar-check— 문법 검사 및 교정
| 플러그인 | 스킬 수 | 명령어 수 | 주요 용도 |
|---|---|---|---|
| pm-product-discovery | 13 | 5 | 아이디어 발견 |
| pm-product-strategy | 12 | 5 | 전략 수립 |
| pm-execution | 15 | 10 | 실행 관리 |
| pm-market-research | 7 | 3 | 시장 조사 |
| pm-data-analytics | 3 | 3 | 데이터 분석 |
| pm-go-to-market | 6 | 3 | GTM 전략 |
| pm-marketing-growth | 5 | 2 | 마케팅/성장 |
| pm-toolkit | 4 | 5 | 실무 도구 |
pm-execution이 15스킬/10커맨드로 가장 크고, pm-data-analytics가 3스킬/3커맨드로 가장 작다. 리소스가 실행 단계에 집중된 구조다. 라이프사이클 전체를 커버하되 각 단계의 깊이가 다르다는 점을 인지하자.
4. 기술 아키텍처 분석
4.1 Skills, Commands, Plugins의 관계
프로젝트의 세 가지 핵심 개념이 있다.
Skills(지식)은 도메인 지식, 분석 프레임워크, 가이드 워크플로우를 담은 빌딩 블록이다. 관련 컨텍스트가 감지되면 자동으로 로드된다. SKILL.md 파일 하나가 하나의 스킬을 정의하며, YAML frontmatter에 name과 description이 필수다. 본문에서는 $ARGUMENTS 플레이스홀더를 통해 사용자 입력을 받는다.
Commands(동사)은 사용자가 /command-name 형태로 호출하는 워크플로우다. 하나 이상의 스킬을 체인으로 연결하여 종단간 프로세스를 실행한다. 예를 들어 /discover는 4개 스킬을 연결한다.
Plugins은 관련 스킬과 명령어를 하나의 패키지로 묶은 단위다. 8개 플러그인이 각각 PM 라이프사이클의 특정 단계를 담당한다.
4.2 명령어 체이닝 메커니즘
체이닝의 핵심은 여러 스킬을 순차적으로 연결하는 것이다. /discover를 예로 들면 다음과 같이 동작한다.
- brainstorm-ideas: 아이디어 발상
- identify-assumptions: 가정 식별
- prioritize-assumptions: 가정 우선순위 결정
- brainstorm-experiments: 실험 설계
실전 인사이트 — 이 체이닝이 의미하는 바는 "PM이 수동으로 해야 할 4단계를 한 명령어로 압축한다"는 것이다. 각 단계의 산출물이 다음 단계의 입력으로 자동 전달되므로, 컨텍스트 손실 없이 워크플로우가 진행된다.
4.3 플러그인 디렉토리 구조
모든 플러그인은 동일한 디렉토리 구조를 따른다.
.claude-plugin/
marketplace.json # 마켓플레이스 매니페스트 (루트 수준)
skills/
skill-name/
SKILL.md # 스킬 정의
commands/
command-name.md # 명령어 정의
README.md # 플러그인 설명주의 — 루트 수준의 메타 파일은 plugin.json이 아닌 marketplace.json이다. pm-skills는 단일 플러그인이 아닌 마켓플레이스 구조로 설계되어 있어, 마켓플레이스 전체를 등록한 뒤 개별 플러그인을 설치하는 2단계 방식을 사용한다. (출처: GitHub 저장소 .claude-plugin/ 디렉토리)
marketplace.json은 마켓플레이스 전체의 메타데이터(버전, 포함된 플러그인 목록 등)를 담고 있으며, skills 디렉토리에 각 스킬이, commands 디렉토리에 각 명령어가 위치한다. 이 구조 덕분에 새로운 스킬이나 명령어를 추가하기 쉽다.
5. SKILL.md 커스터마이징 가이드
PM Skills의 가장 실용적인 장점 중 하나는 스킬을 직접 수정할 수 있다는 것이다. 기본 제공 스킬이 자사 상황에 맞지 않으면 SKILL.md 파일을 편집하면 된다.
5.1 SKILL.md 기본 구조
opportunity-solution-tree 스킬을 예시로 살펴보자.
---
name: opportunity-solution-tree
description: "Build an Opportunity Solution Tree (OST)..."
---
...You are helping a product team build an Opportunity Solution Tree for **$ARGUMENTS**.구조는 간단하다.
- YAML frontmatter:
name과description이 필수다. name은 디렉토리 이름과 일치해야 한다. - $ARGUMENTS: 사용자가 입력한 텍스트가 이 위치에 대입된다.
- 본문: AI 어시스턴트에게 주어지는 프롬프트. 도메인 지식, 분석 절차, 출력 형식 등을 정의한다.
5.2 커스터마이징 예시
예를 들어 create-prd 스킬의 산출물에 자사 PRD 템플릿의 필수 항목을 추가하고 싶다면, 해당 SKILL.md 본문에 지시를 추가하면 된다.
# 본문 끝에 추가하는 예시
## 자사 필수 항목 (커스터마이징)
- 반드시 "보안 요구사항" 섹션을 포함할 것
- "성공 지표"에 OKR 형식(Objective + 3개 Key Results)을 사용할 것
- 한국어로 작성할 것실전 팁 — 수정한 스킬을 팀 저장소에 커밋해두면 팀 전체가 동일한 PM 프로세스를 사용할 수 있다. 품질 검증이 필요하면 프로젝트에 포함된 validate_plugins.py를 실행하면 된다. 이 스크립트는 YAML frontmatter 형식, 스킬-명령어 간 참조 무결성, README 존재 여부 등을 자동 검증한다.
6. 활용법 및 통합 방법
6.1 주요 명령어 사용 시나리오
README에 제시된 대표적인 워크플로우 진입점은 다음과 같다.
| 상황 | 명령어 | 동작 |
|---|---|---|
| 새로운 아이디어가 있다 | /discover |
발견 워크플로우 실행 |
| 전략적 명확성이 필요하다 | /strategy |
전략 수립 워크플로우 실행 |
| PRD를 작성 중이다 | /write-prd |
PRD 작성 워크플로우 실행 |
| 런칭을 계획 중이다 | /plan-launch |
런칭 계획 워크플로우 실행 |
6.2 기타 AI 어시스턴트와의 통합
Claude Code 외에도 SKILL.md 파일 형식이 범용적이므로 다양한 AI 어시스턴트에서 사용할 수 있다. 단, 명령어(Commands, 슬래시 커맨드)는 Claude 전용 기능이므로 다른 AI에서는 스킬만 사용 가능하다.
주의 — 다른 AI 어시스턴트에서는 체이닝 워크플로우가 자동으로 실행되지 않는다. 개별 스킬을 수동으로 호출해야 한다.
7. 사용 예시: PM 워크플로우
7.1 Before/After: 일반 AI 프롬프트 vs PM Skills
같은 요청을 PM Skills 없이 했을 때와 있을 때의 차이를 비교하면 핵심 가치가 명확해진다.
| 일반 프롬프트: "PRD 써줘" | PM Skills: /write-prd |
|---|---|
| - 비구조적 텍스트 덩어리 - 우선순위 기준 없음 - 검증 방법(acceptance criteria) 누락 - 사용자 스토리/테스트 시나리오 미포함 - 매번 결과 형식이 다름 |
- 구조화된 PRD 템플릿 (목표→범위→기능→비기능 요구사항) - RICE/MoSCoW 등 우선순위 프레임워크 적용 - Acceptance Criteria 자동 포함 - user-stories, test-scenarios 스킬 체인으로 연결 - 일관된 형식의 산출물 |
주의 — 위 비교는 PM Skills가 제공하는 구조적 가이드의 차이를 보여주는 것이다. 산출물의 내용적 품질은 사용자가 제공하는 컨텍스트와 AI 모델의 능력에 따라 달라진다. PM Skills가 "완벽한 PRD"를 자동 생성해주는 것은 아니다.
7.2 시나리오: B2B SaaS 대시보드 제품 기획
새로운 제품 아이디어에서 런칭까지 이어지는 전체 PM 워크플로우를 실제 명령어 흐름으로 살펴보자.
Phase 1: 발견 (/discover)
/discover B2B SaaS 팀의 실시간 매출 대시보드. 타깃은 시리즈 A~B 스타트업 CEO/COO.이 명령어는 4개 핵심 스킬(brainstorm-ideas → identify-assumptions → prioritize-assumptions → brainstorm-experiments)을 포함한 7단계 워크플로우를 실행한다.
- Discovery Context 이해 — 제품 컨텍스트 파악
- Brainstorm Ideas — 아이디어 발상 (핵심 스킬 1)
- Identify Assumptions — 가정 식별 (핵심 스킬 2)
- Prioritize Assumptions — 가정 우선순위 결정 (핵심 스킬 3)
- Design Experiments — 실험 설계 (핵심 스킬 4)
- Create Discovery Plan — 발견 계획 수립
- Offer Next Steps — 다음 단계 제안
산출물로는 아이디어 목록, 가정별 위험도/검증 비용 매트릭스, 우선 실행할 실험 설계서, 후속 액션 플랜이 나온다. 각 단계의 출력이 다음 단계의 입력으로 자동 전달되므로 컨텍스트 손실 없이 워크플로우가 진행된다.
Phase 2: 전략 수립 (/strategy)
/strategy B2B SaaS 실시간 매출 대시보드발견 결과를 바탕으로 제품 전략을 수립한다. SWOT 분석, Lean Canvas, Value Proposition 등 12개 전략 스킬 중 상황에 맞는 것을 활용한다. 산출물은 전략 캔버스, 경쟁 포지셔닝, 핵심 차별화 요소 등이다.
Phase 3: PRD 작성 (/write-prd)
/write-prd B2B SaaS 실시간 매출 대시보드 MVP전략을 기반으로 PRD를 작성한다. create-prd, user-stories, test-scenarios 등 15개 실행 스킬이 동원된다. 산출물은 구조화된 PRD 문서, 사용자 스토리 목록, 테스트 시나리오다.
Phase 4: 런칭 계획 (/plan-launch)
/plan-launch B2B SaaS 실시간 매출 대시보드GTM 전략, beachhead segment, ICP 정의 등 6개 GTM 스킬을 활용해 런칭 계획을 수립한다. 산출물은 GTM 전략 문서, ICP 정의서, 경쟁 배틀카드다.
팁 — 각 Phase의 산출물을 별도 파일로 저장해두면, 다음 Phase에서 "이전 단계에서 작성한 [파일명]을 참고해서"라고 컨텍스트를 넘길 수 있다. PM Skills 자체는 Phase 간 자동 연결을 제공하지 않으므로, 사용자가 컨텍스트를 수동으로 이어줘야 한다.
인사이트 — 결정 매트릭스: "언제 어느 명령어를 쓸 것인가"
| PM 상황 | 추천 명령어 | 이유 |
|---|---|---|
| 아이디어만 있는 초기 단계 | /discover |
가정 기반 실험 설계까지 한 번에 |
| 기존 제품의 전략 재수립 | /strategy |
검증된 프레임워크로 빠르게 전략 수립 |
| 기획서 작성 중 | /write-prd |
PRD + 사용자 스토리 + 테스트 시나리오 패키지 |
| 런칭 준비 | /plan-launch |
GTM + ICP + 경쟁 분석 통합 |
8. 제한사항 및 주의사항
사용 전 알아야 할 몇 가지 한계가 있다.
명령어는 Claude 전용이다. 슬래시 커맨드(/discover, /strategy 등)는 Claude Code와 Cowork에서만 작동한다. 다른 AI 어시스턴트에서는 개별 스킬만 사용할 수 있다. 체이닝의 편리함을 포기해야 한다.
Windows 환경 이슈. Cowork의 VM 서비스가 불안정할 수 있다. PowerShell 스크립트로 CoworkVMServiceMonitor를 등록하면 대부분 해결된다고 프로젝트에서 안내하고 있다. Windows 사용자라면 CLI 방식을 우선 고려해보자.
스킬은 AI 모델의 능력에 의존한다. 복잡한 프레임워크(예: Opportunity Solution Tree)를 정확하게 작성하려면 AI 모델이 해당 도메인 지식을 충분히 이해하고 있어야 한다. 스킬은 구조를 제공할 뿐, 내용의 품질은 모델에 달려 있다.
MIT 라이선스지만 책임 소유. Paweł Huryn이 큐레이팅한 오픈소스이므로 자유롭게 사용할 수 있지만, 스킬 내용의 정확성에 대해서는 사용자가 직접 검증해야 한다.
9. 트러블슈팅 Q&A
Q: 플러그인 설치 후 명령어가 인식되지 않는다.
A: Claude Code CLI에서 marketplace를 먼저 추가했는지 확인하자. claude plugin marketplace add phuryn/pm-skills를 실행한 뒤 개별 플러그인을 설치해야 한다. Cowork에서는 Customize > Browse plugins에서 marketplace가 정상적으로 추가되었는지 확인한다.
Q: Windows에서 Cowork가 자꾸 멈춘다.
A: 프로젝트 README에 PowerShell 스크립트로 CoworkVMServiceMonitor를 등록하는 방법이 안내되어 있다. 이 스크립트를 적용하면 "90%의 문제가 해결된다"고 한다. 그래도 해결되지 않으면 CLI 방식을 대안으로 사용하자.
Q: Gemini CLI에서 스킬을 어떻게 쓰나요?
A: 스킬 폴더를 .gemini/skills/ 디렉토리에 복사한다. 단, 명령어 체이닝은 작동하지 않으므로, 개별 스킬을 수동으로 호출해야 한다. 예를 들어 "opportunity-solution-tree 스킬을 사용해서 분석해줘"라고 직접 지시한다.
Q: 기존 플러그인을 수정하고 싶다.
A: 스킬은 SKILL.md 파일이므로 직접 수정할 수 있다. YAML frontmatter의 name과 description을 유지하면서 본문을 원하는 대로 변경하면 된다. CONTRIBUTING.md에 기여 가이드가 있다.
Q: 스킬이 자동으로 로드되지 않는다.
A: Skills는 관련 컨텍스트가 감지될 때 자동 로드된다. 명시적으로 스킬을 호출하려면 스킬 name을 직접 언급하면 된다. 예: "opportunity-solution-tree를 사용해서 분석해줘".
출처
300x250
'AI > Skills' 카테고리의 다른 글
Contents
소중한 공감 감사합니다