mohitagw15856/pm-claude-skills · 上手攻略

• 仓库：mohitagw15856/pm-claude-skills
• 链接：https://github.com/mohitagw15856/pm-claude-skills
• 分类：skill / Claude Code Skills 库 + Agent Prompt 工程（MIT）
• 作者：spark
• 更新：2026-08-12

1. 是什么

pm-claude-skills 是一个 1098 个 Agent Skills 的开源库（README 自报，⚠️ 计数随版本变化请以 SKILLS.md 为准）。这里的 "PM" 含义是 Professional，不只是 Product Management。每个 Skill 是一个 SKILL.md（标准 Anthropic Claude Skills 格式）文件，把一个职业任务做到"资深从业者水准"——它自带框架 + 输出模板 + 质量检查 + 反模式（anti-patterns）四件套。

覆盖领域：产品管理（PRD / RICE / 启动清单）、工程事故（blameless postmortem）、合同解码（lease / medical bill / job offer / severance / insurance / contractor quote / timeshare）、生活模拟器（薪资谈判 / 晋升答辩 / 签证面试 / 论文答辩）、财务计算器（rent vs buy / FIRE / 还债 / 加薪 vs 跳槽）、实时数据（天气 / 汇率 / 加密币 / 航班 / 地震）、生活 admin（搬迁 / 新手父母 / 看护协调）、职业关键时刻（裁员包 / 离职包 / PIP 应对 / 上任 90 天）、历史人物（马基雅维利 / 孙子 / 富兰克林 / 马可奥勒留 / Bennett 1908）、公民服务（残障福利申诉 / 投票 / 应急包 / 灾后恢复）、身心健康（masking-budget / spoon-planner / grief-admin）、桌面游戏 / 爱好 / 数字自卫等。

多平台支持： - Claude Code（原生）； - Hermes Agent； - ChatGPT / Gemini / Cursor / Codex / Windsurf / Cline / Zed / Aider（通过 npx pm-claude-skills add --agent <name> 导出）； - 任意 MCP 客户端（claude mcp add pm-skills -- npx -y pm-claude-skills-mcp）； - 提供 PyPI 包 pm-skills； - 提供 Telegram / Slack / Raycast / Obsidian Plugin 等集成。

⚠️ 1098 这个数字仅来自 README 自述；SKILLS.md 是权威目录，每版可能有差。仓库自带 .github/workflows/skill-audit.yml + conformance/REGISTRY.md 做 CI 审计。

2. 解决什么问题

通用 LLM 在"专业任务"上的三个老毛病：

1. 给的是通识答案：问"我这份租约能不能签"，LLM 给的法律条款解释是教科书水平，无法识别具体合同里的真实陷阱。
2. 缺乏框架：写 PRD 时，LLM 输出一段散文；资深 PM 的 PRD 是有结构（问题 / 目标 / 非目标 / 指标 / 风险）的。
3. 没有反模式：LLM 不会主动告诉你"这么写就是错的"；资深从业者的复盘里"什么不能做"占一半篇幅。

pm-claude-skills 的解法是把每个任务的资深方法论蒸馏成一个 SKILL.md——包含输入清单、决策规则、严重度分级、输出模板、质量自检、反模式清单。所有 1098 个 Skill 都过 SkillSpec L3 gate + CI 安全审计。

3. 快速安装

3.1 Claude Code / Claude.ai（最常用）

# 方式 A：在 Claude Code 中直接装
/plugin
# 搜索 pm-skills，从 Anthropic 官方目录安装（README 原文）

# 方式 B：用 npx 跨平台安装
npx pm-claude-skills add --agent claude

# 方式 C：作为 MCP server（任意兼容客户端）
claude mcp add pm-skills -- npx -y pm-claude-skills-mcp

# 方式 D：仅想试用某个 Skill，先克隆仓库
git clone https://github.com/mohitagw15856/pm-claude-skills.git
cd pm-claude-skills
# 直接浏览 skills/ 目录，挑 SKILL.md 复制粘贴

3.2 上传到 Claude.ai 私有 Skill（Pro / Team / Enterprise）

⚠️ 必需开启 Code Execution and File Creation（Settings → Features），否则无法上传 Skill。

# 单 Skill 打包（注意 .skill = .zip 重命名）
cd pm-claude-skills/skills/prd-template
zip -r prd-template.skill .
mv prd-template.skill ~/Downloads/

