Agent Skills overview

What the skill should teach

Search before acting.

Preserve the selected capabilityId and capabilityRevision.

Treat Search as informational, not authorization.

Follow availableActions instead of guessing what can happen next.

Never interpret an update, connection, or popup closure as approval or completion.

Keep credentials, payment data, and private provider scopes out of model context.

Installation prompt

Give your agent this instruction:

Fetch https://darwin.so/skill.md and follow the setup instructions.
Use Darwin Search to discover a capability, preserve the exact capability ID and revision,
and use Darwin Act only when the user has supplied the required inputs and authority.

A skill does not grant access by itself. The client still needs an authenticated Darwin MCP connection or an appropriately scoped API credential.

Verify the installation

Ask the agent to explain the difference between Search and Act, then ask it to list the Darwin tools it can actually call. Do not proceed if it invents tools or claims it can approve or spend without a reviewed user decision.

Check	A correct agent should say
Discovery	Search is read-only and preserves canonical ordering.
Selection	The chosen capability ID and revision must stay exact.
Execution	Act returns a durable `actionId` and can pause.
Authority	Updates, connections, payments, and approvals are distinct.
Recovery	Read the same Action instead of creating replacement work.

Get Started

Search

Act

SDKs

Interfaces

Admin

Agent Skills overview

Build with Darwin

Search skill

Act skill

What the skill should teach

Installation prompt

Verify the installation

Pair instructions with a real interface

Build with Darwin

Search skill

Act skill

​What the skill should teach

​Installation prompt

​Verify the installation

​Pair instructions with a real interface

What the skill should teach

Installation prompt

Verify the installation

Pair instructions with a real interface