email-agent_skill

Overview

This skill integrates Gmail via the AtrisOS API to read, send, draft, and archive emails programmatically. It handles authentication bootstrap, message listing, threaded replies, draft management, and batch archiving while enforcing safe archiving rules. Use it when you want a controlled, scriptable interface to your Gmail account from an agent.

How this skill works

Before any operation the skill runs a bootstrap that ensures the Atris CLI is installed and the local Atris token is available. It calls AtrisOS Gmail endpoints to list messages, read single messages, create/send drafts, reply within threads (using thread_id and reply_to_message_id), and archive messages or batches. All requests require the local Atris token and the skill checks connection status and common error states (token expiry, disconnected Gmail, rate limits).

When to use it

• Ask the agent to check or summarize your inbox (new or unread messages).
• Compose, preview, and send an email or save it as a draft for review.
• Reply to a specific message while preserving Gmail threading.
• Clean up or batch-archive low-value emails after confirming with you.
• List, read, update, or send drafts stored in Gmail.

Best practices

• Always run the bootstrap step once to validate the Atris token and Gmail connection before calling endpoints.
• Show generated drafts or reply drafts to the user and get explicit approval before sending.
• When replying, include thread_id and reply_to_message_id to preserve threading and set subject to "Re: ...".
• Handle errors by prompting re-authentication on token expiry and wait/retry on rate limit responses.

Example use cases

• "Check my emails from today" — bootstrap, list inbox messages newer_than:1d, return sender/subject/snippet.
• "Draft an email to Alice about the Q2 report" — compose draft, show user for approval, save as draft if requested.
• "Reply to Jane's message" — fetch message id and thread_id, draft reply, show preview, send with thread_id and reply_to_message_id.
• "Archive all newsletters" — search by sender/subject patterns, show list for confirmation, batch-archive on approval.
• "Send an existing draft" — list drafts, select matching draft, confirm, then send the draft by id.