@overdoseamp/skill-cli

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

安装

npm install -g @overdoseamp/skill-cli

快速开始

# 查看所有可用技能
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> | — | 移除一个技能 |

使用说明

添加技能

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

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

# 交互式创建
skill add

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

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

# 技能内容

这里是技能的 Markdown 正文。

扫描本地技能

skill scan

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

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

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

安装技能到工具

# 交互式选择技能、目标工具和安装范围
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/ |

搜索技能

skill search typescript
# 或
skill -f typescript

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

移除技能

skill remove my-skill

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

技能存储

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

License

MIT