vjsp-skills

个人开发者基于skills开发的技能生态系统的 CLI 工具。

支持 VJSP-AI-Code。

安装技能

npx vjsp-skills add vercel-labs/agent-skills

源格式

# GitHub 简写 (owner/repo)
npx vjsp-skills add vercel-labs/agent-skills

# 完整 GitHub URL
npx vjsp-skills add https://github.com/vercel-labs/agent-skills

# 仓库中技能的直接路径
npx vjsp-skills add https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines

# GitLab URL
npx vjsp-skills add https://gitlab.com/org/repo

# 任意 git URL
npx vjsp-skills add [email protected]:vercel-labs/agent-skills.git

# 本地路径
npx vjsp-skills add ./my-local-skills

选项

| 选项 | 描述 | | ------------------------- | --------------------------------------------- | | -g, --global | 安装到用户目录而不是项目目录 | | -s, --skill <skills...> | 按名称安装特定技能（使用 '*' 表示所有技能） | | -l, --list | 列出可用技能而不安装 | | --copy | 复制文件而不是创建到代理目录的符号链接 | | -y, --yes | 跳过所有确认提示 | | --all | 无提示安装所有技能到所有代理 |

示例

# 列出仓库中的技能
npx vjsp-skills add vercel-labs/agent-skills --list

# 安装特定技能
npx vjsp-skills add vercel-labs/agent-skills --skill frontend-design --skill skill-creator

# 安装名称包含空格的技能（必须加引号）
npx vjsp-skills add owner/repo --skill "Convex Best Practices"

# 安装到特定代理
npx vjsp-skills add vercel-labs/agent-skills -a vjsp

# 非交互式安装（CI/CD 友好）
npx vjsp-skills add vercel-labs/agent-skills --skill frontend-design -g -a vjsp -y

# 将仓库中的所有技能安装到所有代理
npx vjsp-skills add vercel-labs/agent-skills --all

# 将所有技能安装到特定代理
npx vjsp-skills add vercel-labs/agent-skills --skill '*' -a vjsp

# 将特定技能安装到所有代理
npx vjsp-skills add vercel-labs/agent-skills --agent '*' --skill frontend-design

安装范围

| 范围 | 标志 | 位置 | 使用场景 | | -------- | ------ | ------------------- | -------------------------- | | 项目 | (默认) | ./<agent>/skills/ | 与项目一起提交，与团队共享 | | 全局 | -g | ~/<agent>/skills/ | 在所有项目中可用 |

安装方法

交互式安装时，您可以选择：

| 方法 | 描述 | | ------------------- | ------------------------------------------------------------ | | 符号链接 (推荐) | 从每个代理创建到规范副本的符号链接。单一事实来源，易于更新。 | | 复制 | 为每个代理创建独立副本。在不支持符号链接时使用。 |

其他命令

| 命令 | 描述 | | --------------------------------- | ------------------------------ | | npx vjsp-skills list | 列出已安装技能（别名：ls） | | npx vjsp-skills find [query] | 交互式或按关键字搜索技能 | | npx vjsp-skills remove [skills] | 从代理中移除已安装技能 | | npx vjsp-skills check | 检查可用的技能更新 | | npx vjsp-skills update | 将所有已安装技能更新到最新版本 | | npx vjsp-skills init [name] | 创建新的 SKILL.md 模板 |

vjsp-skills list

列出所有已安装技能。类似于 npm ls。

# 列出所有已安装技能（项目和全局）
npx vjsp-skills list

# 仅列出全局技能
npx vjsp-skills ls -g

# 按特定代理筛选
npx vjsp-skills ls -a vjsp

vjsp-skills find

交互式或按关键字搜索技能。

# 交互式搜索（fzf 风格）
npx vjsp-skills find

# 按关键字搜索
npx vjsp-skills find typescript

vjsp-skills check / vjsp-skills update

检查技能更新并将所有已安装技能更新到最新版本。

