use-external-skills

name	use_external_skills
description	从外部 skills 库（~/.agents/skills）中查找、匹配并加载最合适的 skill 指令。注意：本 skill 专门用于操作外部 skill 库，加载本项目内置 skill 请使用 skill_load

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）

标准使用流程

1. 发现：调用 search_external_skill(query) 描述你的意图，获取推荐 skill
2. 了解：调用 load_external_skill(skill_id) 获取完整 Instructions，加载后必须严格遵循其中指令
3. 查看资产（可选）：调用 list_external_skill_assets(skill_id) 查看是否有可执行脚本
4. 执行脚本（可选）：调用 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 命令，通过已加载的 bash skill 工具完成
• 若无完全匹配，search_external_skill 会返回相关度最高的候选，由 agent 自行判断是否合适