tool-discovery

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

tool-discovery

GitHub

在调用工具前发现最小可用工具集并确认参数结构，通过能力映射、索引搜索和模式检查确保选择正确的工具与参数，避免猜测和无效调用。

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

Trigger Scenarios

任务所需工具名称或能力不明确存在多个可用工具需筛选前次调用因选错工具或参数失败

Install

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

More Options

Non-standard path

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

Use without installing

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.