Skill Notes - 给你的技能添加注释

为你的 Claude Code Skills 添加备注和标签，让每个技能一目了然

✨ 核心功能

• 📝 添加注释 - 用自己的话描述每个 skill 是做什么的
• 🏷️ 标签分类 - 给 skills 打标签，快速定位
• 🔍 智能搜索 - 在备注和标签中快速查找
• ⚡ 极简显示 - 一行一个 skill，一眼就能看到作用
• 🌐 中英双语 - 支持中英文命令

📦 安装

方法 1：通过 Git 克隆

cd ~/.claude/skills/
git clone https://github.com/chenhuajinchj/skill-notes.git

方法 2：手动下载

下载本项目并解压到 ~/.claude/skills/skill-notes/

配置别名（可选）

为了在终端直接使用，添加以下内容到你的 shell 配置文件（~/.zshrc 或 ~/.bashrc）：

# Skill Notes 别名
export PATH="$HOME/bin:$PATH"
alias skill='~/.claude/skills/skill-notes/cli/skill-manager'
alias 技能='~/.claude/skills/skill-notes/cli/skill-manager'

然后执行：

source ~/.zshrc  # 或 source ~/.bashrc

🚀 使用方法

在 Claude Code 中使用

直接在对话中说：

"列出我的所有 skills"
"搜索处理视频的 skill"
"查看 humanizer-zh 的详细信息"
"给 document-illustrator 添加备注：需要 Gemini API"

Claude 会自动调用 skill-manager 并展示结果。

在命令行中使用

列出所有 skills

skill-manager 列表
# 或
skill 列表
# 或
技能 列表

输出示例：

humanizer-zh                   去除AI写作痕迹，编辑文章用 [文本, 编辑]
document-illustrator           为文档生成配图，需要Gemini API [图片, 文档]
youtube-clipper                YouTube视频剪辑，双语字幕 [视频, 字幕]

搜索 skills

技能 搜索 "视频"
技能 搜索 "文本" --标签 编辑

查看详细信息

技能 查看 humanizer-zh

输出示例：

名称: humanizer-zh
路径: ~/.claude/skills/Humanizer-zh
官方描述: 去除文本中的 AI 生成痕迹...
我的备注: 去除AI写作痕迹，编辑文章用
标签: 文本, 编辑

配置状态:
  ✅ 无需额外配置

添加备注

技能 备注 humanizer-zh "专门用于去除AI写作痕迹的工具"

管理标签

# 添加标签
技能 标签 humanizer-zh 添加 文本 编辑 AI

# 删除标签
技能 标签 humanizer-zh 删除 AI

查看统计

技能 统计

输出示例：

总 Skills 数: 7
已添加备注: 3
标签总数: 8

常用标签:
  文本: 2 个
  视频: 1 个
  图片: 1 个

📊 数据存储

所有用户数据（备注和标签）存储在：

~/.claude/skills/.skill-manager/notes.json

格式：

{
  "humanizer-zh": {
    "note": "去除AI写作痕迹，编辑文章用",
    "tags": ["文本", "编辑"]
  },
  "document-illustrator": {
    "note": "为文档生成配图，需要Gemini API",
    "tags": ["图片", "文档"]
  }
}

🎯 使用场景

场景 1：快速找到需要的 skill

你想处理一个 YouTube 视频，但不记得 skill 叫什么名字：

技能 搜索 "视频"
# 找到: youtube-clipper

场景 2：检查 skill 配置

想用 document-illustrator，但不确定是否配置好了：

技能 查看 document-illustrator
# 看到配置状态，发现需要设置 GEMINI_API_KEY

场景 3：组织管理 skills

为 skills 添加个人备注和标签，方便分类：

技能 备注 humanizer-zh "去AI痕迹，写文章必备"
技能 标签 humanizer-zh 添加 文本 编辑 常用

🛠️ 技术架构

skill-manager/
├── cli/
│   └── skill-manager        # CLI 可执行文件
├── lib/
│   ├── scanner.py           # 扫描和解析 skills
│   ├── notes.py             # 备注管理
│   ├── core.py              # 核心逻辑
│   └── display.py           # 格式化输出
├── SKILL.md                 # Skill 定义（供 Claude 使用）
└── README.md                # 本文档

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 许可

MIT License

🎯 设计理念

聚焦核心 - 只做两件事：给技能添加注释，用标签分类

极简主义 - 一行显示，一眼就能看到每个 skill 的作用

用户为中心 - 用自己的话描述 skills，按自己的方式组织

---

开始使用：技能 列表 🚀