Skills 索引 Wiki

要解决什么问题

Skill 装多了之后，目录名和 frontmatter 很容易对不上实际用途，翻 ~/.cursor/skills-cursor、~/.openclaw/skills 或项目里的 .agents/skills/ 往往只能靠记忆。本技能不是用脚本跑批处理，也不是照抄 skill-creator 去「新建 Skill」；它要求 LLM / Agent 按文档逐步扫描文件，在目标位置写出可维护的 SKILLS_INDEX.md。

核心能力与工作流程

• 扫描范围：可限定某一目录，也可按文档中的 Agent 路径表做全局扫描（如 OpenClaw、Claude Code、Copilot 等常见全局与项目路径）。
• 目录规则：只处理目标下第一层子目录；每个子目录优先读 SKILL.md，否则读 README.md，两者都没有则跳过（文件名大小写不敏感）。
• 增量（默认）：先读已有 SKILLS_INDEX.md 及其生成时间（无时间戳则用索引文件 mtime），只重新解析 mtime 晚于索引的 README/SKILL，其余条目保留，再刷新分类导航与时间戳。
• 全量（--rebuild）：重扫全部第一层子目录，重建完整表格与分类导航。
• 输出内容：技能列表表（名称、描述、文档链接）、按功能（全局时还可按 Agent）组织的快速导航，以及本地时间的索引生成时间。全局扫描时索引写在 Agent 当前工作目录；指定目录时写在该目录下。

适用边界与注意点

• 分类导航可由模型根据内容推断，文档明确说可能需要手工改才贴合真实用法。
• 描述建议控制在约 100 字内；README/SKILL 需为 UTF-8。首次生成前建议备份已有 SKILLS_INDEX.md。
• 用户口语里的「小龙虾」指 OpenClaw，对应 ~/.openclaw/skills/ 与项目 /skills/。