Install a Skill

Add a skill to your workspace and authorize it.

1. Find it

Skills → Catalog. Search by name (Gmail, Slack, Stripe, GitHub, Notion) or browse by category.

2. Install

Click Install. ShipClaw asks two things:

Auth scope: per-tenant or workspace-scoped (covered in Skills)
Default actions: which actions to enable out of the box

3. Authorize

For workspace-scoped skills, OAuth runs immediately. You'll get redirected to the provider, sign in, grant scopes, and bounce back.

For per-tenant skills, no auth happens at install time. Each tenant authorizes their own account when their bot first runs (or you can pre-authorize via the API if you want to do it server-side).

4. Use it in the builder

The installed skill shows up in the builder's palette under Skills. Drag a node onto the canvas and pick the action you want.

When tokens expire

Tokens expire. ShipClaw refreshes silently when it can. If the user revoked access or the token's stale, the bot surfaces a re-auth prompt in the channel and the inbox.

Uninstalling

Skills → Installed → Uninstall. Removes the skill from the workspace and revokes Composio's grant. Bots that referenced the skill will fail validation until you remove or replace those nodes.