staruhub/ClaudeSkills · 上手攻略
- 仓库：staruhub/ClaudeSkills
- 链接：https://github.com/staruhub/ClaudeSkills
- 分类：AI Agent · Agent Skills · 工作流自动化
- 作者：Tom
- 更新：2026-08-27
是什么
ClaudeSkills 是13 个精选 Agent Skills 的合集，以开放的 SKILL.md 格式 打包。每一个 Skill 都是一个完整的任务方法包：步骤、模板、脚本、示例、验收标准全部文件化，安装到任何支持 Agent Skills 格式的客户端即可使用。
核心区别：Prompt 用一次就没了，Skill 把方法留下来，可复用、可检查、可改进。
项目发布于 2026-08，版本 1.0.1，MIT 许可证。官方文档站：https://staruhub.github.io/ClaudeSkills/
解决什么问题
- Prompt 不可积累：每次对话从头写，Agent 不知道用什么方法做事。Skill 把方法固化为可复用的工作流定义。
- 跨客户端复用：Skill 格式开放，安装到不同 Agent 客户端（Claude Code、OpenClaw 等），不需要重写。
- 质量有验收：项目自带脚本验证结构、核验路由、跑真实渲染/PPTX 组装，每一步都有据可查。
- 专业场景缺方法：研究、写稿、做 PPT、代码审查、系统设计——这些场景 ClaudeSkills 都有对应的 Skill。
核心 Skill 一览
四大旗舰（功能完整，覆盖完整工作流）
| Skill | 功能 |
|---|---|
deep-research |
研究：定范围→搜集来源→注册引用→输出报告（含参考文献和局限性说明） |
product-manager（grill-me-to-doc） |
产品：先读 repo，每轮只问一个问题，把模糊想法变成产品文档，文档批准前不写代码 |
deck-studio |
PPT：提纲→分页简报→注册布局→视觉检查；可交付内容或逐页可视化 |
wechat-article-writer |
微信公众号文章：文案+图 prompt+HTML 排版，可独立跑也可作为 pipeline 的一部分；不自动发布 |
九个专业 Skill
| Skill | 场景 |
|---|---|
pair-programming |
结对编程，带结构化自审，瞄准常见 AI 代码缺陷 |
security-audit |
代码与依赖安全审计 |
solution-architect |
系统设计、技术选型、架构评审 |
threejs-performance |
Three.js 性能诊断与调优 |
mineru-pdf-parser |
本地 MinerU 安装，PDF 转 Markdown/JSON |
ai-sales-champion |
技术能力→客户能听懂商业价值 |
keqian-method |
单 Agent + SDD + 质量门控的产品开发方法 |
xuefeng-method |
开放行为、模型驱动的 AI-Native 产品方法 |
c-drive-cleaner |
Windows C 盘清理，默认 dry-run |
实验性 Skill（考试准备、天气播报、播客生成等）在 lab/ 目录，不参与精选集校验。
快速安装
安装单个 Skill
# 克隆仓库
git clone --depth 1 https://github.com/staruhub/ClaudeSkills.git
cd ClaudeSkills
# 列出所有可用 Skill
python3 scripts/install_skill.py --list
# 安装任意 Skill（安装到 ~/.agents/skills/）
python3 scripts/install_skill.py deep-research
# 为当前项目安装（Scoped）
python3 scripts/install_skill.py deep-research --project
# 指定客户端目录
python3 scripts/install_skill.py deep-research --client claude-code
手动安装
# 目录名即 Skill 名
cp -r skills/Geek-skills-deep-research ~/.agents/skills/deep-research
更新与卸载
# 更新（git pull 后强制重装）
git pull && python3 scripts/install_skill.py deck-studio --force
# 卸载
rm -rf ~/.agents/skills/deck-studio
核心用法
告诉你的 Agent 用这个 Skill
Use deck-studio to turn this quarterly review into an 8-slide consulting deck
不同客户端触发方式不同： - 自然语言匹配（部分客户端） - 斜杠命令（部分客户端） - 直接指定 Skill 名（最可靠）
⚠️ 如已安装但 Agent 未识别，检查客户端是否扫描
.agents/skills/目录；若不扫描，使用客户端原生的 Skill 目录。
deck-studio 完整流程示例
你：Use deck-studio to turn this quarterly review into an 8-slide consulting deck
Agent：加载 deck-studio skill → 输出结构提纲 → 每页简报 → 注册布局 → 视觉检查 → 交付 8 张幻灯片
deck-studio 自带 4 种风格（Constructivist / Bauhaus / Neubrutalism / Aicher），示例和评分完全在仓库里，可自行 rerun。
核验脚本
# 验证 13 个 Skill 的目录结构符合契约
python3 scripts/validate.py
# 91 个路由 case 核验（Schema / Target / Uniqueness / Conflict）
python3 scripts/run_routing_evals.py
# 4 个旗舰 Skill 的 17 个合约 case（全路径：成功 / 恢复 / 失败）
python3 tests/task_b/run_contract_tests.py
典型适用场景
| 场景 | 推荐 Skill |
|---|---|
| 写研究报告 | deep-research |
| 把想法变成产品文档 | product-manager |
| 制作演示 PPT/幻灯片 | deck-studio |
| 写微信公众号文章 | wechat-article-writer |
| 代码审查（含安全） | security-audit + pair-programming |
| 系统设计和技术选型 | solution-architect |
| PDF 论文提取结构化信息 | mineru-pdf-parser |
| Windows 系统清理 | c-drive-cleaner（dry-run） |
坑与注意
- Skill 需要主动触发：安装后 Agent 不会自动使用，需要在请求里明确说 "Use deck-studio to ..." 才会加载对应 Skill。
- 不同客户端兼容性不同：文档强调默认安装到跨客户端约定的
.agents/skills/，但部分客户端有自己原生的 Skill 目录，需手动指定--client。 - 安装后是副本：git pull 不会自动更新已安装的 Skill，必须手动
--force重装。 - deck-studio 的 PPT 能力：真正渲染 PPTX 和 Chrome 截图需要系统有相应工具，若工具缺失 Skill 会停在内容交付阶段。
- 实验性 Skill 不校验：lab/ 目录下的实验 Skill 跳过了与精选集相同的质量门控，使用前自行评估。
- wechat-article-writer 不自动发布：Skill 只负责生成内容，不会帮你发布到微信公众号。
- c-drive-cleaner 仅 Windows：在其他系统上安装是无操作的空 Skill。
与同类对比
| 项目 | 定位 | 与 ClaudeSkills 的核心区别 |
|---|---|---|
| Anthropic 官方 Skills | Claude Code 内置 | 数量少，不开源自检脚本 |
| mhattingpete/claude-skills-marketplace（同一榜单） | Claude Code Skills 市集 | 侧重软件工程工作流；ClaudeSkills 偏向研究和产品流程 |
| anthropics/skills（上游格式） | Skill 格式定义 | 不是技能合集，是格式规范 |
| rookiestar28/ComfyUI-OpenClaw（同一榜单） | ComfyUI 安全编排 | 无重叠，ClaudeSkills 管 Agent 工作流，OpenClaw 管生成系统 |
| OpenClaw 内置 Skills | OpenClaw 平台 Skill | 平台绑定，ClaudeSkills 跨平台 |
一句话：ClaudeSkills 是目前最完整的开放格式 Agent Skills 合集之一，13 个 Skill 覆盖研究和专业核心场景，核验脚本自证质量，适合想让 Agent 做事有方法、不只是跑一次 prompt 的用户。
一句话推荐结论
把 ClaudeSkills 看成"Agent 的标准方法库"——Deep Research 做研究、deck-studio 做 PPT、security-audit 查代码，Skill 即插即用、跨客户端复用、核验脚本自证，值得加入 Prompt Engineer 和 AI 开发者的工具箱。
⚠️ 数字核验说明：13 个 Skill（4 旗舰+9 专业）数量来自 README；91 个路由 case 来自
run_routing_evals.py自述；17 个合约 case 来自run_contract_tests.py自述；版本 1.0.1 以 GitHub release 为准；各 Skill 路由通过 Schema/Target/Uniqueness/Conflict 四项检查为仓库自称，未独立运行脚本验证。