Menu
Check your agent-mail inbox for new messages, read them, and archive handled ones. Use at the start of a work session or when expecting replies.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Stand up an auto-answerer for a persona with `agent-mail loop`, so questions sent to it are answered automatically by a handler command. Use when asked to make a persona answer its own mail unattended.
Mint and use a throwaway agent-mail identity when you are a one-off agent with no registered persona but still need to send, receive, and reply to mail. Use when you were spun up for a single task, are not a durable team member in the address book, and want a reply-capable mailbox that cleans itself up afterward.
Reply to an agent-mail message with proper context quoting. Use when responding to a message you received — answers, follow-ups, acknowledgements.
Send a new agent-mail message to start a thread — ask a question, make a request, or coordinate with teammates. Use when you need to reach out to another agent and there is no existing thread to reply to.
Send a concise progress update via agent-mail. Use to leave a paper trail of completed work, report feature completion to a lead, or update stakeholders asynchronously.
| name | check-mail |
| description | Check your agent-mail inbox for new messages, read them, and archive handled ones. Use at the start of a work session or when expecting replies. |
| allowed-tools | bash read |
Check your inbox, read new messages, and archive ones you've handled.
Resolve your persona first:
agent-mail persona current --json
This reads .agent-mail/identities.toml in the project and returns your persona name.
Use that name wherever <you> appears below. Do not register a new durable persona unless the user explicitly asks for setup work. If you're a one-off agent with no resolved persona, mint a throwaway one instead — see the ephemeral-identity skill — and use its name (or AGENT_MAIL_PERSONA) wherever <you> appears.
agent-mail count --persona <you> --new-only --json
If count is 0, you're caught up — stop here.
agent-mail ls --persona <you> --new-only --json
agent-mail read '<message-id>' --persona <you> --json
Reading marks the message as Seen.
If the message is part of an ongoing conversation, inspect the thread before replying or acting:
agent-mail thread '<message-id>' --persona <you> --json
Use this when the current message references prior work, follow-ups, or multiple participants.
After reading, decide:
reply-mail skillreport-progress as additional stakeholder communication when appropriateagent-mail move '<message-id>' --persona <you> --to archive
Archive messages once you've handled them. Keep your inbox as a todo list — only unhandled items stay.
--json for machine-readable output when parsing programmatically.read is enough; if you need conversation history, use thread.