# Windows：在文件夹里全选 → 右键 → 发送到压缩(zipped)文件夹 → 改后缀 .skill

随后 claude.ai → Settings → Skills → Upload Skill → 选 .skill 文件。

3.3 不想装任何东西

# Playground 直接在浏览器跑（自带 key 或填你的 key）
https://mohitagw15856.github.io/pm-claude-skills/

# 自然语言找 Skill
https://mohitagw15856.github.io/pm-claude-skills/find.html

4. 核心用法

4.1 在 Claude Code 中调用（最自然）

无需指定 Skill 名称，自然语言会触发 Skill 路由：

"decode this lease before I sign"                  → lease-decoder
"write the PRD for our referral feature"           → prd-template
"blameless postmortem for Friday's outage"         → incident-postmortem
"practice my salary negotiation"                   → salary-negotiation
"why is churn up this quarter?"                    → churn-analysis
"rank the backlog with RICE"                       → rice-prioritisation
"prep me for the visa interview"                   → the-visa-interview
"is this contractor quote fair?"                   → home-contractor-quote-decoder
"draft my self-review honestly"                    → performance-review
"are we ready to launch?"                          → product-launch-checklist
"my inbox is 4,000 deep"                           → email-triage-system

4.2 查看 Skill 目录

# 列所有 Skill
npx pm-claude-skills list

# 或看仓库自带的完整目录
cat pm-claude-skills/SKILLS.md

# 想反查某个 Skill 的 SKILL.md（必须先安装到 Claude Code）
# Anthropic Skills 规范要求 SKILL.md 包含 YAML frontmatter：
#   ---
#   name: ...
#   description: ...
#   ---

4.3 把 Skill 改成你自己的版本

每个 Skill 的 SKILL.md 是纯 Markdown，没有运行时——卸载 = 删文件。仓库鼓励 fork + 自定义：

# 修改 SKILL.md 的 description 字段可调整触发条件
# 反模式段（Anti-patterns）也是必读——它告诉你"资深从业者会避开什么"
# 推荐流程：先 clone → 复制 → 改 description 匹配你的工作流 → 重新打包上传

4.4 跨平台导出

npx pm-claude-skills add --agent cursor      # Cursor
npx pm-claude-skills add --agent codex       # OpenAI Codex CLI
npx pm-claude-skills add --agent windsurf    # Windsurf
npx pm-claude-skills add --agent cline       # Cline
npx pm-claude-skills add --agent aider       # Aider
npx pm-claude-skills add --agent zed         # Zed

ChatGPT / Gemini 用户：从 exports/chatgpt/、exports/gemini/ 复制粘贴即可（README 原文，⚠️ 路径未独立核验——安装 doc 主体讲的是 claude.ai .skill 文件流程，exports 子目录可能是更新机制）。

4.5 MCP 模式（任意 Agent）

claude mcp add pm-skills -- npx -y pm-claude-skills-mcp

之后任何支持 MCP 的客户端都能通过 pm-skills 这个 MCP server 调用全部 Skill。

5. 典型适用场景

• 产品经理 / 项目经理：PRD / 启动清单 / RICE 排序 / 事故复盘 / 用户访谈 / 干系人沟通一站式；
• HR / People Ops：裁员包、离职包、PIP 应对、绩效自评、晋升答辩模拟；
• 个人生活重大节点：租约解码、医疗账单解码、签证面试模拟、rent vs buy、FIRE 计算、go-bag、灾害恢复；
• 神经多样性 / 心理健康：masking-budget、spoon-planner、diagnosis-limbo-kit、grief-admin——这是市面上少见的"边缘需求"Skills 套；
• 跨平台 Agent 开发者：想把 Skills 范式搬到 Cursor / Codex / Windsurf 等其他 IDE，可参考其 exports/ 与 MCP 集成实现；
• Agent Skills 模板作者：每个 Skill 的结构（输入 + 框架 + 模板 + 质量检查 + 反模式）是写好 Skill 的样板；
• 个人 2027 准备：agent-severance / deepfake-drill / agent-hiring-panel / context-bankruptcy / clone-brief 等"agent 时代操作技能"前瞻。

6. 坑与注意

