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

# Agent Skills

> Portable instruction packs that teach an AI agent how to use Drin well — sending email, building bullet-proof templates, deliverability, and running an autonomous inbox.

Agent Skills are portable instruction packs that teach an AI agent how to use Drin well — not just which tool to call, but the whole workflow around it. They're tool-agnostic: the same skill works whether the agent reaches Drin through @drin00/mcp, the CLI, the SDK, or raw HTTPS.

A skill is a single `SKILL.md` file: YAML frontmatter (`name` and a `description` that tells the agent *when* to reach for it) followed by Markdown instructions. The agent loads the body on demand, so the knowledge costs nothing until it's needed.

```text SKILL.md anatomy theme={null}
---
name: drin-send-email
description: Send a transactional email through Drin reliably. Use when the
  user or agent needs to send an email (notification, receipt, OTP, alert,
  reply) via the Drin email API …
---

# Sending a transactional email with Drin
…instructions…
```

<Tip>
  **Skills are knowledge, tools are reach.** [MCP](/agents/mcp), the [CLI](/agents/cli), and the [SDK](/sdk/typescript) give an agent the **tools** to act. Skills give it the **judgment** to use them well — which domain to send from, how to handle a suppressed address, when to ship a plain-text part. Install both.
</Tip>

## The packs

Four skills cover the lifecycle of an email program — sending, authoring, deliverability, and receiving:

<CardGroup cols={2}>
  <Card title="drin-send-email" icon="bolt">
    Send a transactional email reliably: pick a verified domain, compose, send, and handle suppressed / rate-limited error paths.
  </Card>

  <Card title="drin-build-template" icon="table-cells">
    Produce HTML email that renders across Gmail, Outlook, and Apple Mail — table layout, inlined styles, a plain-text part, dark mode, and `{{handlebars}}` variables.
  </Card>

  <Card title="drin-email-best-practices" icon="shield">
    Get deliverability right — SPF/DKIM/DMARC, bounce/complaint limits, suppressions, warmup, and one-click unsubscribe.
  </Card>

  <Card title="drin-agent-inbox" icon="inbox">
    Run an autonomous inbox — enable receiving, read conversation threads, and reply in-thread.
  </Card>
</CardGroup>

| Skill                       | Use it when the agent needs to…                                                                            |
| --------------------------- | ---------------------------------------------------------------------------------------------------------- |
| `drin-send-email`           | Send a transactional email reliably (verify domain → compose → send → confirm).                            |
| `drin-build-template`       | Produce HTML email that renders across Gmail / Outlook / Apple Mail, with a plain-text part and dark mode. |
| `drin-email-best-practices` | Get deliverability right — SPF/DKIM/DMARC, bounce/complaint limits, suppressions, unsubscribe.             |
| `drin-agent-inbox`          | Receive inbound mail and act on it — enable receiving, read threads, reply.                                |

## Install them

The skills live in the [Drin repository](https://github.com/ATOM00blue/drin). Installing one is just copying its folder into your agent's skills directory.

<Steps>
  <Step title="Get the skill folders">
    Clone the repo (or copy the `packages/agent-skills/*` folders) so you have `drin-send-email`, `drin-build-template`, `drin-email-best-practices`, and `drin-agent-inbox` locally.
  </Step>

  <Step title="Drop them where your agent looks for skills">
    For Claude Code or Claude Desktop, copy the folders into `.claude/skills/` (project-scoped) or `~/.claude/skills/` (user-scoped). For Cursor, Windsurf, and others, place each `SKILL.md` body in the rules / system-prompt directory.
  </Step>

  <Step title="Pair them with the tools">
    Skills are knowledge — give the agent the matching tools by pointing it at the [MCP server](/agents/mcp) too.
  </Step>
</Steps>

<CodeGroup>
  ```bash Claude Code / Desktop theme={null}
  # project-scoped
  cp -r drin-send-email drin-build-template drin-email-best-practices drin-agent-inbox \
    .claude/skills/

  # or user-scoped: ~/.claude/skills/
  ```

  ```bash Cursor / Windsurf theme={null}
  # Drop the SKILL.md bodies into your rules directory
  cp drin-send-email/SKILL.md .cursor/rules/drin-send-email.md
  ```
</CodeGroup>

## Pair with the MCP server

Skills and tools are complementary. Run the [Drin MCP server](/agents/mcp) alongside the skills so the agent has both the *knowledge* (these packs) and the *tools* (`send_email`, `list_threads`, …):

```json mcpServers theme={null}
{
  "mcpServers": {
    "drin": {
      "command": "npx",
      "args": ["-y", "@drin00/mcp"],
      "env": { "DRIN_API_KEY": "drin_xxx" }
    }
  }
}
```

<Note>
  **Free on every plan.** The skills, the MCP server, and the CLI are all free on every Drin plan.
</Note>

<CardGroup cols={2}>
  <Card title="MCP server" icon="plug" href="/agents/mcp">
    The 54 tools the skills drive — one command, one key.
  </Card>

  <Card title="Agents overview" icon="robot" href="/agents">
    How skills fit the agent inbox loop and the four ways to reach Drin.
  </Card>
</CardGroup>