Ver código fonte

fix #47: README 增加安装自检与旧版 skills CLI 兜底说明

实测最新 skills CLI (1.5.19) 已完整同步 references/assets/scripts/demos
子目录,issue 报的「只同步 SKILL.md」是 1.5.15 旧版 bug,上游已修。但旧版
用户照 README 跑会静默丢子目录且无提示。在 README/README.en.md 安装段
补三件事:装完自检(看子目录是否齐全)、旧版识别与升级命令、git clone 兜底。
不改动仓库结构,最小改动消除信息差。

Committed by Macaron-V1-Venti-Coding (via Claude Code)
alchaincyf 1 mês atrás
pai
commit
c9b06710b0
2 arquivos alterados com 24 adições e 0 exclusões
  1. 12 0
      README.en.md
  2. 12 0
      README.md

+ 12 - 0
README.en.md

@@ -55,6 +55,18 @@ npx skills add alchaincyf/huashu-design
 npx skills add alchaincyf/huashu-design
 ```
 
+> **Verify after install**: this skill is more than a single SKILL.md — the `references/`, `assets/`, `scripts/`, and `demos/` subdirectories hold 99 referenced recipes, scripts, and assets that the skill depends on. After installing, check the install path (e.g. `~/.claude/skills/huashu-design/`); if you only see SKILL.md and none of those subdirectories, your `skills` CLI is too old (≤1.5.15 had a bug that synced only the single file, fixed in 1.5.19). Upgrade and reinstall:
+>
+> ```bash
+> npm i -g skills@latest        # or npx skills@latest add alchaincyf/huashu-design
+> ```
+>
+> If it's still wrong after upgrading, fall back to a `git clone` install — clone the repo into any skills directory:
+>
+> ```bash
+> git clone https://github.com/alchaincyf/huashu-design.git ~/.claude/skills/huashu-design
+> ```
+
 Then just talk to Claude Code:
 
 ```

+ 12 - 0
README.md

@@ -67,6 +67,18 @@ npx skills add alchaincyf/huashu-design
 npx skills add alchaincyf/huashu-design
 ```
 
+> **装完先自检**:这个 skill 不只是 SKILL.md 一个文件,`references/`、`assets/`、`scripts/`、`demos/` 四个子目录里有 99 处被引用的配方、脚本、素材,缺一不可。装完看一眼安装目录(如 `~/.claude/skills/huashu-design/`),如果只有 SKILL.md、没有那几个子目录,说明你的 `skills` CLI 版本太旧(≤1.5.15 有个只同步单文件的 bug,已在 1.5.19 修复)。升级后再装一次即可:
+>
+> ```bash
+> npm i -g skills@latest        # 或 npx skills@latest add alchaincyf/huashu-design
+> ```
+>
+> 升级后仍异常,就用 `git clone` 兜底安装,把仓库克隆到任意 skills 目录即可:
+>
+> ```bash
+> git clone https://github.com/alchaincyf/huashu-design.git ~/.claude/skills/huashu-design
+> ```
+
 然后在 Claude Code / Codex / Cursor 等任意支持 skills 的 agent 里直接说话:
 
 ```