技能安装器Skill skill-installer

---

name: 技能安装器 description: 将 VT Code 技能安装到 $VTCODE_HOME/skills 目录，可以从精选列表或 GitHub 仓库路径安装。当用户要求列出可安装技能、安装精选技能或从其他仓库（包括私有仓库）安装技能时使用。 metadata: short-description: 从 openai/skills 或其他仓库安装精选技能

技能安装器

帮助安装技能。默认情况下，这些技能来自 https://github.com/openai/skills/tree/main/skills/.curated，但用户也可以提供其他位置。

根据任务使用帮助脚本：

• 当用户询问有哪些可用技能时，或如果用户使用此技能而未指定操作时，列出精选技能。
• 当用户提供技能名称时，从精选列表安装。
• 当用户提供 GitHub 仓库/路径（包括私有仓库）时，从另一个仓库安装。

使用帮助脚本安装技能。

通信

• 首先确认任务并运行适当的命令。
• 如果出现问题，报告确切错误并询问下一步操作。
• 只说必要的内容。

脚本

列出精选技能

从精选列表显示可用技能：

scripts/list-curated-skills.py

可选：指定不同的仓库或路径：

scripts/list-curated-skills.py --repo owner/repo --path skills/path --ref branch

输出格式：

• 默认：带安装状态的编号列表
• JSON：--format json 用于编程使用

从精选列表安装

从精选列表按名称安装技能：

scripts/install-skill-from-github.py <技能名称>

技能将被安装到 $VTCODE_HOME/skills/<技能名称>/。

从任何 GitHub 仓库安装

从任何 GitHub 仓库安装技能：

scripts/install-skill-from-github.py owner/repo path/to/skill

对于私有仓库，确保 gh CLI 已认证或设置 GITHUB_TOKEN。

从同一仓库安装多个技能：

scripts/install-skill-from-github.py owner/repo path/to/skill1 path/to/skill2

行为和选项

安装位置

技能默认安装到 $VTCODE_HOME/skills/。环境变量 $VTCODE_HOME 默认为 ~/.vtcode。

私有仓库

对于私有仓库：

1. 确保 GitHub CLI (gh) 已安装并认证：gh auth login
2. 或设置 GITHUB_TOKEN 环境变量

覆盖现有技能

如果同名技能已存在，安装器将：

1. 警告现有技能
2. 在覆盖前请求确认
3. 在替换前备份现有技能

验证

在安装前，脚本验证：

• SKILL.md 存在并具有有效的前置元数据
• 技能名称遵循命名约定
• 没有无效或危险的文件模式

注意事项

• 从 GitHub 安装的技能放置在用户作用域。
• 安装后，技能立即在当前会话中可用。
• 使用 /skills list 验证安装。
• 使用 /skills load <技能名称> 激活技能。