用途：扫描本机已安装技能目录，生成稳定的 ASCII 技能地图，便于查看和管理本地技能。
主要能力：先检测当前 CLI（Claude、Codex、Gemini、Qwen、Kiro、Trae、OpenCode 等），再使用该平台对应的 installed-skills 根目录；检测失败时兜底到共享安装根（通常为 ~/.agents/skills）。builtin/system skills 与仓库源码目录不进入默认地图。地图按固定分组顺序（认知与分析、文档与表达、开发与实现、工作流与集成、系统与维护、未分类）渲染，分组基于 name + desc 的 token-aware 规则推断的 group_key，而非 frontmatter category。
使用方式：运行 node "$SKILL_DIR/scripts/skill-map.mjs"。调试可用 --json、--platform codex、--root 等参数。相似度分析用 --analyze，可配合 --json、--min-score。
限制：只面向安装后的技能目录，不用于查找可安装 skill/registry/catalog；不生成文件、不写磁盘；--analyze 只给建议，不删除、不移动、不归档任何文件。缺失事实暂未提供。