用途：skills-ref 扫描指定的技能目录，将其中的技能信息汇总为 <available-skills> XML 区块并写入 CLAUDE.md，便于在项目指南中集中登记与索引技能。
主要能力：通过 uvx 运行 skills-ref 的 CLI（agentskills），可对技能目录执行 to-prompt 生成提示 XML，并可对每个技能执行 validate 进行校验。生成的区块包含 skill 的 name、ref、description 与 trigger 字段，其中 name 取自技能 frontmatter 的 name，ref 为技能目录相对路径，description 取 frontmatter description 的第一句，trigger 取其余部分（用于说明何时激活）。
使用方式：先确认运行环境，执行 uvx --from skills-ref agentskills --help；若可用，则运行 uvx --from skills-ref agentskills to-prompt {skills_dir}/*/，并可循环执行 uvx --from skills-ref agentskills validate "$skill" 校验各技能。若 uvx 不可用，可安装 uv 后使用，或改用内置脚本 bash skills/skills-ref/scripts/generate-skills-xml.sh {skills_dir}（该替代方式不包含技能校验功能）。使用前需先向用户确认要扫描的技能目录路径与 CLAUDE.md 文件路径，不应假定 skills/ 等默认值，因为不同仓库结构不同（如 .claude/skills/、skills/、packages/{pkg}/.claude/skills/）。
写入规则：若 CLAUDE.md 不存在则新建并包含 Available Skills 区块；若已存在且含有该区块则只替换该区块，若无则在文件末尾追加，且不删除原有内容。
适用场景：为 Claude Code 类项目生成技能索引、登记技能清单、维护 CLAUDE.md 中的可用技能说明。
限制：技能校验功能仅在 uvx 可用时提供，内置脚本替代方式不含校验；其余功能细节、收费与平台支持情况暂未提供。