AI导哈

技能管理工具

一个用于管理Claude Code中已安装技能和MCP服务器的CLI工具，支持自由格式的备忘录功能。

  • by aliksir
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 aliksir/skill-memo

使用说明

关于日文版本，请参见 Readme.ja.md.

技能备忘录

一个CLI工具，用于在Claude Code中管理已安装的技能和MCP服务器，并支持自由格式的备忘录。

特性

  • 自动检测 MCP服务器 ~/.claude/settings.json 技能来自 ~/.claude/skills/
  • 手动注册 对于未自动检测到的条目
  • 备注、标签和描述 按条目管理（添加、编辑、删除）
  • 表格格式列表 按类型、标签和源进行过滤，再加上排序
  • AND搜索 跨键、名称、备注、标签和描述字段
  • 出口 Markdown或JSON格式
  • 可通过以下方式用作Claude Code斜线命令 /catalog

安装

git clone https://github.com/aliksir/skill-memo.git
cd skill-memo

没有依赖关系。只需要Node.js 18+。

用作斜线命令

创建 ~/.claude/commands/catalog.md 为了使 /catalog 命令。 看 skills/catalog.md 对于模板。调整路径以匹配您的环境。

用法

命令行界面

# List entries
node bin/skill-memo.js list
node bin/skill-memo.js list --type mcp         # MCP servers only
node bin/skill-memo.js list --type skill       # Skills only
node bin/skill-memo.js list --tag security     # Filter by tag
node bin/skill-memo.js list --sort name        # Sort by name
node bin/skill-memo.js list --sort updated     # Sort by updated date
node bin/skill-memo.js list --json             # Output as JSON array

# Search (AND search, case-insensitive)
node bin/skill-memo.js search security
node bin/skill-memo.js search "security review"
node bin/skill-memo.js search --json memory

# Auto-detect and sync to catalog (shows diff)
node bin/skill-memo.js sync

# Manual add
node bin/skill-memo.js add skill nano-banana --memo "Image generation skill" --tag "image,ai"
node bin/skill-memo.js add mcp filesystem --memo "Filesystem access"

# Update memo (\n for newlines)
node bin/skill-memo.js memo mcp:memory "Line 1\nLine 2"

# Update tags (overwrites existing)
node bin/skill-memo.js tag mcp:memory "security,review"

# Remove
node bin/skill-memo.js remove skill:old-tool

# Export
node bin/skill-memo.js export                  # Markdown table (stdout)
node bin/skill-memo.js export --format json    # Full store as JSON

# Show store file path
node bin/skill-memo.js path

Slash命令(/catalog)

/catalog                          List entries
/catalog sync                     Auto-detect and sync
/catalog add skill foo --memo "memo" --tag "tag1,tag2"
/catalog memo skill:foo "New memo"
/catalog remove skill:foo
/catalog mcp                      MCP servers only
/catalog skill                    Skills only
/catalog search security          Search
/catalog tag skill:foo security   Set tags
/catalog export                   Markdown export
/catalog export --format json     JSON export

关于上下文窗口使用的说明

这 /catalog 和 list 命令以表格式返回所有条目。 在具有许多已安装技能的环境中（例如100+）， 一次调用可能会占用上下文窗口的很大一部分.

缓解措施：

  • 使用 --type mcp / --type skill 缩小输出范围
  • 当你知道你想做什么（添加、编辑、删除）时，跳过 list 并直接使用特定命令
  • 对于频繁的查找，直接在终端中运行CLI（不使用Claude Code的上下文）

克劳德合作支持

也适用于Claude Cowork（无Bash环境）。安装 skill-memo.md 作为一项技能，克劳德将进行手术 skill-catalog.json 直接通过读取/编辑。

cp skill-memo/skill-memo.md ~/.claude/commands/skill-memo.md

在合作中， /skill-memo list, /skill-memo add ...，以及 /skill-memo memo ... 可用。 sync （自动检测）使用简化的基于Glob的方法（不像CLI版本那样解析settings.json）。

数据存储

存储在 ~/.claude/skill-catalog.json.

{
  "version": 2,
  "entries": {
    "mcp:memory": {
      "type": "mcp",
      "name": "memory",
      "source": "auto",
      "memo": "Knowledge graph. Entity management.",
      "tags": ["knowledge", "storage"],
      "description": "Auto-detected description",
      "detectedAt": "2026-03-12T00:00:00.000Z",
      "updatedAt": "2026-03-12T00:00:00.000Z"
    }
  }
}
  • source: auto （自动检测）/ manual （手动注册）
  • sync 不会覆盖现有的备忘录或标签
  • description 自动从每个技能中提取 SKILL.md （同步时更新）
  • v1格式存储会自动迁移到v2（向后兼容）
  • ~/.claude/settings.json 是只读的。此工具从不写入

测试

node test/run.js

74个测试（基于断言，无外部依赖）。

结构

skill-memo/
  bin/skill-memo.js    CLI entry point
  src/store.js         Data store CRUD (schema version management)
  src/detector.js      Auto-detection (settings.json + skills/)
  src/display.js       Table format formatter
  test/run.js          Tests
  skills/catalog.md    Slash command template

许可证

麻省理工学院

相关 MCP