valkryhx Use External Skills
重要区分
- 加载本项目内置 skill（
skills/目录）→ 使用skill_load <id>- 加载外部 skill（
C:\Users\drago\.agents\skills）→ 使用本 skill 提供的工具
本 skill 从 C:\Users\drago\.agents\skills 目录中动态发现并加载外部 skill 的 Instructions 及脚本资产。
工具一览
| 工具名 | 用途 |
|---|---|
list_external_skills() |
列出全部可用外部 skill 及其描述 |
search_external_skill(query) |
按意图关键词搜索最匹配的外部 skill（返回 top-3） |
load_external_skill(skill_id) |
加载指定外部 skill 的完整 Instructions + 所有附加 .md 文档 |
list_external_skill_assets(skill_id) |
列出该外部 skill 目录下的全部资产（脚本/文档/引用文件） |
run_external_skill_script(skill_id, script_path, args) |
执行该外部 skill 中的脚本（支持 .sh/.js/.ts/.py） |
标准使用流程
- 发现：调用
search_external_skill(query)描述你的意图，获取推荐 skill - 了解：调用
load_external_skill(skill_id)获取完整 Instructions，加载后必须严格遵循其中指令 - 查看资产（可选）：调用
list_external_skill_assets(skill_id)查看是否有可执行脚本 - 执行脚本（可选）：调用
run_external_skill_script(skill_id, "scripts/start-server.sh")运行脚本
示例
# 查找调试相关的外部 skill
search_external_skill("调试代码 bug 根因分析")
→ 推荐: systematic-debugging
# 加载并遵循其 Instructions
load_external_skill("systematic-debugging")
# 查看 brainstorming 的脚本资产
list_external_skill_assets("brainstorming")
→ [script] scripts/start-server.sh
→ [script] scripts/server.js
# 启动 brainstorming 预览服务器
run_external_skill_script("brainstorming", "scripts/start-server.sh", "--project-dir /tmp/demo")
注意事项
- 外部 skill 加载后，其 Instructions 具有与本项目内置 skill 同等的执行优先级
- 若外部 skill 的 Instructions 要求执行 shell 命令，通过已加载的
bashskill 工具完成 - 若无完全匹配，
search_external_skill会返回相关度最高的候选，由 agent 自行判断是否合适