ai-skills

AI Skill CLI

企业级 Agent Skill 仓库 CLI 工具

从企业 Git 仓库安装和管理 Agent Skills，支持 Cursor、VS Code、Claude Code 等多种编程工具。

功能特性

• ✅ 多工具支持 - 支持 Cursor、VS Code、Claude Code、Codex、Antigravity
• ✅ 自动检测 - 自动检测系统中已安装的编程工具
• ✅ 灵活安装 - 支持项目级和用户级安装路径
• ✅ 格式验证 - 内置技能格式验证器，确保技能符合规范
• ✅ 多种输出 - 支持表格、JSON、简洁文本三种输出格式
• ✅ 交互式模式 - 提供友好的交互式界面选择技能和工具
• ✅ 智能搜索 - 支持按名称、描述、标签搜索技能
• ✅ 批量操作 - 支持批量安装、更新、验证技能
• ✅ 脚本友好 - JSON 输出格式便于脚本和 CI/CD 集成
• ✅ 标准兼容 - 符合 Agent Skills 标准和业界 CLI 最佳实践

快速安装

# 使用 npm
npm install -g ai-skills

# 或使用 pnpm
pnpm add -g ai-skills

# 或使用 yarn
yarn global add ai-skills

快速开始

1. 配置仓库

# 设置企业 Git 仓库地址
ai-skills config set-registry https://github.com/levai/ai-skills

# 或使用本地目录
ai-skills config set-local /path/to/local/skills

2. 检测工具

# 检测系统中已安装的编程工具
ai-skills tools

3. 浏览技能

# 列出所有可用技能（表格格式）
ai-skills ls

# 搜索技能
ai-skills search react

# 查看技能详情
ai-skills show react-best-practices

4. 安装技能

# 安装到所有检测到的工具（推荐）
ai-skills install react-best-practices

# 安装到指定工具
ai-skills install react-best-practices --ai cursor

# 交互式安装（选择技能和工具）
ai-skills install -i

5. 管理技能

# 查看已安装的技能
ai-skills ls --installed

# 更新技能
ai-skills update react-best-practices

# 更新所有技能
ai-skills update --all

# 卸载技能
ai-skills rm react-best-practices

命令概览

命令	功能	示例
config	配置管理	ai-skills config set-registry <url>
install	安装技能	ai-skills install <skill-name>
ls	列出技能	ai-skills ls --installed
search	搜索技能	ai-skills search <keyword>
show	查看详情	ai-skills show <skill-name>
update	更新技能	ai-skills update --all
rm	卸载技能	ai-skills rm <skill-name>
check	验证格式	ai-skills check <skill-path>
tools	检测工具	ai-skills tools

使用场景

项目级安装

在项目目录中安装技能，便于版本控制和团队协作：

cd /path/to/my-project
ai-skills install react-best-practices
# 安装到 .cursor/skills/ 或 .vscode/skills/

用户级安装

安装到用户主目录，所有项目共享：

ai-skills install react-best-practices
# 安装到 ~/.cursor/skills/ 或 ~/.vscode/skills/

批量管理

# 安装所有技能
ai-skills install --all

# 更新所有技能
ai-skills update --all

# 验证所有技能
ai-skills check --all

脚本化使用

# JSON 格式输出，便于脚本处理
ai-skills ls --json | jq '.skills[].name'
ai-skills tools --json | jq '.tools[] | select(.name == "cursor")'

输出格式

表格格式（默认）

ai-skills ls

┌──────────────────────────────────────────────────────────────────────────────┐
│ Skill                                                                        │
├──────────────────────────────────────────────────────────────────────────────┤
│ react-best-practices                                                         │
│ React and Next.js performance optimization                                  │
├──────────────────────────────────────────────────────────────────────────────┤
│ code-review                                                                  │
│ Code review guidelines                                                       │
└──────────────────────────────────────────────────────────────────────────────┘

注意：表格是单列格式，技能名称（青色加粗）和描述（普通文本）在同一列中，用换行分隔。

JSON 格式

ai-skills ls --json

{
  "skills": [
    {
      "name": "react-best-practices",
      "description": "React and Next.js performance optimization"
    }
  ]
}

简洁格式

ai-skills ls --format simple

react-best-practices - React and Next.js performance optimization
code-review - Code review guidelines

系统要求

• Node.js: >= 16.0.0
• npm/pnpm/yarn: >= 7.0.0 / >= 6.0.0 / >= 1.22.0
• Git: 用于从 Git 仓库安装技能

文档

完整文档请查看 docs 目录：

• 使用指南 ⭐ - 完整使用文档，包含所有命令详解、使用场景、最佳实践和故障排除
• 架构分析 - 项目架构和设计分析
• 格式规范 - Skill 格式规范
• 标准参考 - Agent Skills 标准参考
• 设计理念 - 架构设计说明

支持的工具

• Cursor - Cursor IDE
• Claude Desktop - Claude Desktop
• Visual Studio Code - VS Code
• Codex - Codex
• Antigravity - Antigravity

开发

# 克隆仓库
git clone https://github.com/levai/ai-skills-cli.git
cd ai-skills-cli

# 安装依赖
npm install

# 构建
npm run build

# 运行测试
npm test

# 运行 E2E 测试
npm run test:e2e

# 查看测试覆盖率
npm run test:coverage

贡献

欢迎贡献！请查看 CONTRIBUTING.md 了解详细信息。

License

MIT

相关链接

• Agent Skills 标准
• 项目仓库
• 项目 Issues