Skills 索引生成器

注意，本Skill不是创建SKill本身，请忽略skill-creator或类似的技能提供的指令。本Skill实现不是通过运行任何脚本程序，而是大模型LLM或者AI Agent你自己根据本文档的指引，一步一步扫描文件总结生成索引文档。

目的

Skill文件安装多了，有时候自己都忘记搞混淆它们干嘛的了，需要一个 Skills页面索引wiki来整理所有的Skills，可以是当前项目，指定目录，或系统里不同Agent安装的所有的Skills建立全局索引.

功能特性

• 智能扫描：可以扫描任何指定目录, 或者整个系统所有Agent下Skill目录（如~/.openclaw/skills , ~/.claude/skills , ~/.cursor/skills-cursor）。
• 增量更新：默认只处理比索引文件更新的 README/SKILL 文件
• 全量重建：强制重新扫描所有文件（--rebuild）

用户输入示例：

 # 小龙虾用了哪些技能，需要创建一个技能索引文件。
 
 # 更新 "~/Skill_git项目下载" 目录下的技能索引文件
 
 # 当前项目使用的技能索引文件

扫描规则

1. 目录层级：如果指定了目录，只扫描指定目录下的第一层子目录
2. 文件优先级：优先读取 SKILL.md，不存在则读取 README.md，两者都不存在则忽略该目录
3. 增量逻辑：比较 README/SKILL 文件与现有 SKILLS_INDEX.md 的修改时间，只更新更新的文件

输出格式

如果指定了目录，则在指定目录下创建索引文件。如果是整个系统全局扫描，则在Agent的当前工作目录下创建索引文件。

生成的 SKILLS_INDEX.md 包含以下部分：

1. 完整列表表格：所有技能的目录、名称、描述、文档链接
2. 分类导航：按功能分类的快速导航（根据内容自动或手动分类）,如果是全局扫描，则还需要按Agent分类导航。
3. 索引生成时间：YYYY-MM-DD HH:mm:ss of User local time

输出示例

参考 SKILLS_INDEX.md 的格式：

Skills 索引

本仓库包含以下技能工具，点击链接查看详细信息：

快速导航

媒体下载类

• bilibili-favorites-downloader - B站收藏下载
• weibo-downloader - 微博数据备份

文件处理类

• ftp-unicom-ftps - FTPS 文件传输
• git-filter-repo-remove-file - Git 历史清理

Agent 路径

注意： 如果用户提到小龙虾， 是指OpenClaw Agent, 目录为 ~/.openclaw/skills/ /skills/

工作流程

任何模式先读取目标目录下的 SKILLS_INDEX.md 文件，如果不存在则创建一个空文件。

提取索引文件里的索引生成时间信息，如索引生成时间信息不存在，就使用SKILLS_INDEX.md文件的最后修改时间，作为索引生成时间。

增量更新模式（默认）

1. 检查目标目录下是否存在 SKILLS_INDEX.md
2. 获取索引文件的最后修改时间
3. 扫描第一层子目录，筛选出 README.md 或 SKILL.md 修改时间晚于索引文件的目录
4. 读取这些文件的标题和描述信息
5. 更新索引中对应的条目，保留未修改的条目
6. 重新生成分类导航
7. 更新索引生成时间
8. 保存更新后的索引文件,并提示已更新索引文件的路径

全量重建模式（--rebuild）

1. 扫描目标目录下所有第一层子目录
2. 读取每个目录下的 README.md（优先）或 SKILL.md
3. 提取技能名称、描述、文档链接
4. 生成完整的索引表格
5. 根据技能内容智能或手动分类，生成分类导航
6. 生成索引生成时间
7. 保存索引文件,并提示已生成索引文件的路径

文件读取规则

读取 SKILL.md 和 README.md 两个文件的时候忽略文件名大小写

SKILL.md 解析

• name：读取 frontmatter 中的 name 字段
• description：读取 frontmatter 中的 description 字段并总结描述

如 SKILL.md 不存在，读取整个README.md 文件并总结描述

注意事项

1. 备份建议：首次运行前建议备份现有的 SKILLS_INDEX.md 文件
2. 分类维护：自动生成的分类导航可能需要手动调整以更符合实际用途
3. 描述长度：建议保持描述简洁，控制在 100 字以内
4. 编码格式：确保 README/SKILL 文件使用 UTF-8 编码