---
title: Claude Code Skills Manager
---

import { Tabs, Tab } from "@rspress/core/theme"

## 介绍

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

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

## 安装

<Tabs>
  <Tab label="预编译二进制">
    从 [Releases 页面](https://onixbyte.dev/onixbyte/claude-code-skill-manager/releases) 下载对应平台的最新二进制文件。

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

    将二进制文件放到 `PATH` 中的某个目录，并重命名为 `ccsm`（Windows 上为 `ccsm.exe`）。
  </Tab>
  <Tab label="Cargo 安装">
    ```bash
    git clone https://onixbyte.dev/onixbyte/claude-code-skill-manager.git
    cd claude-code-skill-manager
    cargo install --path .
    ```
    需要 Rust 工具链（通过 [rustup.rs](https://rustup.rs) 安装）。
  </Tab>
  <Tab label="从源码构建">
    ```bash
    git clone https://onixbyte.dev/onixbyte/claude-code-skill-manager.git
    cd claude-code-skill-manager
    cargo build --release
    ```
    二进制文件位于 `target/release/ccsm`（Windows 上为 `ccsm.exe`）。
  </Tab>
</Tabs>

## 快速开始

### 注册 Marketplace

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

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

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

### 浏览和安装 Skills

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

# 通过关键词过滤
ccsm search git

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

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

### 管理已安装的 Skills

```bash
# 列出已安装的 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 管理

```bash
# 列出所有已注册的 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 开发 — 对源文件的修改会立即生效 |

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

```bash
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` 清单格式

```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.json` | CCSM 配置文件（已注册的 Marketplace、默认模式） |
| `~/.config/ccsm/marketplaces/` | 缓存的 Marketplace 清单 |
| `~/.config/ccsm/skills/` | 下载的 Skill 文件（本地存储） |

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

## 许可证

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