Docs
guides · agents · skills

Agent Skills

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.

SKILL.md anatomy
---
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…
Skills are knowledge, tools are reachMCP, the CLI, and the SDK 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.

01 The packs

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

drin-send-emailSend a transactional email reliably: pick a verified domain, compose, send, and handle suppressed / rate-limited error paths.
drin-build-templateProduce HTML email that renders across Gmail, Outlook, and Apple Mail — table layout, inlined styles, a plain-text part, dark mode, and {{handlebars}} variables.
drin-email-best-practicesGet deliverability right — SPF/DKIM/DMARC, bounce/complaint limits, suppressions, warmup, and one-click unsubscribe.
drin-agent-inboxRun an autonomous inbox — enable receiving, read conversation threads, and reply in-thread.
SkillUse it when the agent needs to…
drin-send-emailSend a transactional email reliably (verify domain → compose → send → confirm).
drin-build-templateProduce HTML email that renders across Gmail / Outlook / Apple Mail, with a plain-text part and dark mode.
drin-email-best-practicesGet deliverability right — SPF/DKIM/DMARC, bounce/complaint limits, suppressions, unsubscribe.
drin-agent-inboxReceive inbound mail and act on it — enable receiving, read threads, reply.

02 Install them

The skills live in the Drin repository. Installing one is just copying its folder into your agent's skills directory.

  1. 1

    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.
  2. 2

    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.
  3. 3

    Pair them with the tools

    Skills are knowledge — give the agent the matching tools by pointing it at the MCP server too.
# project-scoped
cp -r drin-send-email drin-build-template drin-email-best-practices drin-agent-inbox \
  .claude/skills/

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

03 Pair with the MCP server

Skills and tools are complementary. Run the Drin MCP server alongside the skills so the agent has both the knowledge (these packs) and the tools (send_email, list_threads, …):

mcpServers
{
  "mcpServers": {
    "drin": {
      "command": "npx",
      "args": ["-y", "@drin00/mcp"],
      "env": { "DRIN_API_KEY": "drin_xxx" }
    }
  }
}
Free on every planThe skills, the MCP server, and the CLI are all free on every Drin plan.