bahayonghang/skill-map
content/skills/developer-tools-integrations/skill-map/SKILL.md
Skill map viewer for locally installed skills. Detects the current CLI, resolves that platform's installed-skills root, and renders a stable ASCII overview of installed names, versions, triggerability, and grouping. Use when the user asks what skills are installed on this machine, wants a local skill map, or says '技能地图', '本机 skills', '我装了哪些 skill', 'local skill list', or 'installed skills'. Also use this skill to surface overlap and consolidation suggestions across installed skills — trigger on '哪些 skill 重复', '相似 skill', 'skill 整理', 'skill 去重', '技能瘦身', 'consolidate skills', 'duplicate skills', 'deduplicate skills', or 'similar installed skills'. Do not use it for installable catalogs, registries, or recommendations.
$ install --global
skillsauthnpx skillsauth add bahayonghang/my-claude-code-settings skill-mapInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 24, 2026, 8:10 AM39.7s6 files scanned
SKILL.md
- name:
- skill-map
- description:
- Skill map viewer for locally installed skills. Detects the current CLI, resolves that platform's installed-skills root, and renders a stable ASCII overview of installed names, versions, triggerability, and grouping. Use when the user asks what skills are installed on this machine, wants a local skill map, or says '技能地图', '本机 skills', '我装了哪些 skill', 'local skill list', or 'installed skills'. Also use this skill to surface overlap and consolidation suggestions across installed skills — trigger on '哪些 skill 重复', '相似 skill', 'skill 整理', 'skill 去重', '技能瘦身', 'consolidate skills', 'duplicate skills', 'deduplicate skills', or 'similar installed skills'. Do not use it for installable catalogs, registries, or recommendations.
- version:
- 1.3.0
- category:
- developer-tools-integrations
skill-map: 技能地图
扫描当前机器上的已安装技能目录，生成一目了然的 ASCII 地图。
只面向安装后的技能目录：
- 默认扫描目标：
- 先检测当前 CLI（Claude / Codex / Gemini / Qwen / Kiro / Trae / OpenCode 等）
- 再使用该平台对应的 installed-skills 根目录
- 若检测失败，兜底到共享安装根（通常是
~/.agents/skills）
- builtin/system skills（例如
~/.codex/skills）不进入默认地图 - 不扫描仓库源码目录（如
content/skills/） - 不把 registry 目录（如
content/community-skills-registry/）当作 installable skill - 不用于“帮我找可安装 skill / registry / catalog”这类请求
执行
1. 扫描
运行 Node CLI：
node "$SKILL_DIR/scripts/skill-map.mjs"
调试或测试时可用结构化 JSON：
node "$SKILL_DIR/scripts/skill-map.mjs" --json
node "$SKILL_DIR/scripts/skill-map.mjs" --platform codex
node "$SKILL_DIR/scripts/skill-map.mjs" --json --root ~/.claude/skills --root ~/.agents/skills
JSON 数据字段：
instance_idnameversioninvocabledescsource_categorygroup_keyinstall_root
其中：
instance_id是稳定实例标识，用来区分跨根目录的同名 skillsource_category直接来自 top-level frontmattercategory；缺失时输出空字符串group_key仅基于name + desc的 token-aware 规则推断，用于地图分组desc兼容单行与多行 frontmatterdescription- 缺失
version时输出- user_invocable明确为真时输出true，明确为假时输出false，缺失时输出nullinstall_root用于说明该 skill 来自哪个本地安装根--platform <id>用于显式覆盖当前 CLI 检测
2. 分类
地图分组固定使用 group_key，不直接使用 frontmatter category。
目的：
- frontmatter
category表示技能来源元数据，如仓库目录分类 group_key表示地图里的展示语义分组- 两者必须拆开，避免把
developer-tools-integrations这类来源分类误当成展示分类
分组顺序固定如下：
◆ 认知与分析▲ 文档与表达■ 开发与实现● 工作流与集成★ 系统与维护· 未分类
规则驱动表
| 分组 | 图标 | 建议分组键 | 命中关键词示例 | 说明 |
|------|------|------------|----------------|------|
| 认知与分析 | ◆ | cognitive-analysis | analysis, research, reading, paper, study, learn, summary, interpret | 面向理解、分析、学习、信息提炼 |
| 文档与表达 | ▲ | document-expression | write, document, card, slide, screenshot, theme, format, presentation | 面向文档生成、卡片化、展示与内容包装 |
| 开发与实现 | ■ | development-implementation | code, build, debug, test, refactor, lint, api, script, git | 面向开发、调试、构建、工程执行 |
| 工作流与集成 | ● | workflow-integration | workflow, sync, web, browser, fetch, search, automation, integration | 面向联网、集成、自动化、协作流程 |
| 系统与维护 | ★ | system-maintenance | setup, install, installed, config, memory, inventory, map, deduplicate, cleanup | 面向安装配置、技能管理、维护与元能力 |
| 未分类 | · | uncategorized | 无命中 | frontmatter 与规则都无法判定时的兜底分组 |
约束：
- 规则必须基于 token 归一化与关键词命中，不依赖路径片段或宽松子串误伤
- 无法判定时统一归入
未分类 source_category需要保留原值，但不得覆盖group_key
3. 渲染
用 ASCII 方框图呈现，保持稳定、可重复的布局。
╔══════════════════════════════════════════════════════════╗
║ SKILL MAP · {N} skills installed ║
╠══════════════════════════════════════════════════════════╣
║ ║
║ ◆ 认知与分析 ║
║ +----------------------+-----------------------------+ ║
║ | paper/ v4.3.0 | 论文阅读与分析 | ║
║ | plain v4.0 | 好问题与类比解释 | ║
║ +----------------------+-----------------------------+ ║
║ ║
║ · 未分类 ║
║ +----------------------+-----------------------------+ ║
║ | mystery - | 无法根据元数据判断用途 | ║
║ +----------------------+-----------------------------+ ║
╠══════════════════════════════════════════════════════════╣
║ Total: 12 Invocable: 7 Groups: 5 ║
╚══════════════════════════════════════════════════════════╝
ASCII 输出契约
- 分组按固定顺序输出；空分组可省略，但相对顺序不得变化
- 分组内技能按
name → install_root → instance_id稳定排序 - 名称列左对齐，
invocable = true时在技能名后追加/ - 当同名 skill 来自不同安装根时，在名称列追加根目录标签，避免被误读成同一个实例
- 版本紧随名称展示；缺失显示
- - 描述仅保留单行摘要；超长时截断，避免破坏边界
desc为空时显示无描述- 若没有扫描到任何技能，仍输出完整边框，并在正文显示
No installed skills found under configured skill roots - 若仅有一个技能，仍使用相同模板，不切换为其它格式
- 底部统计行至少包含：
Total、Invocable、Unknown、Groups
4. 输出
直接输出脚本生成的 ASCII 地图：
- 不生成文件
- 不写入磁盘
- 不省略统计信息
- 不把原始 JSON 直接贴给用户，除非用户明确要求
- 不把“本机已安装 skill”误说成“可安装 catalog”
5. 相似度分析（--analyze）
当用户想要清理重复 / 整理技能组合时启用。脚本只生成建议，不删除、不移动、不归档任何文件。
node "$SKILL_DIR/scripts/skill-map.mjs" --analyze
node "$SKILL_DIR/scripts/skill-map.mjs" --analyze --json
node "$SKILL_DIR/scripts/skill-map.mjs" --analyze --min-score 0.4
数据流：
- 按
--json模式一样扫描本地 skill 根目录 - 对每个 skill 的
name + desc (+ tags)做 CJK-aware 分词、去停用词 - 两两计算 Jaccard 相似度
|A ∩ B| / |A ∪ B| --min-score（默认 0.30）之下的 pair 被过滤- 用连通分量把高相似度 pair 合并成簇（至少 2 个成员）
- 根据簇内最高分给出建议动作：
likely-duplicate（≥ 0.75）— 疑似重复consider-merge（≥ 0.50）— 建议合并review（≥ 0.30）— 人工复查
JSON 输出契约：
| 字段 | 类型 | 说明 |
|------|------|------|
| generated_at | ISO-8601 UTC | 生成时间 |
| threshold | number | 实际使用的阈值 |
| summary.total_skills | number | 扫描到的 skill 总数 |
| summary.clusters | number | 输出簇数量 |
| summary.skills_in_clusters | number | 进入簇的 skill 数 |
| summary.likely_duplicates / consider_merge / review | number | 各分档簇数 |
| clusters[].id | string | 稳定的簇 ID（例如 c1） |
| clusters[].action | enum | likely-duplicate / consider-merge / review |
| clusters[].max_score | number | 簇内最高 Jaccard 分数 |
| clusters[].members[] | object | instance_id / name / display_name / install_root / group_key |
| clusters[].shared_tokens | string[] | 最多 8 个共享 token，按频率排序 |
| clusters[].group_keys | string[] | 成员涉及的展示分组键（去重后） |
| clusters[].rationale | string | 同组 / 跨组 / 单 token 重合的解释语 |
| pairs[] | object[] | 全部通过阈值的 pair，包含左右实例 id / display name 及共享 token |
ASCII 报告输出契约：
- 复用主地图的
╔╠╚边框风格 - 按
likely-duplicate → consider-merge → review顺序输出非空段 - 每个簇的首行展示一个成员 + 分数，次行展示第二个成员 + 共享 token 摘要，额外成员逐行列出
- 无相似对时显示
No similar skills detected above threshold <n> - 底部统计行后追加一行
Suggestions only — this tool never deletes, moves, or archives files.
使用合约（交给 Claude 的部分）：
- 把脚本输出视为证据，而不是结论
- 针对每个簇向用户解释：共享了什么 / 为什么判定相似 / 建议做什么（保留 / 合并 / 归档）
- 只有当用户明确同意后才可以进一步操作；本 skill 永远不主动触发删除
- 如果用户询问"哪个该删"，把判断权留给用户：提供比较依据（版本、user_invocable、install_root、所属 group_key），让用户决定
最小验证标准
满足以下条件才算完成：
scripts/skill-map.mjs --json能输出合法 JSON 数组- JSON 中每条记录都包含
group_key、source_category、install_root - JSON 中每条记录都包含稳定的
instance_id - 默认根目录由当前 CLI 检测或共享根兜底决定，而不是固定写死两条路径
group_key只基于name + desc的 token-aware 规则推断，source_category不覆盖它description同时兼容单行与多行 frontmatter，且不会串入其它 frontmatter 字段version缺失时为-，user_invocable缺失时为null- 空目录与单技能场景下，地图渲染规则仍成立
- 默认可跨 Windows、macOS、Linux 运行，不依赖 bash 专用实现
- 同名 skill 跨根目录共存时，不会在扫描阶段被吞掉
scripts/skill-map.mjs --analyze --json输出generated_at / threshold / summary / clusters / pairs字段--analyze下的每个簇都必须包含id / action / max_score / members / shared_tokens / group_keys / rationale- 无相似对时
--analyze仍输出完整边框，并显示No similar skills detected above threshold <n>与不删除承诺
Related Skills
bahayonghang/code-refactor
development
VerifiedTrustedCommunity
Implement safe, behavior-preserving code refactors after inspecting the existing project. Use when the user asks to refactor code, split large files or modules, extract functions or methods, reduce duplicated logic, rename confusing classes/functions/variables, improve code comments, remove unused or dead code, or says 重构代码, 拆分模块, 提取方法, 减少重复代码, 优化命名, 优化注释, 删除未调用代码. For broad refactor requests, plan safe slices and wait for approval; for narrow scoped requests, directly implement the smallest verifiable slice.
15SKILL.mdUpdated Jun 6, 2026
bahayonghang/codex-dynamic-workflows
development
VerifiedTrustedCommunity
Use only when the user explicitly asks for swarm, subagents, parallel agents, dynamic workflow, multi-agent orchestration, 多智能体编排, or when the task truly needs coordinated research plus implementation plus review plus verification packets. Do not use for ordinary code review, planning-only work, single-line bugfixes, routine audits, or migrations unless orchestration is requested or at least two independent workflow dimensions are present.
15SKILL.mdUpdated Jun 4, 2026
bahayonghang/code-quality-review
development
VerifiedTrustedCommunity
Run a code quality review focused on maintainability, structure, abstraction quality, file growth, branching complexity, boundary cleanliness, and refactoring opportunities. Use when the user asks for code quality review, code review, maintainability review, architecture quality review, PR code quality feedback, 代码质量审查, 代码质量 review, 可维护性审查, 架构质量审查, or review comments about code structure. Do not use for pure security review, formatting-only review, performance profiling, or implementation tasks unless the user also asks for a code quality review.
15SKILL.mdUpdated Jun 4, 2026
bahayonghang/spark
development
VerifiedTrustedCommunity
Plan-first brainstorming workflow that turns an idea into an approved Markdown implementation plan by default. Use when the user wants to brainstorm, design, scope, or plan a feature/spec before implementation. Spark explores project context, asks only blocking questions, writes the plan under the project root's .plannings/YYYY-MM-DD-feature-slug.md path, self-reviews it, and waits for user approval. Create an HTML or visual plan/spec only when the user explicitly asks for HTML, browser-viewable, or visual output; save the paired .html beside the Markdown plan.
15SKILL.mdUpdated May 29, 2026