30秒上手huashu-skills:新手安装避坑指南,含huashu-design同名冲突等5大常见问题

原创2026-10-11 00:16:361,393 阅读

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 花叔开源 Agent Skills 总目录动画

什么是 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」全流程。下面两张就是同一份内容在不同设计风格下的成片效果:

huashu-skills 内置 huashu-slides 的包豪斯风格幻灯片设计示例

huashu-skills 内置 huashu-slides 的敦煌壁画风格幻灯片设计示例

新手安装 5 大常见坑:逐条对照 ✅

坑1:huashu-design 同名冲突,两个版本不能同时装

这是最常见的坑。huashu-design 其实有两个:

  • 独立仓库的旗舰完整版:HTML 原生设计系统,做高保真原型、幻灯片、动画
  • 本仓库内置的轻量版 huashu-design/SKILL.md:只是设计哲学顾问,从 20 种风格里推荐 3 个方向并生成 AI 提示词

两者目录名相同,不能同时装在 ~/.claude/skills/huashu-design/,后装会覆盖先装。如果两个都要:

  1. 先把其中一个目录改名(如内置版改名为 huashu-design-philosophy)
  2. 同时把其 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/ 即可,机制很简单:

  1. 安装留痕:git 安装自带 .git;复制安装的由 Agent 写一份 .huashu-skill-meta.json 记录来源与版本
  2. 超过 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 从此省心可用 🎉

登录后查看全文
huashu-skills