skill-manager

技能管理器

用于在 Claude、Codex 和 Agents 运行时之间统一管理技能生态系统的工具。

可用命令

通过仓库 scripts/ 目录中的 skill-manager.sh 脚本运行这些命令：

# Full audit — runs all checks in one pass
~/.claude/scripts/skill-manager.sh report

# Individual commands
~/.claude/scripts/skill-manager.sh usage          # Show skill usage frequency
~/.claude/scripts/skill-manager.sh usage --top 10  # Top 10 most-used skills
~/.claude/scripts/skill-manager.sh dupes           # Detect redundant/duplicate skills
~/.claude/scripts/skill-manager.sh check           # Verify availability for Claude/Codex/Agents
~/.claude/scripts/skill-manager.sh sync            # Validate repo sync status
~/.claude/scripts/skill-manager.sh update          # Check for npx skill updates
~/.claude/scripts/skill-manager.sh prune           # List candidates for removal

各命令的运行时机

命令	使用时机
report	定期进行完整的健康检查（每周或每月）
usage	清理前查看哪些技能实际在使用
dupes	安装新技能后检查是否有重叠
check	运行 setup.sh 后或发现技能似乎缺失时
sync	编辑技能后验证所有链接是否正确
update	定期检查通过 npx 安装的技能是否有更新版本
prune	技能列表显得臃肿时查找可移除项

使用情况跟踪机制

settings.json 中的 PostToolUse 钩子会在每次使用 Skill 工具时触发，并记录：

• 技能名称
• 时间戳（UTC）
• 项目目录

数据存储在 ~/.claude/skill-usage.jsonl 中（每行一个 JSON 对象）。usage 和 prune 命令会读取这些数据并生成报告。

如何使用此技能

用户询问技能管理相关问题时，运行合适的命令并展示结果。对于一般性问题，运行 report 了解完整情况。

解读结果

• Check：绿色表示链接正常。黄色表示存在意外情况。红色表示链接损坏。
• Sync：验证三个运行时（Claude、Codex、Agents）是否都指向仓库的 skills 目录。
• Dupes：按前缀对技能分组，并检查描述中的关键词重叠情况。重叠度较高（>40%）意味着可以考虑整合。
• Usage：显示调用次数和最近使用日期。“从未使用”的技能可以考虑清理。
• Prune：结合使用情况数据和重叠分析，建议移除项。

归档技能

要归档某个技能（从活动使用中移除，但保留以供参考）：

mv skills/<name> ~/.claude/skills-archive/

这会将其从所有三个运行时中移除（因为它们都通过符号链接指向仓库的 skills/）。