tool-discovery

Agent Skills › odysseus-dev/odysseus › tool-discovery

tool-discovery

GitHub

在工具名称、能力或参数不明确时，通过搜索索引和检查 Schema 发现最小可用工具集。避免盲目猜测，优先选择直接工具并验证参数，确保执行前充分确认环境及副作用，提高 Agent 调用工具的准确性。

resources/skills/agent/tool-discovery/SKILL.md odysseus-dev/odysseus

触发场景

任务所需工具的能力或参数不清晰之前因选错工具或参数导致调用失败可选工具较多需要筛选

安装

npx skills add odysseus-dev/odysseus --skill tool-discovery -g -y

更多选项

非标准路径

npx skills add https://github.com/odysseus-dev/odysseus/tree/dev/resources/skills/agent/tool-discovery -g -y

不安装直接使用

npx skills use odysseus-dev/odysseus@tool-discovery

指定 Agent (Claude Code)

npx skills add odysseus-dev/odysseus --skill tool-discovery -a claude-code -g -y

安装 repo 全部 skill

npx skills add odysseus-dev/odysseus --all -g -y

预览 repo 内 skill

npx skills add odysseus-dev/odysseus --list

SKILL.md

Frontmatter

{
    "name": "tool-discovery",
    "tags": [
        "tools",
        "discovery",
        "routing",
        "schemas"
    ],
    "owner": "",
    "source": "builtin",
    "status": "published",
    "created": "2026-08-30T00:00:00Z",
    "version": "1.0.0",
    "category": "agent",
    "confidence": 1,
    "description": "Discover the smallest capable tool set and confirm argument schemas before acting"
}

When to Use

Use when a task requires tools whose names, capabilities, or argument shapes are not already clear. This is especially useful when many tools are available or a previous call failed because the wrong tool or parameters were selected.

Procedure

Translate the request into required capabilities such as reading, searching, editing, executing, browsing, or verifying.
Search the tool index for those capabilities and inspect the returned tool descriptions and schemas.
Prefer one direct tool over a chain of indirect tools when it can complete the operation and provide evidence.
Check required parameters, identifiers, path rules, side effects, and approval requirements before calling the tool.
Make a small read-only probe when the environment or target is uncertain.
Execute the selected action, inspect the result, and only broaden the tool search if the result shows a concrete capability gap.

Pitfalls

Do not guess tool names or argument keys from memory when the index or schema is available.
Do not load unrelated tool groups into context.
Do not repeat the same failed call without changing the arguments or strategy.
Do not use a broad shell or browser workaround when a scoped native tool already owns the operation.

Verification

The chosen tool directly matches the required capability.
Required arguments follow the exposed schema.
The result contains evidence of the requested effect or a specific error that guides the next step.