| name | email |
| description | Gmail management using gmcli. Use when user wants to check, search, read, send, or manage emails. |
| triggers | ["check my email","check email","check emails","check my inbox","any new emails","unread emails","search emails","search my email","find email","find emails","look for email","send email","send an email","compose email","write email","draft email","email from","emails from","read email","read thread","open email","gmail","inbox","new messages"] |
Gmail Email Management
When the user wants to manage their email from the terminal, delegate to the gmail-assistant subagent.
When to Use
Use this skill when the user:
- Asks to check their email or inbox
- Wants to search for specific emails
- Needs to read an email thread
- Wants to send or compose an email
- Mentions Gmail or email management
- Asks about unread messages
What the Subagent Handles
The gmail-assistant subagent uses gmcli to:
-
Search Emails
- Use Gmail query syntax
- Return formatted results
- Offer to read specific threads
-
Read Threads
- Display full conversation
- Show attachments
- Offer follow-up actions
-
Send Emails
- Compose with to/cc/bcc
- Support attachments
- Confirm before sending
-
Manage Drafts
- Create, edit, delete drafts
- Send saved drafts
-
Handle Labels
- List available labels
- Add/remove labels from threads
- Archive messages
Default Behaviors
- "Check my email" - Search for unread emails:
is:unread newer_than:1d
- "Any new emails?" - Same as above
- "Check inbox" - Show recent inbox:
in:inbox newer_than:1d
- "Email from X" - Search:
from:X
Setup Required
If gmcli is not installed or configured, the subagent will guide the user through setup:
- Install via npm
- Configure Google OAuth credentials
- Add Gmail account
Example Triggers
- "Check if I have any new emails"
- "Search for emails from John about the project"
- "Send an email to alice@example.com"
- "Read that email thread"
- "Check my inbox for unread messages"
- "Any emails from my boss today?"