本地 Skill 用久了,最大的困扰往往不是“怎么用”,而是“你根本记不清自己到底积累了多少个 Skill”。这些技能文件散落在各个文件夹里,想用的时候找不到,不用又觉得可惜。趁着假期彻底整理了一轮,结果发现攒下的 Skill 数量远超想象——比去年一年做的 Coze 和 n8n 工作流加起来还多。有些 Skill 甚至连最初的功能都快忘了。
于是,我专门做了一个本地 Skill 整理小工具。只需输入一行指令:
使用 $skill-dashboard-builder,将 F:\skill-project\codexskills(Skill 存放路径)生成一个 Skill 能力地图 HTML,输出到 F:\skill-project\output\xfc-ip-steps\skill_dashboard.html(任意路径)
等待几秒,一个直观的可视化页面就自动生成了。页面会清晰展示:
- 当前 Skill 总数量
- 每个 Skill 所属的能力分类(如公众号、小红书、视频、图像等)
- 每个 Skill 的具体能力描述与调用示例
点击任意子模块(比如“公众号漫画”),该分类下的所有 Skill 节点就会集中呈现。
继续点击任意 Skill 节点,还能进一步查看它的使用说明、驱动指令以及存储路径。
如果觉得知识图谱不够直观,还可以一键切换到卡片列表视图,用更传统的方式浏览每个 Skill 的基本信息。
这个工具内置两套视觉样式:一套是清新 ins 风,另一套是暗黑科技风,满足不同场景的审美需求。对于刚入门的朋友来说,它最大的价值在于让你一眼看清自己到底有哪些积累、每个 Skill 该怎么用,彻底告别“囤了却忘了”的尴尬。
2. 技术路线与实现逻辑
制作思路其实非常简洁。先预先做好一个漂亮的 HTML 页面作为参考模板,然后让 Codex 按照这个样式去整理 Skill 信息。给 Codex 的指令也很直接:
写一个 Skill,只要给定 Skill 目录你就能生成同样式布局的页面
整个流程本质上就是一条自动化流水线:
- 遍历用户传入的 Skill 根目录
- 找到每个子目录里的
SKILL.md,读取name、description等字段 - 将这些信息组织成结构化数据
- 生成一个单文件 HTML
- 在 HTML 中渲染统计卡片、分类图表、G6 知识图谱以及卡片列表
简而言之,就是“文件扫描 → 信息抽取 → 分类归纳 → HTML 可视化”这一完整链路。整个流程清晰,指令本身也足够精炼。
当然,这个工具目前只是一个临时方案。虽然页面很直观,但每次新增或修改 Skill 后,都需要重新发一次指令才能刷新页面。更理想的进阶玩法是做一个桌面端工具:将本地 Skill 信息存入数据库,实时监听 Skill 文件夹的变化,一旦有更新,页面自动刷新。这块属于 AI 编程的范畴,后面再单独展开聊。
