zaddy6/agent-email-skill2.1k installs

agent-email-cli

Q: How do I install this agent skill?

Run npx skills add https://github.com/zaddy6/agent-email-skill --skill agent-email-cli.

Q: Is this agent skill safe to install?

Review the displayed partner audits, complete source, permissions, dependencies, and exact revision before installing.

Operate the agent-email CLI to create disposable inboxes, poll for new mail, retrieve full message details, and manage local mailbox profiles. Use when the user needs terminal-based email inbox access for LLM or agent automation workflows.

How do I install this agent skill?

npx skills add https://github.com/zaddy6/agent-email-skill --skill agent-email-cli

view source ↗

Is this agent skill safe to install?

Gen Agent Trust Hubpass
This skill enables the agent to use a CLI tool to manage disposable email accounts. It involves installing a vendor-owned npm package and executing terminal commands. The primary security consideration is that the agent processes untrusted email content from external sources, which creates a potential surface for indirect prompt injection.
Socketpass
No alerts
Snykfail
Risk: HIGH · No issues
Runlayerpass
2/3 files flagged

What does this agent skill do?

Agent Email CLI

Overview

Use this skill to operate the agent-email command safely and predictably for agent workflows that need inbox access.

Prefer JSON-native command output and return key fields (email, messageId, subject, createdAt, from.address) in your summaries.

Workflow

Verify CLI availability.

command -v agent-email
agent-email --help

If missing, install:

npm install -g @zaddy6/agentemail
# or
bun install -g @zaddy6/agentemail

Create a mailbox account.

agent-email create

Record these fields from JSON output:

data.email
data.accountId
data.activeEmail

Do not record, repeat, or print secret values such as mailbox passwords or tokens.

Read latest messages.

agent-email read <email|default>

For inbox waiting/polling:

agent-email read <email|default> --wait 30 --interval 2

For full message payloads:

agent-email read <email|default> --full

Retrieve one message in detail.

agent-email show <email|default> <messageId>

Use show when you need body/source details for verification links, codes, or full content extraction.

Manage mailbox profiles.

agent-email accounts list
agent-email use <email|default>
agent-email accounts remove <email>

Avoid commands that require entering secrets on the command line in agent logs.

Delete processed/irrelevant message when requested.

agent-email delete <email|default> <messageId>

Operational Guidance

Keep command output machine-readable; avoid forcing human output unless requested.
Prefer default alias when user does not specify an email.
Never echo, store, or summarize secret values (password, token) from command output.
If command fails, surface the JSON error code and hint fields directly.
For auth failures (AUTH_REQUIRED/401), rerun command once and request user intervention if credentials must be re-established.
For rate limits (RATE_LIMITED/429), retry after short delay.

Troubleshooting

command not found: ensure ~/.bun/bin or npm global bin path is on PATH.
NO_ACTIVE_ACCOUNT: run agent-email create or agent-email use <email>.
ACCOUNT_NOT_FOUND: run agent-email accounts list and pick a valid address.
EOTP during npm publish: use npm trusted publishing for CI or publish locally with OTP.

References

For command cheat sheet and JSON field map, read references/commands.md.

How can the creator link this skill?

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/zaddy6/agent-email-skill/agent-email-cli">View agent-email-cli on skillZs</a>