# Agent skill (/docs/v/0.3.0/agents/skill)



This repo includes an agent skill at:

```txt
skills/email-sdk/SKILL.md
```

Install it with the skills.sh CLI:

```bash
npx skills add opencoredev/email-sdk --skill email-sdk
```

Use it when an agent wires Email SDK into an app, reviews adapter setup, or updates these docs.

## What it tells agents [#what-it-tells-agents]

* Use `bun` and `bunx`.
* Refresh the current README, package version, package exports, Fumadocs pages, and TypeScript declarations before implementing.
* Keep adapter credentials in environment variables.
* Import adapters from their own entry points.
* Do not add Nodemailer for SMTP; Email SDK includes its own SMTP transport.
* Use fallbacks only when the backup adapter can send the same class of email.
* Add idempotency keys for externally visible transactional sends.
* Run a narrow validation before calling the work done.

## Prompt example [#prompt-example]

```txt
Use the repo-local Email SDK skill at skills/email-sdk/SKILL.md.
Wire Resend as the primary adapter and SMTP as fallback.
Keep secrets in environment variables.
Add one narrow test around the send path.
```

The skill is dynamic on purpose. It teaches agents where to fetch the current docs and source first, so the skill does not need a manual update every time the SDK gains another adapter or option.