How To Choose A Tool

1. List - GET /api/tools?organizationId=...
2. Inspect versions - review schemas, capability, and risk metadata.
3. Attach - bind a tool version to a skill version via POST /api/skill-versions/:id/tools.
4. Preview / run - validate behavior and inspect run detail.

Prefer tools with declared capabilities when side effects matter.

See also

• Read Only vs. Side Effecting Tools
• Capabilities In Run Detail