| name | composio |
| description | Use the Hermes Composio connector runtime for authenticated third-party app actions via thin meta-tools. Use when the user wants connected-app work (Gmail, GitHub, or other allowlisted Composio toolkits), needs to connect an account, search for a Composio tool slug, inspect a schema, or execute a Composio action safely. |
Composio (Hermes runtime)
Overview
This skill is the umbrella entrypoint for the Composio Hermes plugin. Capability comes from a small stable tool surface, not from dumping the whole Composio catalog into the model schema.
Prefer loading a toolkit skill before non-trivial app work:
| App | Skill |
|---|
| Gmail | composio:composio-gmail (+ composio:composio-gmail-inbox-triage for inbox ranking) |
| GitHub | composio:composio-github (+ composio:composio-github-pr-triage for PR attention) |
Preferred Deliverables
- Clear connection/status answers with profile +
user_id
- Shortlisted tool slugs with why they match
- Read results summarized with scope/confidence
- Drafts before sends; explicit confirmation before side effects
Core Loop
- If auth/account state is uncertain:
composio_status (or composio_connections).
- If the toolkit is disconnected:
composio_connect with the toolkit slug; tell the user to open redirect_url, then re-check status.
- Discover actions with
composio_search using a concrete use case string.
- If arguments are unclear:
composio_schema on the chosen slug.
- Execute with
composio_execute.
- For raw endpoints with no slug:
composio_proxy (mutating methods need confirmed=true unless yolo).
Reference Notes
Write Safety
- Default to read and draft.
- Side-effectful slugs require
confirmed=true after explicit user intent, unless Hermes yolo / approvals.mode=off.
- Never invent destructive args. Prefer
composio_schema.
- v1 is single-account per toolkit; do not silently switch accounts.
Output Conventions
- Lead with the answer, then evidence.
- State which toolkit/account and which tool slug produced the result when useful.
- If results are truncated, say so and offer a narrower query.
Example Requests
- "What Composio apps are connected?"
- "Connect Gmail."
- "Find the tool to list unread mail, then fetch the latest 10."
- "Search GitHub tools for open PRs in my repo."
Light Fallback
If Composio is unconfigured, say COMPOSIO_API_KEY is missing and point to hermes composio login-help / /composio login-help.
