# skills-hub-cli

**Repository Path**: dfzp7777/skills-hub-cli

## Basic Information

- **Project Name**: skills-hub-cli
- **Description**: Generic skills of management tools, support mainstream Agent platform, including Claude Code, Cursor, Trae, Qoder, CodeBuddy, etc
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-04-08
- **Last Updated**: 2026-04-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Skills Hub CLI

[English Documentation](./README.md)

一个用于管理多个 AI IDE 技能的命令行工具。Skills Hub 让你可以轻松地添加、查看和移除常用 AI 开发环境中的技能。

## 支持的 AI IDE

- Claude Code
- Cursor
- Trae
- OpenCode
- Gemini CLI
- Windsurfer
- Qoder
- CodeBuddy

![Skills Hub CLI](https://gitee.com/kesanai/skills-hub-cli/raw/master/snapshot-cli.png)

## 安装

### 通过 npm 安装（推荐）

```bash
npm install -g skills-hub-cli
```

## 使用说明

### 添加技能

从 Git 仓库添加技能到你的 AI IDE。

```bash
skills-hub add <repo-url> --skill <skill-name>
```

**参数：**
- `repo-url`: 仓库 URL (GitHub、Gitee、GitLab 等)

**选项：**
- `-s, --skill <name>`: 要添加的技能名称（可以添加多个技能）

**示例：**

```bash
# 添加单个技能
skills-hub add https://github.com/user/repo --skill skill-name

# 例如：
skills-hub add https://gitee.com/kesanai/skills --skill user-prompt-log

# 一次添加多个技能
skills-hub add https://github.com/user/repo --skill skill1 --skill skill2 --skill skill3

# 添加多个技能 Anthropics 技能仓库
skills-hub add https://github.com/anthropics/skills --skill pptx --skill docx
```

**交互式提示：**
1. 选择目标 AI IDE（8 个可用选项）
2. 选择安装范围：
   - Current Project (当前项目)：安装到项目特定目录
   - Global (全局)：安装到用户的全局目录（适用于支持全局配置的 AI IDE）

**注意：** 仓库会被缓存到 `~/.skills-hub/repos/` 以加快未来的安装速度。

### 创建技能包

创建一个包含标准目录结构和示例文件的新技能包。

```bash
skills-hub create <skill-name>
```

**参数：**
- `skill-name`: 技能包名称（仅限小写字母、数字和连字符）

**示例：**

```bash
skills-hub create my-awesome-skill
```

**生成的目录结构：**
```
my-awesome-skill/
├── SKILL.md             # 元数据与说明文档
├── scripts/             # 辅助脚本目录
│   └── helper.py        # 脚本示例
├── references/          # 技术文档目录
│   └── guide.md         # 文档示例
└── assets/              # 静态资源目录
```

### 列出技能

列出项目级或全局已安装的技能。

```bash
skills-hub list [options]
```

**选项：**
- `-a, --all`: 列出所有已安装的技能（包括全局技能）

**示例：**

```bash
# 仅列出项目级技能
skills-hub list

# 列出所有技能（项目级和全局）
skills-hub list --all
```

**输出：**
- 技能按 AI IDE 分组
- 分别显示项目技能和全局技能
- 显示每个类别的总数

### 移除技能

从你的 AI IDE 中移除已安装的技能。

```bash
skills-hub remove <skill-names...> [options]
```

**参数：**
- `skill-names`: 要移除的技能名称（可以指定多个）

**选项：**
- `-f, --force`: 跳过确认提示
- `-a, --agent <name>`: 指定从哪个 AI IDE 移除技能

**示例：**

```bash
# 移除单个技能（需要确认）
skills-hub remove skill-name

# 移除多个技能
skills-hub remove skill1 skill2 skill3

# 强制移除（无需确认）
skills-hub remove skill-name --force

# 从特定 AI IDE 移除技能
skills-hub remove skill-name --agent cursor

# 从特定 AI IDE 强制移除多个技能
skills-hub remove skill1 skill2 --agent trae --force
```

**行为：**
- 如果指定了 `--agent`，则只移除该 AI IDE 下的技能
- 如果多个 AI IDE 有相同名称的技能，使用 `--agent` 来指定具体的 IDE
- 显示已移除、失败和未找到的技能摘要

## 目录结构

### 项目级技能

安装到项目的技能存储在项目目录中：

```
your-project/
├── .claude/
│   └── skills/
│       └── skill-name/
├── .cursor/
│   └── skills/
│       └── skill-name/
└── .trae/
    └── skills/
        └── skill-name/
```

### 全局技能

全局技能存储在用户的主目录中：

```
~/.claude/skills/skill-name/
~/.cursor/skills/skill-name/
~/.trae/skills/skill-name/
```

### 仓库缓存

克隆的仓库缓存于：

```
~/.skills-hub/repos/
└── user@repo/
```

## 功能特性

- **多 IDE 支持**：管理 8 种不同 AI IDE 的技能
- **项目与全局范围**：支持项目级或全局安装技能
- **批量操作**：一次添加或移除多个技能
- **仓库缓存**：高效缓存以避免重复克隆
- **指定 Agent 操作**：移除技能时可指定目标 AI IDE
- **交互式提示**：友好的命令行界面
- **详细反馈**：清晰的进度指示和错误信息

## 技能仓库

1. https://github.com/anthropics/skills
2. https://github.com/expo/skills
3. https://github.com/obra/superpowers
4. https://github.com/softaworks/agent-toolkit
5. https://github.com/cloudflare/skills

更多...

## 许可证

查看 [LICENSE](./LICENSE) 文件。


## 贡献

欢迎贡献代码！请随时提交 Pull Request。