Skill Memo

技能备忘录

CLI工具，列出已安装在Claude Code中的技能MCP服务器，并提供自由形式的注释。

能做什么

• ~/.claude/settings.json 的MCP服务器和 ~/.claude/skills/ 技能 自动検出
• 将未检测到的条目 手动登録
• 每个条目 备注标签说明 授予、编辑、删除
• 表格格式 一覧表示（按类型、标记、源筛选、可排序）
• AND検索（钥匙、姓名、备注、标签、描述を横断）
• 导出（Markdown / JSON形式）
• Claude Code的斜线命令 /catalog 可调用

安装

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

无依赖包。仅需要Node.js18+。

用作斜线命令

~/.claude/commands/catalog.md 来定义自定义外观 /catalog 中找到最佳实践。 模板为 skills/catalog.md 来修改标记元素的显示属性。根据自己的环境改写路径部分。

使用方法

命令行界面

# 一覧表示
node bin/skill-memo.js list
node bin/skill-memo.js list --type mcp         # MCP サーバーのみ
node bin/skill-memo.js list --type skill       # スキルのみ
node bin/skill-memo.js list --tag security     # タグフィルタ
node bin/skill-memo.js list --sort name        # 名前順
node bin/skill-memo.js list --sort updated     # 更新日順
node bin/skill-memo.js list --json             # JSON配列出力

# 検索（AND検索、大文字小文字無視）
node bin/skill-memo.js search セキュリティ
node bin/skill-memo.js search "security review"
node bin/skill-memo.js search --json memory

# 自動検出 → カタログに同期（差分表示あり）
node bin/skill-memo.js sync

# 手動追加
node bin/skill-memo.js add skill nano-banana --memo "画像生成スキル" --tag "image,ai"
node bin/skill-memo.js add mcp filesystem --memo "ファイルシステムアクセス"

# メモ更新（\nで改行）
node bin/skill-memo.js memo mcp:memory "1行目\n2行目"

# タグ更新（上書き）
node bin/skill-memo.js tag mcp:memory "security,review"

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

# エクスポート
node bin/skill-memo.js export                  # Markdownテーブル（stdout）
node bin/skill-memo.js export --format json    # store全体JSON

# ストアファイルのパス確認
node bin/skill-memo.js path

斜线命令（/catalog）

/catalog                          一覧表示
/catalog sync                     自動検出 → 同期
/catalog add skill foo --memo "メモ" --tag "tag1,tag2"
/catalog memo skill:foo "新しいメモ"
/catalog remove skill:foo
/catalog mcp                      MCP サーバーのみ
/catalog skill                    スキルのみ
/catalog search セキュリティ       検索
/catalog tag skill:foo security   タグ設定
/catalog export                   Markdownエクスポート
/catalog export --format json     JSONエクスポート

上下文消耗注意事项

/catalog 啊 list 命令的输出以表格形式返回所有条目。 在大量安装技能的环境中（例如，100多个）一次调用会占用大量上下文窗口。

対策:

• --type mcp / --type skill 缩小显示
• 备注追加、删除等目的明确时 list 直接插入 add / memo / remove 使用
• 直接在CLI上运行（不占用Claude Code上下文）

Claude Cowork 対応

在Claude Cowork（无Bash环境）中也可以使用。skill-memo.md 作为技能安装后，Claude将在Read/Edit中 skill-catalog.json 中所述修改相应参数的值。

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

在Cowork中 /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": "ナレッジグラフ。エンティティ管理用",
      "tags": ["knowledge", "storage"],
      "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测试（基于assert，不依赖外部）。

构成

skill-memo/
  bin/skill-memo.js    CLI エントリポイント
  src/store.js         データストア CRUD（スキーマバージョン管理）
  src/detector.js      自動検出（settings.json + skills/）
  src/display.js       テーブル形式フォーマッタ
  test/run.js          テスト
  skills/catalog.md    スラッシュコマンドテンプレート

许可证

麻省理工学院