• 简体中文

      • Claude Code Skills Manager

      介绍

      Claude Code Skills Manager（ccsm）是一个 CLI 工具，用于从基于 Git 的 Marketplace 仓库中发现、安装和管理 Claude Code Skills。你可以将任何公开的、包含 skills.json 清单的 Git 仓库注册为 Skill 来源，然后通过统一的命令行界面搜索、安装、更新和移除 Skills。

      Skills 会被直接部署到 Claude Code 自身的 Skills 目录（~/.claude/skills/）中，Claude Code 启动时会自动加载。

      安装

      预编译二进制
      Cargo 安装
      从源码构建

      从 Releases 页面 下载对应平台的最新二进制文件。

      平台二进制文件
      Linux (amd64)ccsm-linux-amd64
      macOS (amd64)ccsm-darwin-amd64
      Windows (amd64)ccsm-windows-amd64.exe

      将二进制文件放到 PATH 中的某个目录，并重命名为 ccsm（Windows 上为 ccsm.exe）。

      快速开始

      注册 Marketplace

      Marketplace 可以是任何在根目录包含 skills.json 清单的公开 Git 仓库。通过以下命令注册：

      ccsm marketplace add https://github.com/example/skills

      CCSM 会拉取清单并缓存到本地。你可以根据需要注册任意数量的 Marketplace。

      浏览和安装 Skills

      # 搜索所有已注册 Marketplace 中的 Skills
ccsm search

# 通过关键词过滤
ccsm search git

# 按名称安装 Skill
ccsm install my-awesome-skill

# 如果多个 Marketplace 中存在同名 Skill，可指定 Marketplace
ccsm install my-skill --marketplace my-marketplace

      管理已安装的 Skills

      # 列出已安装的 Skills
ccsm list

# 查看已安装 Skill 的详细信息
ccsm info my-awesome-skill

# 更新所有已安装的 Skills 到最新版本
ccsm update

# 更新指定 Skill
ccsm update my-awesome-skill

# 移除 Skill
ccsm remove my-awesome-skill

      Marketplace 管理

      # 列出所有已注册的 Marketplace
ccsm marketplace list

# 刷新缓存的清单（所有 Marketplace）
ccsm marketplace update

# 刷新指定 Marketplace
ccsm marketplace update my-marketplace

# 移除 Marketplace
ccsm marketplace remove my-marketplace

      安装模式

      CCSM 支持两种部署模式：

      模式行为适用场景
      copy（默认）将文件物理复制到 ~/.claude/skills/<name>/日常使用 — 安全且自包含
      link创建指向本地存储的符号链接Skill 开发 — 对源文件的修改会立即生效

      可在配置中设置默认模式，也可在安装时单独指定：

      ccsm install my-skill --link

      自建 Skill Marketplace

      Marketplace 本质上就是一个包含 skills.json 清单的公开 Git 仓库。不需要服务器组件，不需要认证，也不需要 API 密钥 —— CCSM 会直接从 Git 托管平台的 raw 文件端点读取清单。

      Marketplace 仓库结构

      your-marketplace-repo/
  skills.json        # 必需：清单文件
  README.md          # 可选

      skills.json 清单格式

      {
  "name": "My Marketplace",
  "version": "1.0.0",
  "skills": [
    {
      "name": "my-skill",
      "description": "在搜索结果中显示的简短描述",
      "repository": "https://github.com/user/skill-repo",
      "branch": "main"
    },
    {
      "name": "another-skill",
      "description": "位于 monorepo 子目录中的 Skill",
      "repository": "https://github.com/user/monorepo",
      "branch": "main",
      "path": "skills/another-skill"
    }
  ]
}

      顶层字段：

      字段必需说明
      name是Marketplace 的显示名称
      version否用于自行追踪的任意版本号
      skills否Skill 条目数组（默认为 []）

      Skill 条目字段：

      字段必需说明
      name是Skill 的唯一标识符（用于 ccsm install <name>）
      description是在 ccsm search 输出中显示的一行摘要
      repository是Skill 的公开 Git 仓库 URL
      branch否安装时使用的 Git 分支（先尝试 main，再回退到 master）
      path否仓库中 Skill 文件所在的子目录 — 支持单个仓库托管多个 Skills

      工作原理

      1. 清单拉取 — CCSM 根据 Marketplace 仓库 URL 构建 raw 文件 URL，从 main 或 master 分支获取 skills.json。兼容 GitHub、Gitea、GitLab 以及任何提供 raw 文件端点的 Git 托管平台。

      2. Skill 下载 — 当用户安装 Skill 时，CCSM 从 Git 托管平台下载 Skill 仓库的归档文件（ZIP 或 tar.gz），解压后将文件部署到 ~/.claude/skills/<name>/。

      3. Monorepo 支持 — 如果 Skill 条目指定了 path，CCSM 会在解压后进入该子目录再进行部署，从而支持单个仓库托管多个 Skills。

      Skill 仓库的内容

      每个 Skill 仓库都是一个标准的 Claude Code Skill 目录。至少需要包含一个 SKILL.md 清单文件：

      my-skill-repo/
  SKILL.md           # Claude Code Skill 清单
  script.py          # 辅助文件
  templates/
    template.txt

      发布步骤

      1. 创建一个公开的 Git 仓库，在根目录放置符合上述格式的 skills.json。
      2. 推送上去。
      3. 任何人都可以通过 ccsm marketplace add <url> 注册使用。

      数据存储位置

      路径用途
      ~/.claude/skills/Claude Code 的 Skills 目录 —— Skills 的部署目标
      ~/.config/ccsm/config.jsonCCSM 配置文件（已注册的 Marketplace、默认模式）
      ~/.config/ccsm/marketplaces/缓存的 Marketplace 清单
      ~/.config/ccsm/skills/下载的 Skill 文件（本地存储）

      在 Windows 上，~/.config/ 对应 C:\Users\<user>\AppData\Roaming\。

      许可证

      Claude Code Skills Manager 是采用 MIT 许可证发布的开源软件。