关于 add-skill
add-skill 将 GitHub 仓库中的技能导入当前工作区,适合需要本地安装仓库技能的用户;它支持多种 URL 格式,并通过附带脚本获取文件。
主要功能
- 01解析支持的 GitHub 技能 URL
- 02使用附带脚本获取技能
- 03验证已安装的 SKILL.md
- 04将技能安装到工作区
- 05覆盖同名技能前发出警告
适用场景
- 01通过 GitHub URL 添加技能
- 02使用仓库简写安装技能
- 03确认导入的技能已就绪
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ openhands/ extensions --skill add-skill安装后在 Claude Code 中输入/add-skill确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
README.md.plugin/plugin.jsonscripts/fetch_skill.py详细介绍
添加技能
从 GitHub 仓库将技能导入当前工作区。
工作流
当用户请求从 GitHub URL 添加技能时:
- 解析 URL,提取仓库所有者、名称和技能路径
- 使用捆绑脚本获取技能。从此技能的
目录(包含此 SKILL.md 文件的目录)运行脚本:
python3 scripts/fetch_skill.py "<github-url>" "<workspace-path>" - 验证目标位置是否存在 SKILL.md
- 告知用户该技能现已可用
支持的 URL 格式
https://github.com/owner/repo/tree/main/path/to/skillhttps://github.com/owner/repo/skill-namegithub.com/owner/repo/skill-nameowner/repo/skill-name(简写)
示例
用户:/add-skill https://github.com/OpenHands/extensions/tree/main/skills/codereview
# Run the fetch script
python3 scripts/fetch_skill.py "https://github.com/OpenHands/extensions/tree/main/skills/codereview" "/path/to/workspace"
# Verify installation
ls /path/to/workspace/.agents/skills/codereview/SKILL.md
在 Windows 上,如果无法使用 python3,请使用 python,并通过 PowerShell 验证,例如:Test-Path C:\path\to\workspace\.agents\skills\codereview\SKILL.md。
回复:“✅ 已将 codereview 添加到你的工作区。该技能现已可用。”
备注
- 将技能安装在工作区本地的
<workspace>/.agents/skills/<skill-name>/中, 而非全局安装;技能仅在该工作区中可用 - 如果
.agents/skills/目录不存在,则创建该目录 - 使用
GITHUB_TOKEN进行身份验证(私有仓库必需) - 覆盖同名现有技能前会发出警告
评论
支持 Markdown