agent-email-cli — Claude Code skill: what it does, how to install
Controls disposable inboxes using the agent-email CLI. Helps agents receive incoming mail, wait for verification codes, and parse messages.
npx skills add zaddy6/agent-email-skill --skill agent-email-cli -a claude-codeWhat agent-email-cli does
This skill teaches the coding agent how to handle temporary inboxes through the agent-email command line tool. An agent creates disposable addresses and extracts email content in JSON format. This setup helps automate flows where scripts must verify account signups via incoming links.
The skill guides the agent through exact commands. It uses agent-email read with polling flags --wait 30 --interval 2 to wait for incoming mail. It then pulls message IDs and sender addresses. Passwords and secret tokens are kept out of logs.
The skill cannot run if @zaddy6/agentemail is missing from PATH. Install it globally first. The CLI also handles switching account profiles and deleting processed emails.
What it helps with
- generate temporary inboxes for automated test flows
- poll for incoming verification emails and one-time passwords
- inspect email payload details to extract activation links
- delete processed messages from temporary mailboxes
Example prompts for the agent
- Create a temporary inbox and wait for the verification email.
- Poll the current inbox for incoming messages with a 30 second timeout.
- Show the full content of the latest message and find the activation code.
How to install agent-email-cli
1Skills CLI (Vercel)
npx skills add zaddy6/agent-email-skill --skill agent-email-cli -a claude-code2Manually: put the files in place
~/.claude/skills/agent-email-cli/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/agent-email-cli/
1Skills CLI (Vercel)
npx skills add zaddy6/agent-email-skill --skill agent-email-cli -a codex2Manually: put the files in place
.agents/skills/agent-email-cli/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add zaddy6/agent-email-skill --skill agent-email-cli -a cursor2Manually: put the files in place
.cursor/skills/agent-email-cli/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install zaddy6/agent-email-skill agent-email-cli2Manually: put the files in place
.github/skills/agent-email-cli/SKILL.md1Skills CLI (Vercel)
npx skills add zaddy6/agent-email-skill --skill agent-email-cli -a gemini-cli2Platform CLI
gemini skills install https://github.com/zaddy6/agent-email-skill --path skills/agent-email-cliManually: put the files in place
.devin/skills/agent-email-cli/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add zaddy6/agent-email-skill --skill agent-email-cli -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about agent-email-cli
How do I install agent-email-cli in Claude Code?
Run npx skills add zaddy6/agent-email-skill --skill agent-email-cli -a claude-code in your terminal.
What does agent-email-cli do?
It provides instructions for agents to create disposable inboxes, poll for new messages, and inspect message payloads via the agent-email CLI.
What CLI tool must be installed before using this skill?
You must install @zaddy6/agentemail globally using npm install -g @zaddy6/agentemail or bun install -g @zaddy6/agentemail.