# 检查更新
npx vjsp-skills check

# 更新所有技能
npx vjsp-skills update

vjsp-skills init

# 在当前目录创建 SKILL.md
npx vjsp-skills init

# 在子目录中创建新技能
npx vjsp-skills init my-skill

vjsp-skills remove

从代理中移除已安装技能。

# 交互式移除（从已安装技能中选择）
npx vjsp-skills remove

# 按名称移除特定技能
npx vjsp-skills remove web-design-guidelines

# 移除多个技能
npx vjsp-skills remove frontend-design web-design-guidelines

# 从全局范围移除
npx vjsp-skills remove --global web-design-guidelines

# 仅从特定代理移除
npx vjsp-skills remove --agent vjsp my-skill

# 无确认移除所有已安装技能
npx vjsp-skills remove --all

# 从特定代理移除所有技能
npx vjsp-skills remove --skill '*' -a vjsp

# 从所有代理移除特定技能
npx vjsp-skills remove my-skill --agent '*'

# 使用 'rm' 别名
npx vjsp-skills rm my-skill

| 选项 | 描述 | | -------------- | --------------------------------------- | | -g, --global | 从全局范围（~/）而不是项目移除 | | -a, --agent | 移除特定代理（使用 '*' 表示所有） | | -s, --skill | 指定要移除的技能（使用 '*' 表示所有） | | -y, --yes | 跳过确认提示 | | --all | --skill '*' --agent '*' -y 的简写 |

什么是代理技能？

代理技能是可重用的指令集，用于扩展您的编码代理功能。它们在 SKILL.md 文件中定义，包含 YAML 前置元数据，其中包含 name 和 description。

技能让代理能够执行专门任务，例如：

• 从 git 历史生成发布说明
• 按照团队约定创建 PR
• 与外部工具集成（Linear、Notion 等）

在 skills.sh 发现技能

支持的代理

技能可以安装到以下任何代理：

| 代理 | --agent | 项目路径 | 全局路径 | | ------------ | --------- | --------------- | ----------------- | | VJSP-AI-Code | vjsp | .vjsp/skills/ | ~/.vjsp/skills/ |

CLI 会自动检测您安装了哪些编码代理。如果未检测到任何代理，系统将提示您选择要安装到的代理。

创建技能

技能是包含带有 YAML 前置元数据的 SKILL.md 文件的目录：

---
name: my-skill
description: 此技能的作用以及何时使用它
---

# 我的技能

激活此技能时代理应遵循的指令。

## 何时使用

描述应使用此技能的场景。

## 步骤

1. 首先，执行此操作
2. 然后，执行该操作

必填字段

• name: 唯一标识符（允许小写字母和连字符）
• description: 技能功能的简要说明

可选字段

• metadata.internal: 设置为 true 以从正常发现中隐藏技能。内部技能仅在设置 INSTALL_INTERNAL_SKILLS=1 时可见且可安装。适用于进行中的技能或仅用于内部工具的技能。

---
name: my-internal-skill
description: 默认不显示的内部技能
metadata:
  internal: true
---

技能发现

CLI 在仓库中的以下位置搜索技能：

• 根目录（如果包含 SKILL.md）
• skills/
• skills/.curated/
• skills/.experimental/
• skills/.system/
• .vjsp/skills/

兼容性

VJSP-AI-Code 完全支持 代理技能规范，包括：

• 基本技能
• allowed-tools 配置
• 钩子功能

故障排除

"未找到技能"

确保仓库包含有效的 SKILL.md 文件，前置元数据中包含 name 和 description。

技能未在代理中加载

• 验证技能是否安装到正确路径
• 检查代理文档中的技能加载要求
• 确保 SKILL.md 前置元数据是有效的 YAML

权限错误

确保您对目标目录具有写入权限。

相关链接

• 代理技能规范
• 技能目录
• Vercel 代理技能仓库

许可证

MIT