@shindou/skills-cli

v0.1.36

Published

14 days ago

Search, download and install AI Agent Skills for 30+ coding assistants

0High
0Medium
0Low

shindouhikru

ai agent skills cli coding-assistant

⚡ Skills CLI (@shindou/skills-cli)

✨ 特性

🚀 一键安装：支持从 GitHub 或指定仓库快速安装技能。
📦 多助手适配：自动识别并安装到 30+ 种主流 AI 助手的配置目录。
🔗 智能共享：默认使用符号链接（Symlink），一份存储多处共享，节省空间且同步更新。
🔍 便捷搜索：默认接入 skills.sh 和 GitHub 数据源，快速发现适合你项目的 AI 技能。
⬆️ 本地上传：把本地已安装的 skills 上传到你自己的 GitHub 或任意 Git 远端仓库。
🗑️ 交互式删除：不传参数自动进入多选模式，浏览全部已安装技能并批量删除。
🔎 关键字过滤：删除时支持关键字过滤，快速定位目标技能（--filter 或交互式输入）。
🛠️ 高度可配置：支持项目级和全局配置文件 .skillsrc。

🚀 安装

使用 pnpm 进行全局安装：

pnpm add -g @shindou/skills-cli

安装完成后，你可以通过 skills 命令来调用它。

💡 快速上手

1. 搜索技能

默认会从 skills.sh 搜索公开 skill 目录，也会继续搜索配置中的 GitHub 数据源。展示全部结果，支持并行搜索和相关度排序：

skills search vue
skills s react --limit 20    # 限制只显示 20 条结果

2. 添加数据源

你可以手动把 GitHub 仓库或 skills.sh 地址加入 .skillsrc，后续 search 和按名称 install 都会使用这些数据源：

skills source add https://github.com/owner/repo/tree/main/skills
skills source add https://github.com/owner/repo -p skills
skills source add https://skills.sh -g    # 写入全局配置

3. 上传技能

你可以把本地安装的 skills 上传到自己的 GitHub 或其他 Git 远端仓库。

交互式上传 (推荐)

如果不带参数直接运行 upload，CLI 会引导你完成整个流程：

自动配置：如果尚未配置上传目标，会提示输入 Git URL 并自动保存。
来源选择：让你选择从「项目级」还是「全局」扫描 skills。
多选上传：弹出支持搜索过滤的列表，勾选你想上传的 skills。

skills upload

命令行指定

也可以通过参数直接指定要上传的内容或目标：

# 上传当前项目所有已安装的 skills
skills upload --all

# 上传指定的全局 skills 到特定目标
skills upload vue-testing-best-practices --target personal -g

# 仅查看上传计划 (不执行 push)
skills upload --dry-run

管理上传目标

如果你想手动预先配置多个上传目标：

skills upload target add [email protected]:owner/skills.git --name personal -p skills
skills upload target add https://github.com/owner/skills.git --name work -g

4. 安装技能

安装指定技能时，默认会弹出支持输入过滤的助手多选；配置中的 defaultAgents 会作为预选项：

skills install vue-testing-best-practices

也可以直接安装 skills.sh 页面链接，CLI 会解析为对应的 GitHub 仓库和 skill：

skills install https://skills.sh/anthropics/skills/frontend-design

安装到指定的助手（支持多个）：

skills i vue-testing -a antigravity,claude-code

安装到全局（用户级）目录：

skills i vue-testing -g

显式进入支持输入过滤的交互式选择目标助手：

skills i vue-testing -i

5. 查看已安装

skills list
skills ls -g

6. 卸载技能

直接指定名称删除：

skills uninstall vue-testing-best-practices

不传名称进入交互式多选删除模式（浏览所有已安装技能 → 过滤 → 多选 → 确认）：

skills rm
skills rm -g          # 交互式删除全局技能

使用关键字过滤后再多选删除：

skills rm --filter vue        # 只显示含 "vue" 的技能
skills rm -g -f testing       # 全局技能中过滤 "testing"

7. 可视化管理 (Web UI)

如果你更喜欢通过图形界面来管理你的技能，可以使用 ui 命令启动全屏桌面端管理面板：

skills ui

启动后，你可以在浏览器中（默认 http://localhost:3080）：

全屏概览：清晰查看本项目及全局已安装的所有技能，左右侧边栏导航，沉浸式体验。
双语与主题切换：顶部工具栏支持中文 / English 实时切换，并可在浅色与深色主题间切换。
动态搜索：实时搜索 skills.sh 上的海量技能，支持下拉过滤及本地/全局一键安装。
智能预选：安装时自动读取 .skillsrc 中的 defaultAgents 并智能预选，配备高保定图标及详细源码气泡提示。
仓库管理 (Warehouse)：内置强大的仓库配置面板，支持同时展示和维护项目级、全局级 Git 远程上传目标，并标注目标所属作用域。
配置管理 (Settings)：新增可视化配置编辑器，支持直接编辑并保存「项目级」或「全局级」的 .skillsrc 配置文件。
远端维护：直接在 UI 中浏览各上传目标仓库内的 Skills 列表，支持按项目级或全局级目标一键删除远端仓库技能（自动 Git commit & push）。
交互式操作：所有删除及关键操作均内置精美的二次确认弹窗，配备实时消息通知系统。
极致设计：全 PC 端兼容，采用高保定 AI 助手图标库（本地化集成）及流畅动效，提供桌面级的管理体验。

🛠️ 指令一览

📂 支持的 AI 助手

skills-cli 能够自动识别并支持以下助手的技能存放目录：

...以及更多持续更新中。

⚙️ 配置 (.skillsrc)

你可以通过 skills init 创建配置文件。

{
  "defaultAgents": ["antigravity", "claude-code"],
  "installMode": "link",
  "scope": "project",
  "sources": [
    {
      "type": "skills-sh",
      "url": "https://skills.sh"
    },
    {
      "type": "github",
      "repo": "antfu/skills",
      "path": "skills"
    }
  ],
  "upload": {
    "defaultTarget": "personal",
    "targets": [
      {
        "name": "personal",
        "type": "git",
        "url": "[email protected]:owner/skills.git",
        "path": "skills"
      }
    ]
  }
}

skills.sh 是默认搜索源。即使你的项目级或全局 .skillsrc 自定义了 sources，CLI 也会自动补上 skills.sh，确保 skills search <keyword> 默认可以搜索公开 skill 目录。

upload.targets 使用 Git 远端 URL，鉴权由本机 Git 环境处理，例如 SSH key、Git credential helper 或 GitHub token HTTPS 凭据。path 省略时默认上传到目标仓库的 skills 目录；branch 可选，省略时使用远端默认分支。

📄 开源协议

基于 MIT 协议开源。