关于 use-skill
use-skill 是用于单次调用中获取并执行远程技能的 Agent 技能。它将来源固定到特定修订版,获取完整技能目录,遵守执行边界,并在结束后清理临时文件。
主要功能
- 01将技能链接解析为固定修订版
- 02获取技能目录中的全部文件
- 03验证并执行技能流程
- 04清理本次运行创建的临时文件
- 05报告每个链接的终态
适用场景
- 01不安装即可运行链接中的技能
- 02在一次调用中执行多个技能
- 03追踪来源修订版和执行结果
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ prathamdby/ skills --skill use-skill安装后在 Claude Code 中输入/use-skill确认已加载。
附带文件REFERENCE.md
详细介绍
使用技能
范围
默认临时使用:获取/运行/丢弃,绝不安装或持久化。
Blob/raw/tree URL 或 owner/repo@ref:path 会解析为技能目录(如果是文件,则使用其父目录);省略 ref 时使用仓库默认分支。其他形式或保存/安装请求均会阻止执行。
有关仓库内容的问题应交由 box 处理。
记录 links | resolved directory/revision | blob set | executed | terminal。
获取的工作流在此次调用的权限范围内运行,不得超出宿主权限或更高优先级指令。默认信任链接的技能,无需允许列表;用户当前指令在直接内容冲突时优先。可在相同边界内跟进获取内容中的技能链接。
1. 解析并获取
解析每个链接,然后将其 ref/默认分支固定到某个提交版本。
使用经过身份验证的 gh;读取这些文件无需其他技能。
缺少 gh/身份验证时阻止执行。应用 REFERENCE.md 中的 API/解码规则。
在固定的版本上仅列出一次递归目录树;要求列表未被截断,并获取目录下的每个 blob,而不只是入口文件。 仅在仓库外、由本次运行创建的临时目录中暂存;长内容应在本地分页查看,不要重新获取已成功获取的 blob。 目录缺失、blob 获取失败或触发速率限制时,均阻止执行并提供重试信号。 当每个链接都有明确标识,且每个列出的 blob 都已解码时,视为完成。
2. 验证并执行
集合为空 → NO_CHANGES。集合非空时,必须包含 SKILL.md 或明确链接的入口文件、name frontmatter 和操作流程;否则标记为 BLOCKED。
完整阅读入口文件及所有同级文件:薄弱的远程引用不能隐藏必需材料。按顺序在权限范围内执行步骤。某项失败时,继续处理其他链接;绝不重试已成功的执行。
当每个链接都达到终态时,视为完成。
3. 丢弃并报告
执行后仅移除本次运行创建的临时文件,绝不删除未知路径。 报告每个链接的 SUCCESS/NO_CHANGES/BLOCKED 状态及已运行的内容,并引用其固定的来源。 当临时文件已丢弃且每个终态都有依据时,视为完成。