---
description: Teach Claude how to use Danube effectively with the official Agent Skill
metadata:
  mintlify-proj: danube
---

## What is the Agent Skill?

The Agent Skill is an [Agent Skill](https://agentskills.io) that teaches Claude how to effectively discover and use tools through the Danube MCP Server. It provides:

* **Tool discovery patterns** - When to use `search_tools` vs `list_services` vs `get_service_tools`
* **Authentication handling** - How to recognize and respond to credential errors
* **Workflow guidance** - Multi-step patterns for common tasks
* **Troubleshooting** - Error handling and recovery strategies

<Info>
  Agent Skills are folders of instructions that Claude loads dynamically to improve performance on specialized tasks. [Learn more about Skills](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills)
</Info>

## Download

<Card title="Download Agent Skill" icon="download" href="/danube-skill.zip">
  Download the skill package (ZIP file)
</Card>

## Installation

<Steps>
  <Step title="Download the Skill">
    Click the download button above to get `danube-skill.zip`.
  </Step>

  <Step title="Open Claude Settings">
    In Claude.ai, click on your profile icon and select **Settings**.
  </Step>

  <Step title="Navigate to Capabilities">
    Go to **Capabilities** in the settings menu.
  </Step>

  <Step title="Add the Skill">
    Click **Add** and then select **Upload Skill**.
  </Step>

  <Step title="Select the ZIP File">
    Choose the `danube-skill.zip` file you downloaded.
  </Step>

  <Step title="Confirm Installation">
    The skill will appear in your Capabilities list once installed.
  </Step>
</Steps>

<Tip>
  After installing the skill, Claude will automatically use it when you ask about Danube tools or want to interact with external services.
</Tip>

## What's Included

The Agent Skill package contains:

```
danube/
├── SKILL.md              # Core instructions and tool reference
└── references/
    ├── workflows.md      # Multi-step usage patterns
    └── troubleshooting.md # Error handling guide
```

### SKILL.md

The main skill file includes:

* Complete reference for all 30 MCP tools (discovery, execution, spending limits, skills, workflows, sites, agents, ratings)
* Tool discovery decision flow
* Authentication error handling patterns (including `store_credential` for API keys)
* Best practices for using Danube

### workflows.md

Common multi-step patterns:

* Find and execute a tool
* Explore a service's capabilities
* Handle authentication errors
* Multi-service operations
* Multi-tool orchestration workflows

### troubleshooting.md

Error handling guidance:

* Authentication errors (`auth_required`, `invalid_grant`, API key issues)
* Parameter errors
* Connection issues
* Quick reference for error resolution

## Example Usage

Once the skill is installed, Claude will know how to use Danube effectively. Try prompts like:

<AccordionGroup>
  <Accordion title="Service Discovery">
    **Prompt:** *"What services are available on Danube?"*

    Claude will use `list_services` to show available integrations.
  </Accordion>

  <Accordion title="Tool Search">
    **Prompt:** *"Find a tool to send emails"*

    Claude will use `search_tools` with semantic search to find relevant tools.
  </Accordion>

  <Accordion title="Execute a Task">
    **Prompt:** *"Send an email to [john@example.com](mailto:john@example.com) about our meeting tomorrow"*

    Claude will discover the Gmail tool, check authentication, and execute the request.
  </Accordion>
</AccordionGroup>

## Skill vs MCP Connection

| Feature            | MCP Connection | Agent Skill        |
| ------------------ | -------------- | ------------------ |
| Required for tools | Yes            | No (enhancement)   |
| Tool execution     | Enables it     | Improves it        |
| Error handling     | Basic          | Guided recovery    |
| Discovery          | Available      | Optimized patterns |

<Note>
  The Agent Skill enhances Claude's ability to use Danube but does **not** replace the MCP connection. You still need to [set up the MCP Server](/quickstart) to actually execute tools.
</Note>

## Updating the Skill

To update to a newer version:

1. Download the latest skill from this page
2. Go to **Settings** → **Capabilities**
3. Remove the existing Agent skill
4. Upload the new version

## Creating Custom Skills

Want to create your own skills? Check out:

* [Agent Skills Specification](https://agentskills.io/specification)
* [Anthropic Skills Repository](https://github.com/anthropics/skills)