Menu
Search and read Gmail messages. Use when looking up emails, reading email threads, or checking inbox labels.
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
Safely add a directory to Claude Code's Bash tool PATH. Use when a binary runs in your terminal but is "command not found" inside Claude Code's Bash tool, when adding a directory to PATH for Claude Code, when configuring CLAUDE_ENV_FILE, or when settings.json env.PATH did not work. Explains why env.PATH replaces rather than appends PATH and is not variable-expanded, why ~/.zshrc PATH exports are dropped, and the supported SessionStart hook fix.
Create or improve a Claude Code skill/slash command with best practices for structure, dynamic context, and safety. Use for creating new skills, improving existing ones, or learning skill authoring.
Launch a dynamic Workflow where the top-tier session model (Fable, or Opus when Fable is unavailable) handles planning and orchestration while implementation subagents run on Sonnet for routine tasks and Opus for complex ones. Use when the user wants to orchestrate a build, a dynamic workflow, a model-tiered build, fable or opus planning with sonnet and opus implementation, or tiered agents.
Open a PR, wait for CI to pass, fix failures, address review comments, and loop until fully green. Use when opening a PR, fixing CI, or addressing review feedback.
Manage recurring tasks in the local Argus daemon via its HTTP API. Use when the user wants to schedule a task locally in argus, create a cron-driven task, fire X every weekday/hour/morning, set up a recurring agent that needs local filesystem access (logs in ~/.argus, local databases, dotfiles), list or update existing argus schedules, or run an argus schedule now. Distinct from /schedule, which creates remote cloud routines without local access.
Generate a handoff prompt to pass context to another agent thread. Use when switching repos, handing off work, or sharing context between agents.
| name | |
| description | Search and read Gmail messages. Use when looking up emails, reading email threads, or checking inbox labels. |
Search and read Gmail messages using the gmail CLI.
You are helping read Gmail data. Auth uses OAuth tokens stored at ~/.dots/sys/gmail/tokens/. Additional env vars (if any) are loaded from ~/.dots/sys/env.
# Search emails
gmail search "from:emily subject:kickoff" # Search by sender and subject
gmail search "is:unread" --limit 10 # Recent unread
gmail search "after:2025/01/01 from:sarah" # Date-filtered search
# Read a specific email
gmail read MESSAGE_ID # Read full email by ID
# List labels with message counts
gmail labels
# List configured accounts
gmail accounts
# Use a specific account
gmail search "budget" --account personal
gmail labels --account work
# Re-authenticate an account (opens browser for OAuth)
gmail auth personal
# JSON output
gmail search "quarterly review" --json
gmail accounts --json
Run gmail accounts to see configured accounts with names and emails. The default account is marked with *.
gmail search "from:emily" --limit 10
# First search to find message IDs
gmail search "subject:technical kickoff" --limit 5
# Then read the specific message
gmail read MESSAGE_ID
gmail labels
The CLI resolves accounts in this order:
--account NAME flag — uses ~/.dots/sys/gmail/tokens/NAME.json~/.dots/sys/gmail/accounts.json~/.dots/sys/gmail/tokens/Gmail search supports standard Gmail query operators:
from:sender — messages from a specific senderto:recipient — messages to a specific recipientsubject:words — subject line searchafter:YYYY/MM/DD / before:YYYY/MM/DD — date rangeis:unread / is:starred — message statehas:attachment — messages with attachmentslabel:NAME — messages with a specific labelin:inbox / in:sent — location filtersIf a search or read fails with invalid_grant or Token has been expired or revoked, re-authenticate:
gmail auth ACCOUNT_NAME
This opens the browser for OAuth consent and saves the new token.