30秒上手huashu-skills:新手安装避坑指南,含huashu-design同名冲突等5大常见问题
30秒上手huashu-skills:新手安装避坑指南,含huashu-design同名冲突等5大常见问题
huashu-skills 是花叔全部开源 Agent Skills 的总目录,一层目录收齐 52 个 skill:16 个旗舰系统 + 14 个人物视角 + 22 个内置轻量技能,全部采用标准 SKILL.md 格式,Claude Code、Codex、Kimi Code 等支持该格式的 AI Agent 通用。本文用最少的步骤带你完成安装,并提前绕开新手最容易踩的 5 个坑。
什么是 huashu-skills?52 个 Skill 的三层结构
| 层级 | 数量 | 是什么 | 安装方式 |
|---|---|---|---|
| 旗舰 Skills | 16 | 深耕单一领域的完整系统,独立仓库 | git clone 一条命令 |
| 人物视角 Skills | 14 | 女娲蒸馏的思维操作系统(乔布斯、芒格、费曼……) | git clone 一条命令 |
| 内置 Skills | 22 | 轻量内容创作技能,就在这个仓库里 | 复制子目录 |
每个 skill 的仓库名、子目录、分类、关键词都写在机器可读目录 skills.json 里,AI Agent 优先读它来精确定位,不用猜仓库名。人类查目录则直接看 README.md 的「按需求找 Skill」路由表。
30秒快速上手:两种最快安装方式
方式一:一句话让 AI Agent 帮你装(最省事) 💬
把这句话发给你的 Agent:
读 huashu-skills 仓库的 README 和 skills.json,帮我安装(某个 skill / 按我的需求推荐)
Agent 会按 skills.json 里的协议自己完成定位、安装和验证,你只需说清楚想要什么。
方式二:自己动手,一条命令装内置 skill
内置的 22 个轻量 skill 都在本仓库里,克隆后复制需要的子目录即可:
mkdir -p ~/.claude/skills
git clone --depth 1 https://gitcode.com/gh_mirrors/hu/huashu-skills /tmp/huashu-skills
cp -r /tmp/huashu-skills/huashu-slides ~/.claude/skills/
三个通用注意事项:
- 旗舰/人物视角 skill 各自是独立仓库,一条
git clone <仓库地址> ~/.claude/skills/<仓库名>搞定,具体命令见 README.md 的「安装指南」 - 只想给某个项目用?把
~/.claude/skills/换成项目内的.claude/skills/ - 装完必须重启 Agent 会话才生效
内置 Skill 清单:按需求挑选 📋
| 想做的事 | 用这个 Skill |
|---|---|
| 一句话到成品 PPTX,18 种设计风格 | huashu-slides/ |
| Excel 原始数据到专业分析报告 | huashu-data-pro/ |
| 选题:3-4 个方案含标题大纲优劣分析 | huashu-topic-gen/ |
| 结构化调研,每轮搜索落盘不丢成果 | huashu-research/ |
| 三遍审校降低 AI 味 | huashu-proofreading/ |
| 长文转 200-500 字社交帖 | huashu-article-to-x/ |
| 视频大纲 / 封标检查 / 脚本口语化 | huashu-video-outline/、huashu-video-check/、huashu-script-polish/ |
| 公众号 / 小红书配图生成 | huashu-wechat-image/、huashu-xhs-image/ |
| Markdown 转苹果风专业 PDF | huashu-md-to-pdf/ |
| 多 Agent 蜂群并行协作 | huashu-agent-swarm/ |
| 检查已装 skill 是否有新版本 | huashu-skill-updater/ |
以 huashu-slides/ 为例,内置 18 种设计风格,从一句话需求出发完成「内容结构化 → 设计选型 → AI 插画 → 组装 PPTX」全流程。下面两张就是同一份内容在不同设计风格下的成片效果:
新手安装 5 大常见坑:逐条对照 ✅
坑1:huashu-design 同名冲突,两个版本不能同时装
这是最常见的坑。huashu-design 其实有两个:
- 独立仓库的旗舰完整版:HTML 原生设计系统,做高保真原型、幻灯片、动画
- 本仓库内置的轻量版 huashu-design/SKILL.md:只是设计哲学顾问,从 20 种风格里推荐 3 个方向并生成 AI 提示词
两者目录名相同,不能同时装在 ~/.claude/skills/huashu-design/,后装会覆盖先装。如果两个都要:
- 先把其中一个目录改名(如内置版改名为
huashu-design-philosophy) - 同时把其 SKILL.md frontmatter 里的
name字段一起改掉,否则 Agent 识别不到
坑2:把"不是 Skill 的 Skill"装进了 skills 目录
有三个容易混淆、但不该往 skills 目录装的仓库:
huashu-doubao-search是 MCP server(联网搜索),按 MCP 方式配置fanbox是桌面 App- 橙皮书系列(
claude-code-orange-book等)是免费电子书
装错位置不仅不生效,还会干扰 Agent 扫描。拿不准时先查 README.md 的「这三个不是 Skill」一节。
坑3:人物视角 skill 重复安装
14 个人物 skill(乔布斯、芒格、费曼……)在独立仓库和 nuwa-skill/examples/ 里各有一份。只装独立仓库那份即可,重复安装会让 Agent 在两个副本间犹豫,触发不稳定。
坑4:装完了但"没生效"
两个高频原因:
- 没重启会话:skill 是会话启动时加载的,装完必须新开一个 Agent 会话
- 装错了目录:验证标准只有一个——
~/.claude/skills/<skill名>/SKILL.md文件存在。不存在就是没装对
坑5:装完就忘,版本一直落后
花叔的 skill 都在持续迭代,装完不检查等于用过时版本。装上内置的 huashu-skill-updater/ 即可,机制很简单:
- 安装留痕:git 安装自带
.git;复制安装的由 Agent 写一份.huashu-skill-meta.json记录来源与版本 - 超过 30 天没检查过,Agent 使用 skill 时会顺手提醒一次,绝不打扰
保持更新:一条命令检查全部 skill 🔧
装好 updater 后,任何时候执行:
python3 ~/.claude/skills/huashu-skill-updater/scripts/check_updates.py
脚本会扫描所有已装的花叔系 skill,逐个对比远程仓库最新 commit,输出「已最新 / 有更新 / 无法判断」三态报告,并给出对应的更新命令。脚本源码见 huashu-skill-updater/scripts/check_updates.py,每月 1 号定时跑一次即可一劳永逸。
小结:huashu-skills 的安装就两条路径——让 Agent 读 skills.json 自动装,或 git clone + 复制子目录手动装;装完重启会话、确认 SKILL.md 存在、绕开同名冲突,再挂上 updater 定期检查,52 个 skill 从此省心可用 🎉


