AI agent skill

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

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

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

The skill discovers the current documentation from /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, follows the current category links, and reads the selected template page before using its registry command or Manual source.

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

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

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 for runtime agent calls.