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.
---
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…01 The packs
Four skills cover the lifecycle of an email program — sending, authoring, deliverability, and receiving:
{{handlebars}} variables.| 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. |
02 Install them
The skills live in the Drin repository. Installing one is just copying its folder into your agent's skills directory.
- 1
Get the skill folders
Clone the repo (or copy thepackages/agent-skills/*folders) so you havedrin-send-email,drin-build-template,drin-email-best-practices, anddrin-agent-inboxlocally. - 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 eachSKILL.mdbody in the rules / system-prompt directory. - 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": {
"drin": {
"command": "npx",
"args": ["-y", "@drin00/mcp"],
"env": { "DRIN_API_KEY": "drin_xxx" }
}
}
}