agentmail – Marketing & SEO skill for AI agents

Use when an agent needs AgentMail CLI email inboxes.

Marketing & SEOSKILL.mdClaude Code · Codex · Hermes · DeepSeek

Install the agentmail skill with one command

Pick the tool you use, copy the command and paste it in your terminal. The skill lands in that tool's skills folder and is ready in your next session.

Claude Code

mkdir -p ~/.claude/skills && curl -fsSL https://skill.dn1nguoi.com/z/agentmail-6b5e4.tgz | tar xz -C ~/.claude/skills

Call it in Claude Code: /agentmail – then describe the task you want done.

Codex

mkdir -p ~/.codex/skills && curl -fsSL https://skill.dn1nguoi.com/z/agentmail-6b5e4.tgz | tar xz -C ~/.codex/skills

Call it in Codex: $agentmail – then describe the task you want done.

Hermes Agent

mkdir -p ~/.hermes/skills && curl -fsSL https://skill.dn1nguoi.com/z/agentmail-6b5e4.tgz | tar xz -C ~/.hermes/skills

Call it in Hermes Agent: /agentmail – then describe the task you want done.

DeepSeek

mkdir -p ~/.deepcode/skills && curl -fsSL https://skill.dn1nguoi.com/z/agentmail-6b5e4.tgz | tar xz -C ~/.deepcode/skills

Call it in DeepSeek: /agentmail – then describe the task you want done.

SKILL.md content

AgentMail Skill

AgentMail gives an agent its own email inbox for sending mail, receiving

replies, completing email OTP flows, and running inbound email loops. Use it for

agent-owned inboxes, not a user's existing IMAP/SMTP mailbox.

Use the agentmail CLI first. Use MCP only when the harness expects MCP tools;

use REST only when the CLI is missing a required operation.

When to Use

The agent needs an email address it owns.
The task involves email OTP flows, replies, threads, labels, or attachments.
The agent needs webhook or WebSocket delivery for inbound mail.

Prerequisites

Run commands through the terminal tool.
Install the CLI:

npm install -g agentmail-cli@latest

Export an API key:

export AGENTMAIL_API_KEY="am_..."

No API key yet? Use [signup.md](references/signup.md).

How to Run

Use --format json whenever another command or script needs IDs.

agentmail inboxes list --format json

Quick Reference

[AgentMail agent reference](https://agentmail.md): hosted copy.
[AgentMail](https://agentmail.to): product landing page.
[Console](https://console.agentmail.to): API keys and account management.
[Docs](https://docs.agentmail.to): full product documentation.
[signup.md](references/signup.md): self-signup and OTP verification.
[core.md](references/core.md): inboxes, messages, threads, labels, attachments.
[webhooks.md](references/webhooks.md): events to a public HTTPS server.
[websockets.md](references/websockets.md): events to a local agent process.
[mcp.md](references/mcp.md): MCP integration.

Procedure

1. Install agentmail-cli@latest and verify agentmail inboxes list --format json.

2. If no API key is available, complete [signup.md](references/signup.md).

3. Use [core.md](references/core.md) for inbox, send, read, reply, forward,

label, thread, and attachment flows.

4. Add [webhooks.md](references/webhooks.md) or

[websockets.md](references/websockets.md) only when polling is not enough.

Pitfalls

Prefer AGENTMAIL_API_KEY over --api-key.
Never expose AGENTMAIL_API_KEY in prompts, logs, URLs, or committed files.
Use stable client_id values for retried create operations.
Prefer extracted_text or extracted_html for LLM input when present.
React to message.received, not messages the agent sent.

Verification

agentmail inboxes list --format json

Related skills

ai-seo – When the user wants to optimize content for AI search engines, get cited by LLMs, or…
ad-campaign-analyzer – Analyze cross-channel campaign data, quantify uncertainty, and propose evidence-labeled…
ad-creative – Create, iterate, and scale paid ad creative for Google Ads, Meta, LinkedIn, TikTok, and…
analytics – When the user wants to set up, improve, or audit analytics tracking and measurement…
advanced-analytics-dashboard – Dashboard metric register: metric, source module, formula, period, value, target, trend…
attribution – When the user wants to figure out which marketing actually drives conversions and…
agentmail – Email infrastructure for AI agents. Create accounts, send/receive emails, manage…
analytics-tracking – Set up, audit, and debug analytics tracking implementation — GA4, Google Tag Manager…

← Browse all skills