drn/email
agents/skills/email/SKILL.md
Search and read Gmail messages. Use when looking up emails, reading email threads, or checking inbox labels.
$ install --global
skillsauthnpx skillsauth add drn/dots emailInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 21, 2026, 10:47 AM55.0s1 file scanned
SKILL.md
- name:
- description:
- Search and read Gmail messages. Use when looking up emails, reading email threads, or checking inbox labels.
Email (Read-Only)
Search and read Gmail messages using the gmail CLI.
Instructions
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.
Operations
# 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
Accounts
Run gmail accounts to see configured accounts with names and emails. The default account is marked with *.
Common Tasks
Find recent emails from someone
gmail search "from:emily" --limit 10
Read an email thread
# First search to find message IDs
gmail search "subject:technical kickoff" --limit 5
# Then read the specific message
gmail read MESSAGE_ID
Check unread count
gmail labels
Account Resolution
The CLI resolves accounts in this order:
--account NAMEflag — uses~/.dots/sys/gmail/tokens/NAME.json- Default account from
~/.dots/sys/gmail/accounts.json - First token file found in
~/.dots/sys/gmail/tokens/
Search Syntax
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 filters
Capabilities
- Email search: Full Gmail query syntax with pagination
- Email reading: Full message content including headers, body text, and attachment metadata
- Label listing: All labels with message counts (total and unread)
- Account listing: Show all configured accounts with default marker
Troubleshooting
If 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.
Limitations
- Read-only — Cannot send, draft, archive, or modify emails. For composing replies, draft the text in the conversation for manual copy/paste.
- Message body is truncated at 5000 characters
Related Skills
drn/slides
development
VerifiedTrustedCommunity
Build a self-contained, single-file HTML presentation deck from talking points or a source doc, using a terminal/TUI-styled template with keyboard, tap, and swipe navigation. Use when the user wants to create slides, build a presentation or deck, turn talking points or a doc into a talk, make an HTML slideshow, or produce a presentation as a shareable artifact (instead of Google Slides).
23SKILL.mdUpdated Jun 13, 2026
drn/markdown-preview
development
VerifiedTrustedCommunity
Render a Markdown file to GitHub-flavored HTML and open a styled local preview (light + dark) in the browser. Use when the user wants to preview markdown, see how a README renders on GitHub, check that relative screenshots or images display correctly, or get a GitHub-like local preview without installing grip or glow.
23SKILL.mdUpdated Jun 13, 2026
drn/complete
tools
VerifiedTrustedCommunity
Mark the current Argus task as complete. Use when the work for the current worktree is done and the user wants the task to transition to the "complete" status.
23SKILL.mdUpdated Jun 13, 2026
drn/orchestrate
development
VerifiedTrustedCommunity
Launch a dynamic Workflow where the top-tier session model (Fable) 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 planning with sonnet and opus implementation, or tiered agents.
23SKILL.mdUpdated Jun 12, 2026