lev-os/agents/tools

Tools

To design or repair a tool interface (overlapping purpose, examples, output size, errors), read Tool design. It is instructions only; existing leaves keep their operations.

Contents

Resolve the target project from the task before running a command. Use that project's root as cwd; use the current workspace when no target project is named.

Requests such as "use the TWG skill" or "connect to Atlassian" select the Teamwork Graph leaf. "Robo" is a discovery alias for Atlassian Rovo. Explicit Rovo Dev coding-agent requests remain distinct from TWG Rovo search.

Load only the branch selected by the contents table. Paths are relative to this file, so nested references remain valid if the skill is installed elsewhere. Each integration is a leaf package with SKILL.md and INSTALL.md; old reference paths remain compatibility routes. Slack's CLI and API guides share one leaf and retain their existing paths.

General research routes to skill://research. Explicit Exa transport/API work loads the Exa reference and its bundled scripts/exa.sh. AgentMail mailbox operations also load its local references/cli-and-monitoring.md; Suntiq identity work loads references/suntiq-auth.md. Herdr is optional; the selected agent/controller owns implementation and lifecycle evidence independently.

Inspect live CLI help before an unfamiliar command. Preserve the user's mutation boundary.

Provider credentials and CLI sessions are separate authorities. Verify the credential type, target resource, and operation before a call. A successful process exit is not completion: inspect the provider response, resulting ID or URL, and any pagination or lifecycle state. An input rejected before any effect is retryable once corrected. A mutation that timed out or returned an ambiguous status has an uncertain effect: look up the target resource before acting again, and hold and report when the lookup cannot settle it. Never replay an uncertain effect.

The leaf/reference files describe operations; they do not grant permission to send messages, enable a connector, install software or mutate external systems.