> ## Documentation Index
> Fetch the complete documentation index at: https://docs.darwin.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Run Skill

> Install or execute a skill for a linked agent with explicit scopes.

Request skill and connection scopes only when the application needs them. The linked agent owns every durable skill assignment and provider connection.

1. Read the skill catalog and current assignment with the user's OAuth token.
2. Ask for user approval before adding or changing a durable skill.
3. Complete any provider connection through Darwin's hosted authorization flow.
4. Run the skill inside an approved goal so its dollar price appears under Agent usage.
5. Pause for `overage_approval_required` before exceeding the authorization.

The application never receives provider access tokens. Ephemeral goals can request supported capabilities but do not install a durable skill for a pseudonymous user.

<Card title="Product API · Run Skill" href="/product/workflows/run-skill">
  Review assignment, authorization, quoting, and execution.
</Card>
