| name | skill-viz |
| description | 可视化 Agent Skills 的仪表盘工具。当你需要查看当前安装了哪些 skills、浏览 skill 的结构和内容、检查 skill 的文件变更时使用此技能。 |
| metadata | {"short-description":"生成 skills 可视化仪表盘 HTML"} |
Skill Visualizer
一个零依赖的 CLI 工具，扫描 Agent Skill 目录并生成可视化的 HTML 仪表盘，用于浏览和管理已安装的 skills。
项目位置
CLI 工具位于 /Users/a/.pi/agent/skills/skill-viz，所有命令需在该目录下执行。
何时使用
- 用户想看当前有哪些 skills 已安装
- 用户想浏览某个 skill 的 SKILL.md、scripts、references 等内容
- 用户问"有哪些 skill"、"skill 列表"、"查看 skills"
- 用户想用可视化界面查看 skills
使用方法
CLI 入口：node /Users/a/.pi/agent/skills/skill-viz/index.js
生成静态 HTML 到当前目录（推荐）
node /Users/a/.pi/agent/skills/skill-viz/index.js --once --no-open --agent pi --output ./pi-skills.html
生成后打开：
open ./pi-skills.html
启动实时服务器（skill 变更自动刷新）
node /Users/a/.pi/agent/skills/skill-viz/index.js --no-open --agent pi --port 48765
告诉用户打开 http://127.0.0.1:48765/，之后新增或修改 skill 文件页面会自动刷新。
常用参数
| 参数 | 说明 |
|---|
--agent pi | 默认选中 Pi agent 的 skill 视图 |
--agent codex | 默认选中 Codex agent 的 skill 视图 |
--agent common | 默认选中 common（共享）skill 视图 |
--once | 生成静态 HTML 文件后退出 |
--no-open | 不自动打开浏览器 |
--output <file> | 指定输出文件路径 |
--port <port> | 指定服务器端口 |
仪表盘功能
生成的 HTML 页面支持：
- Agent 下拉切换（pi / codex / claude / copilot 等）
- 按 skill 名称、描述、脚本内容搜索
- 查看 SKILL.md 渲染后的 Markdown 内容
- 浏览 scripts、references、assets 等资源文件
- 浅色/深色模式切换
- 符号链接检测和标识
注意事项
- 静态 HTML 是快照，新增 skill 后需重新生成
- 实时服务器模式会监听文件变化并自动刷新
- 页面默认选中
--agent 指定的 view，但用户可在界面中切换到其他 agent
