# skill-cli

**Repository Path**: kz_y/skill-cli

## Basic Information

- **Project Name**: skill-cli
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-20
- **Last Updated**: 2026-03-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# @overdoseamp/skill-cli

一个管理和分享 AI agent 技能的 CLI 工具，支持将技能安装到 **Claude Code**、**Cursor**、**OpenCode** 等 AI 编程工具中。

## 安装

```bash
npm install -g @overdoseamp/skill-cli
```

## 快速开始

```bash
# 查看所有可用技能
skill list

# 扫描本地已有的技能文件
skill scan

# 安装技能到目标工具
skill install
```

## 命令一览

| 命令 | 快捷方式 | 说明 |
|------|---------|------|
| `skill list` | `skill -l` | 列出所有可用技能 |
| `skill add [file]` | — | 添加技能（从文件、目录导入，或交互式创建） |
| `skill scan` | `skill -s` | 扫描本地已有的技能文件，多选添加 |
| `skill search <keyword>` | `skill -f <keyword>` | 搜索技能（按名称、描述、内容匹配） |
| `skill install [name]` | `skill -i` | 安装技能到目标工具目录 |
| `skill remove <name>` | — | 移除一个技能 |

## 使用说明

### 添加技能

```bash
# 从文件添加
skill add my-skill.md

# 从目录批量导入
skill add --dir ./my-skills/

# 交互式创建
skill add
```

技能文件为 Markdown 格式，需包含 YAML frontmatter：

```markdown
---
name: my-skill
description: 技能描述
---

# 技能内容

这里是技能的 Markdown 正文。
```

### 扫描本地技能

```bash
skill scan
```

自动扫描以下位置的技能文件：

- `~/.claude/skills/` — Claude Code 全局技能
- `~/.cursor/skills-cursor/` — Cursor 全局技能
- `~/.opencode/agents/` — OpenCode 全局技能
- 当前目录下的 `.claude/skills/`、`.cursor/rules/`、`.cursor/skills-cursor/`、`.opencode/agents/`

扫描结果支持实时搜索过滤和多选添加。

### 安装技能到工具

```bash
# 交互式选择技能、目标工具和安装范围
skill install

# 指定技能名
skill install my-skill

# 指定目标工具和范围
skill install my-skill --tool claude-code --scope global

# 安装所有技能
skill install --all --tool cursor --scope project
```

支持的目标工具和安装路径：

| 工具 | 全局路径 | 项目级路径 |
|------|---------|-----------|
| Claude Code | `~/.claude/skills/` | `.claude/skills/` |
| Cursor | `~/.cursor/rules/` | `.cursor/rules/` |
| OpenCode | `~/.opencode/agents/` | `.opencode/agents/` |

### 搜索技能

```bash
skill search typescript
# 或
skill -f typescript
```

按名称、描述、内容进行关键词匹配，高亮显示匹配结果。

### 移除技能

```bash
skill remove my-skill

# 跳过确认提示
skill remove my-skill --force
```

## 技能存储

- **用户技能**：存储在 `~/.skill-cli/skills/`，通过 `skill add` 添加，不受包更新影响
- **预置技能**：随 npm 包发布，更新包时自动获取最新预置技能

## License

MIT