tool-discovery

Tool Discovery: Finding and Inspecting Tools

This skill teaches you how to find the tools you can use before you write a new one. Reusing an existing, approved tool is always faster and safer than creating one.

Where Tools Come From

1. Core tools — shipped with Matimo: calculator, web, read, search, edit, execute and others, plus the matimo_* meta-tools that manage tools and skills.
2. Provider tools — from installed provider packages (Slack, GitHub, Gmail, Notion, HubSpot, and more), loaded by the developer.
3. Tools created by agents — written with matimo_create_tool into a directory the developer chose. They start as drafts and run only after a human approves them.

Which Tool Answers Which Question

matimo_search_tools — search everything that is loaded

matimo_search_tools(query: "slack message", limit: 5)

→ {
    "results": [
      { "name": "slack_send_channel_message", "description": "...", "version": "1.0.0", "tags": ["slack", "messaging"], "riskLevel": "medium" }
    ],
    "total": 1,
    "query": "slack message"
  }

• Matches the query against tool names, descriptions and tags.
• Searches every loaded tool — core, provider and approved agent-created tools.
• An empty result means nothing loaded matches: try other words before deciding to create a tool.

matimo_get_tool — read one tool's definition

matimo_get_tool(name: "weather_lookup", tool_dir: "<directory>")

→ { "found": true, "name": "weather_lookup", "yaml_content": "name: weather_lookup\n...", "definition": { ... }, "message": "..." }

Use it to see a tool's parameters before calling it, or to start a new tool from an existing one.