Skill Browser

帮用户扫描并展示所有已安装的 skills，终端表格为主，按需生成 HTML 页面。

扫描路径

按以下顺序扫描（全部扫描，去重）：

1. 当前项目目录下的 .claude/skills/（从当前工作目录往上找，直到找到 .claude/ 目录）
2. ~/.claude/skills/（全局 skills）
3. ~/.codex/skills/（codex skills，跳过 .system 子目录）

每个目录下，枚举所有子文件夹，读取其中的 SKILL.md 文件。

执行步骤

第一步：收集 skills

用 Bash 找出所有 SKILL.md 路径：

find /path/to/.claude/skills ~/.claude/skills ~/.codex/skills -name "SKILL.md" 2>/dev/null | grep -v '/.system/'

对每个 SKILL.md，提取 frontmatter 中的 name 和 description 字段。用 Python 或 shell 解析即可（frontmatter 格式是 --- 包裹的 YAML）。

第二步：推断分类

根据 description 的语义内容，将每个 skill 归入以下分类之一。这不是关键词匹配，而是理解 skill 的核心用途：

第三步：生成简短描述

从 description 提取或改写出不超过 30 字的中文摘要，突出这个 skill 的核心用途。如果 description 本身是英文，翻译成中文再缩短。

第四步：输出终端表格

用 Python 打印格式整齐的终端表格：

╔══════════════════════╦══════════╦════════════════════════════════╗
║ Skill 名称           ║ 分类     ║ 描述                           ║
╠══════════════════════╬══════════╬════════════════════════════════╣
║ prd                  ║ ✍️ 写作  ║ 生成高质量产品需求文档         ║
║ frontend-design      ║ 🎨 设计  ║ 独特风格的前端视觉设计指导     ║
║ hao-pm-writing       ║ ✍️ 写作  ║ 好PM风格的AI产品长文共创助手   ║
║ skill-creator        ║ 🛠️ 工具  ║ 创建和迭代优化新skill          ║
╚══════════════════════╩══════════╩════════════════════════════════╝
共找到 4 个 skill（项目: 4，全局: 0，codex: 0）

列宽自适应最长内容，不超过终端宽度（默认按 120 列处理）。 名称列最宽 24 字符，分类列固定 10 字符，描述列剩余空间。

表格下方注明来源统计（项目/全局/codex 各多少个）。

第五步：询问是否需要 HTML

表格输出后，询问用户：

"需要生成 HTML 详情页吗？可以在浏览器里查看，支持按分类筛选。"

只有在用户明确说"是"/"要"/"生成"等肯定回答后，才生成 HTML。 如果用户没有回应或说"不用"，直接结束。

生成 HTML（仅按需）

如果用户要求，生成一个单文件 HTML，保存到桌面（~/Desktop/skills-overview.html），然后用 open 打开：

HTML 内容要求：

• 顶部标题 + 当前时间
• 分类筛选按钮（点击只显示该分类）
• 卡片网格布局，每个 skill 一张卡片，显示名称、分类 badge、完整描述、来源路径
• 简洁干净的样式，不依赖外部 CDN

生成后告知用户路径并自动打开。

注意事项

• 如果某个 SKILL.md 解析失败（格式异常），跳过并在末尾提示哪些 skill 无法读取
• 如果完全没有找到任何 skill，友好提示并告知扫描了哪些路径
• 不要在表格里截断中文（中文字符占 2 个显示宽度，需要特殊处理）