1. Claude.ai 上传 Skill 必须开 Code Execution。Free 计划不支持 Skills（README 明示）；上传的不是 .zip 而是 .skill（重命名后的 zip），且 .skill 内不能含父目录——否则会被 Claude 拒绝。
2. SKILL.md 的 description 字段决定触发条件。如果 Skill 在不该触发的时候触发，或者该触发的时候不触发，唯一改的就是 description。修改后必须重新打包 + 删除旧版 + 上传新版（Claude 不支持热更新）。
3. 1098 这个数字会动。README 自报，且每周新增（agent-severance / clone-brief 等带 🆕 标记的明显是新一批）；统计口径以 SKILLS.md 当前 commit 为准。
4. 闭源贡献 + 社区驱动。贡献者 @uditakhourii 的 parallel-divergent-ideation 研究被作为"人类边缘 Skill 集"灵感来源；README 致谢里点名的赞助 / 引用方较多，但 Skill 本身仍是 MIT。
5. 法律 / 金融类 Skill 不替代专业人士。lease-decoder / medical-bill-decoder / insurance-policy-decoder 等输出的是"读懂合同"的辅助，不是律师意见。重大决定仍需持牌专业人士签字。
6. npx 始终跑最新版——本地无缓存可关闭；离线环境需要先 npm pack 或自托管 npm 镜像。
7. 实时数据 Skill（17 个）走零 API Key 路径：通过 Cloudflare Workers（pm-skills-mcp.pm-claude-skills.workers.dev/today.json）代理，依赖外网可达；GDPR / 合规审查需要确认 worker 域名的数据流（⚠️ 未独立核验 worker 实际部署方与日志策略）。
8. README 中提到的 pm-skills-mcp MCP server 与 pm-claude-skills npm 包是不同 artifact——前者是 MCP 桥，后者是安装器；pm-skills PyPI 包也是另一个发行渠道，看名字易混。
9. Skills 不能"暂时禁用"：Claude.ai 设置里只有"删除 + 重新上传"二态（README troubleshooting 明示）；如果你不想频繁删除/上传，可以先用 Claude Code 的 plugin 开关。
10. CI 安全审计≠ 业务正确性审计：.github/workflows/skill-audit.yml + SkillSpec L3 门控审的是"是否符合 Skill 规范"（frontmatter / 文件结构 / 必含四件套），不是"输出是否准确"；真实质量仍靠用户反馈。

7. 与同类对比

pm-claude-skills 的差异化是"覆盖广度（1098 个）+ 任务结构化（框架 + 模板 + 检查 + 反模式）+ 跨平台导出 + MCP 桥接"——它把 Skills 范式从"Anthropic 闭源目录"变成"一个开源可 fork 的职业方法论库"。相比 awesome-chatgpt-prompts 那种 prompt list，工程化程度高一个数量级。

8. 一句话推荐结论

Skills 范式的开源标杆：如果你用 Claude / Cursor / Codex / Windsurf，强烈建议先 npx pm-claude-skills add；如果只是想批量看几个高价值方法论，README 列的 10+ 个 Skill 直接挑感兴趣的复制粘贴即可——每个 SKILL.md 都设计成"人能直接读懂"。

原始链接：

• 仓库：https://github.com/mohitagw15856/pm-claude-skills
• 安装文档：https://github.com/mohitagw15856/pm-claude-skills/blob/main/docs/installation.md
• Skill 总目录：https://github.com/mohitagw15856/pm-claude-skills/blob/main/SKILLS.md
• SkillSpec：https://github.com/mohitagw15856/pm-claude-skills/blob/main/SKILLSPEC.md
• Playground：https://mohitagw15856.github.io/pm-claude-skills/
• 搜索 Skill：https://mohitagw15856.github.io/pm-claude-skills/find.html
• npm 包：https://www.npmjs.com/package/pm-claude-skills
• PyPI 包：https://pypi.org/project/pm-skills/
• License：MIT（https://github.com/mohitagw15856/pm-claude-skills/blob/main/LICENSE）
• 安全审计 CI：https://github.com/mohitagw15856/pm-claude-skills/blob/main/.github/workflows/skill-audit.yml

⚠️ commit SHA / 版本号标注：仓库使用"1098"作为动态 Skill 数量描述，新增频繁；安装 / 引用前请以 SKILLS.md 当前 commit 内容为准。所有外链已通过 GitHub HTML / raw.githubusercontent.com 验证（fetch 时间 2026-08-12），但 exports/chatgpt/ 与 exports/gemini/ 子路径未独立打开（仅 README 索引提及）。