# Coding-agent skill (/docs/getting-started/agent-skill)



The repository ships two dynamic skills for Claude Code and other skill-compatible coding agents:

* `email-sdk` for new integrations, reviews, and adapter work.
* `email-sdk-migrate` for source-grounded application upgrades.

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

You can also copy `skills/email-sdk/` into your repository's agent skill directory.

## Dynamic documentation [#dynamic-documentation]

The skill discovers the current documentation from [`/docs/llms.txt`](/docs/llms.txt), then fetches exact pages through the raw Markdown route at `/docs/<path>.md`. It does not rely on a frozen list of adapters, concepts, or UI templates.

For email UI work it starts at [`/docs/ui.md`](/docs/ui.md), follows the current category links, and reads the selected template page before using its registry command or Manual source.

## What the skill requires [#what-the-skill-requires]

* Refresh the installed package README, exports, declarations, and relevant adapter source before editing.
* Import every adapter from its own subpath.
* Keep credentials in server environment variables.
* Check field and capability compatibility before adding fallback routes.
* Use idempotency for externally visible sends that may retry.
* Use `doctor` and `send --dry-run` before an approved live provider check.
* Keep bodies, recipients, credentials, and provider payloads out of logs.
* Run the narrowest typecheck or test that covers the send path.

## Prompt example [#prompt-example]

```text
Use the email-sdk skill.
Wire Resend as the primary adapter and a named SMTP backup.
Validate the full route before queueing.
Add one unit test with the memory adapter.
Do not send a real email.
```

## Migration prompt [#migration-prompt]

```text
Use the email-sdk-migrate skill.
Inspect the installed package and declarations before editing.
Audit this repository for v0 surfaces, migrate it to v1, and preserve retry,
fallback, idempotency, batch, and personalized-send semantics.
Run typechecks and tests. Do not send live email.
```

The migration skill includes a deterministic scanner for common v0 spellings, but requires the agent to inspect each finding before changing generic application vocabulary.

The skill guides code changes; it is not a runtime email tool. Use the [AI SDK integration](/docs/integrations/ai-sdk) for runtime agent calls.

<Card title="Machine-readable docs" href="/docs/agents/machine-readable-docs" description="Give agents raw Markdown and complete documentation indexes." />