菜单
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.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
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.