Agent skills for Mailtrap end users and builders using LLM-assisted coding. They summarize product flows, API bases and paths, and links to official documentation. They are not a substitute for docs.mailtrap.io or the developer API documentation.
These skills follow the Agent Skills open standard (Anthropic, Dec 2025). Each skill is a directory containing a SKILL.md with YAML frontmatter (name, description) plus Markdown instructions. Compliant agents read only the frontmatter at startup and pull the body on demand (progressive disclosure), so the same folder works across multiple tools.
Copy or symlink the skill folders into the skills directory your agent reads. The examples below assume you cloned this repo to /path/to/mailtrap-skills. After install, restart or reload the agent if it does not pick up new skills.
- Project:
.cursor/skills/<skill-name>/ - User (all projects):
~/.cursor/skills/<skill-name>/
ln -s /path/to/mailtrap-skills/skills/* ~/.cursor/skills/- Project:
.claude/skills/<skill-name>/ - User:
~/.claude/skills/<skill-name>/
ln -s /path/to/mailtrap-skills/skills/* ~/.claude/skills/- Project:
.agents/skills/<skill-name>/ - User:
~/.agents/skills/<skill-name>/
ln -s /path/to/mailtrap-skills/skills/* ~/.agents/skills/- Project:
.gemini/skills/<skill-name>/(also accepts.agents/skills/) - User:
~/.gemini/skills/<skill-name>/
ln -s /path/to/mailtrap-skills/skills/* ~/.gemini/skills/- Project:
.github/skills/<skill-name>/(also accepts.claude/skills/and.agents/skills/) - User:
~/.copilot/skills/<skill-name>/(also accepts~/.agents/skills/)
ln -s /path/to/mailtrap-skills/skills/* ~/.copilot/skills/- Project:
.windsurf/skills/<skill-name>/ - User:
~/.codeium/windsurf/skills/<skill-name>/
ln -s /path/to/mailtrap-skills/skills/* ~/.codeium/windsurf/skills/Most other agents that support the Agent Skills standard also accept ~/.agents/skills/ (user scope) and .agents/skills/ (project scope). If your tool uses a different path, point it at this repository's skills/ folder.
Skill examples reference these environment variables instead of literal secrets:
| Variable | Used for |
|---|---|
MAILTRAP_API_TOKEN |
General API: Email Send (transactional and bulk), Templates, Contacts, Sending Domains |
MAILTRAP_SANDBOX_API_TOKEN |
Sandbox / Email Testing (separate scope) |
MAILTRAP_ACCOUNT_ID |
Path parameter for account-scoped endpoints (resolve at runtime, do not hardcode) |
Full guidance — token scope, where to store tokens, auth header forms, and how to resolve MAILTRAP_ACCOUNT_ID from GET https://mailtrap.io/api/accounts — lives in the authorizing-api-requests skill. Every other skill in this repo points at it instead of duplicating the rules.
| Skill | Purpose |
|---|---|
authorizing-api-requests |
API tokens, env vars, auth headers, account_id resolution |
sending-emails |
Live sending via Email API and SMTP (transactional vs bulk) |
testing-with-sandbox |
Email Sandbox, Testing API, safe capture in dev/staging |
using-email-templates |
Account-scoped templates, Handlebars, API template send |
converting-email-templates |
Convert templates from SendGrid, Mailgun, Mandrill, Postmark, Brevo, SES to Mailtrap Handlebars |
setting-up-sending-domain |
Domain verification, DNS (add all records), compliance |
managing-contacts |
Contacts API, lists, segments, CRM-style sync |
- Product documentation: docs.mailtrap.io
- Developer and API documentation: docs.mailtrap.io/developers
- Agent Skills standard: agentskills.io