resend · oakoss — Claude Code skill: what it does, how to install
Guides AI agents in integrating the Resend email API, handling React Email templates, domain verification, and Svix webhooks.
MIT 127 installs ★ 29 updated 2026-08-17
npx skills add oakoss/agent-skills --skill resend -a claude-codeWhat resend does
This skill teaches coding agents how to work with the Resend email API. It covers sending transactional messages, batch delivery, scheduling, contact lists, and server-side React Email component rendering.
The guidance prevents typical integration bugs. The react property works strictly in the Node.js SDK, while batch operations do not support scheduling or attachments. Total attachments must remain under 40MB after encoding. It also enforces reading RESEND_API_KEY from the environment and verifying incoming Svix webhook signatures.
What it helps with
- send transactional emails with error handling via Resend
- set up server-side rendering with React Email components
- verify domain SPF, DKIM, and DMARC records
- validate Svix webhook signatures on email events
Example prompts for the agent
- Write a password reset email handler using Resend and destructure error handling
- Create a webhook endpoint that verifies Svix signatures for Resend bounce events
- Set up a transactional receipt template using React Email with Resend
How to install resend
1Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill resend -a claude-code2Manually: put the files in place
~/.claude/skills/resend/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/resend/
1Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill resend -a codex2Manually: put the files in place
.agents/skills/resend/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill resend -a cursor2Manually: put the files in place
.cursor/skills/resend/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install oakoss/agent-skills skills/resend2Manually: put the files in place
.github/skills/resend/SKILL.md1Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill resend -a gemini-cli2Platform CLI
gemini skills install https://github.com/oakoss/agent-skills --path skills/resendManually: put the files in place
.devin/skills/resend/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill resend -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about resend
How to install resend in Claude Code?
Run npx skills add oakoss/agent-skills --skill resend -a claude-code. Alternatively, place the file in ~/.claude/skills/resend/SKILL.md.
What does the resend skill do?
It provides API patterns and common pitfalls for sending emails, verifying sender domains, handling Svix webhooks, and managing contacts with Resend.
Does the react property work in non-Node SDKs?
No, passing React Email components via the react property is exclusive to the Node.js SDK because it depends on server-side JSX rendering.
Source text
SKILL.md · MIT
---
name: resend
description: 'Resend email API for sending transactional and marketing emails. Use when integrating email delivery, managing domains, handling webhooks, building email workflows with React Email, managing contacts, or sending broadcasts. Use for resend, email, transactional, broadcast, contacts, segments, webhooks, domain.'
license: MIT
metadata:
author: oakoss
version: '1.1'
source: https://resend.com/docs
user-invocable: false
---
# Resend
## Overview
Resend is a modern email API built for developers, providing programmatic email sending with support for React Email components, domain management, and webhook-driven event tracking.
**When to use:** Transactional emails (welcome, password reset, receipts), batch email delivery, scheduled sending, webhook-based delivery tracking, domain verification, React Email integration.
**When NOT to use:** High-volume marketing automation (use dedicated ESP), SMS/push notifications, email hosting/inbox management.
## Quick Reference
| Pattern | API | Key Points |
| ---------------- | ------------------------------------------- | ------------------------------------------------------------- |
| Send email | `resend.emails.send({ from, to, subject })` | Returns `{ data, error }`, supports html/text/react content |
| Send with React | `resend.emails.send({ react: <Email /> })` | Node.js SDK only, renders React Email components server-side |
| Batch send | `resend.batch.send([...emails])` | Multiple emails in one request, no attachments/scheduling |
| Schedule email | `emails.send({ scheduled_at })` | ISO 8601 or natural language, cancel before send window |
| Attachments | `emails.send({ attachments: [...] })` | Max 40MB total after encoding, supports content or path |
| Idempotent send | `emails.send(params, { idempotencyKey })` | Prevents duplicate sends on retry |
| Retrieve email | `resend.emails.get(emailId)` | Check delivery status and metadata |
| Add domain | `resend.domains.create({ name })` | Returns DNS records for SPF, DKIM, MX |
| Verify domain | `resend.domains.verify(domainId)` | Triggers DNS record check |
| List domains | `resend.domains.list()` | Returns all domains with status |
| Create webhook | Dashboard or API | Subscribe to email lifecycle events |
| Verify webhook | `resend.webhooks.verify({ payload, ... })` | Validates Svix signature headers |
| Tags | `emails.send({ tags: [...] })` | Key-value pairs for categorization, ASCII only, max 256 chars |
| Custom headers | `emails.send({ headers: {...} })` | Add custom email headers |
| Create contact | `resend.contacts.create({ email, ... })` | Global contacts with custom properties |
| List contacts | `resend.contacts.list()` | Returns all contacts |
| Create broadcast | `resend.broadcasts.create({ from, ... })` | Bulk email to a segment, supports template variables |
| Send broadcast | `resend.broadcasts.send(id, { segmentId })` | Delivers broadcast to a segment of contacts |
## Common Mistakes
| Mistake | Correct Pattern |
| ------------------------------------------ | -------------------------------------------------------------------- |
| Using root domain for sending | Use a subdomain like `send.yourdomain.com` to isolate reputation |
| Not checking `error` in response | Always destructure `{ data, error }` and handle errors |
| Sending attachments in batch requests | Attachments and scheduling are not supported in batch sends |
| Hardcoding API key in source code | Use environment variable `RESEND_API_KEY` |
| Skipping webhook signature verification | Always verify using Svix headers before processing events |
| Using `react` prop outside Node.js SDK | The `react` prop only works with the Node.js SDK |
| Not setting up DMARC after SPF/DKIM verify | Add DMARC record after SPF and DKIM pass to improve deliverability |
| Exceeding 50 recipients in a single send | Use batch send or loop for more than 50 recipients per request |
| Using `&&` for tag name/value characters | Tag names and values must be ASCII letters, numbers, `_`, or `-` |
| Ignoring bounce/complaint webhooks | Monitor `email.bounced` and `email.complained` to protect reputation |
## Delegation
- **Email template design**: Use `Explore` agent to discover React Email component patterns
- **Domain DNS configuration**: Use `Task` agent for step-by-step DNS setup verification
- **Webhook endpoint setup**: Use `Task` agent for route handler implementation
## References
- [Sending emails, batch sending, attachments, scheduling, and idempotency](references/sending-emails.md)
- [Contacts, Segments, Broadcasts, template variables, and bulk sending](references/contacts-and-broadcasts.md)
- [Domain verification, DNS records, and sender identity management](references/domain-management.md)
- [Webhook events, signature verification, and event handling](references/webhooks.md)
© oakoss · MIT · oakoss/agent-skills
Similar skills
All skills for Backend and APIs →resend by other authors comes first.