abdullahbeam/gmail
00-system/skills/google/gmail/SKILL.md
Read, send, and manage Gmail emails. Load when user mentions 'gmail', 'email', 'send email', 'check email', 'inbox', 'draft', or references sending/reading emails.
$ install --global
skillsauthnpx skillsauth add abdullahbeam/nexus-design-abdullah gmailInstall 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 1, 2026, 1:35 AM57.7s2 files scanned
SKILL.md
- name:
- gmail
- version:
- 1.3
- description:
- Read, send, and manage Gmail emails. Load when user mentions 'gmail', 'email', 'send email', 'check email', 'inbox', 'draft', or references sending/reading emails.
Purpose
Automate Gmail operations including reading, sending, replying, forwarding, and managing emails. Useful for email automation, inbox management, and communication workflows.
Gmail
Read, send, and manage Gmail via OAuth authentication.
CRITICAL SAFETY RULES
These rules are MANDATORY and must NEVER be bypassed:
1. NEVER Send Without Explicit Approval
- ALWAYS show the user the complete email (to, subject, body) before sending
- ALWAYS ask for explicit confirmation: "Do you want me to send this email? (yes/no)"
- NEVER auto-send emails, even if user says "send an email to X"
- NEVER send multiple emails in a loop without per-email confirmation
2. Draft-First Workflow (DEFAULT BEHAVIOR)
- ALL send/reply/forward operations create a draft FIRST
- User sees the draft and chooses:
yes(send now),no(delete draft), orkeep-draft(review in Gmail) - This ensures user can ALWAYS review in Gmail UI before any email is sent
3. Sensitive Operations Require Confirmation
| Operation | Requires Confirmation | |-----------|----------------------| | Send email | YES - ALWAYS | | Reply to email | YES - ALWAYS | | Forward email | YES - ALWAYS | | Send draft | YES - ALWAYS | | Delete draft | Yes | | Trash email | Yes |
4. Read Operations Are Safe
These do NOT require confirmation:
- List emails, Search emails, Read email content
- List labels, List drafts, Get attachment
Pre-Flight Check (ALWAYS RUN FIRST)
python3 00-system/skills/google/google-master/scripts/google_auth.py --check --service gmail
Exit codes:
- 0: Ready to use - proceed with user request
- 1: Need to login - run
python3 00-system/skills/google/google-master/scripts/google_auth.py --login - 2: Missing credentials or dependencies - see ../google-master/references/setup-guide.md
Quick Reference
List Emails
python3 00-system/skills/google/gmail/scripts/gmail_operations.py list --max 10
List Unread Emails
python3 00-system/skills/google/gmail/scripts/gmail_operations.py list --query "is:unread" --max 10
Search Emails
python3 00-system/skills/google/gmail/scripts/gmail_operations.py search "from:[email protected] subject:report"
Read Email
python3 00-system/skills/google/gmail/scripts/gmail_operations.py read <message_id>
Send Email
python3 00-system/skills/google/gmail/scripts/gmail_operations.py send --to "[email protected]" --subject "Hello" --body "Message body"
Reply to Email
python3 00-system/skills/google/gmail/scripts/gmail_operations.py reply <message_id> --body "Reply text"
Forward Email
python3 00-system/skills/google/gmail/scripts/gmail_operations.py forward <message_id> --to "[email protected]"
Create Draft
python3 00-system/skills/google/gmail/scripts/gmail_operations.py draft --to "[email protected]" --subject "Draft" --body "Content"
List Drafts
python3 00-system/skills/google/gmail/scripts/gmail_operations.py drafts
List Labels
python3 00-system/skills/google/gmail/scripts/gmail_operations.py labels
Trash/Archive/Mark Read
python3 00-system/skills/google/gmail/scripts/gmail_operations.py trash <message_id>
python3 00-system/skills/google/gmail/scripts/gmail_operations.py archive <message_id>
python3 00-system/skills/google/gmail/scripts/gmail_operations.py mark-read <message_id>
Gmail Search Syntax
| Operator | Example | Description |
|----------|---------|-------------|
| from: | from:[email protected] | Emails from sender |
| to: | to:[email protected] | Emails to recipient |
| subject: | subject:meeting | Subject contains word |
| is:unread | is:unread | Unread emails |
| has:attachment | has:attachment | Has attachments |
| after: | after:2024/01/01 | After date |
| before: | before:2024/12/31 | Before date |
| label: | label:important | Has label |
Error Handling
See ../google-master/references/error-handling.md for common errors and solutions.
Setup
First-time setup: ../google-master/references/setup-guide.md
Quick start:
pip install google-auth google-auth-oauthlib google-api-python-client- Create OAuth credentials in Google Cloud Console (enable Gmail API, choose "Desktop app")
- Add to
.envfile at Nexus root:GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com GOOGLE_CLIENT_SECRET=your-client-secret GOOGLE_PROJECT_ID=your-project-id - Run
python3 00-system/skills/google/google-master/scripts/google_auth.py --login
Related Skills
abdullahbeam/mental-models
development
VerifiedTrustedCommunity
Load when user says "mental model", "think through this", "structured thinking", "help me decide", "analyze this problem", "first principles", "pre-mortem", "stakeholder mapping", "what framework should I use", or any specific model name. Provides 59 thinking frameworks for decision-making, problem decomposition, and strategic analysis.
2SKILL.mdUpdated Mar 30, 2026
abdullahbeam/generate-philosophy-doc
development
VerifiedTrustedCommunity
Generate comprehensive philosophy and standards documents for any domain (UX design, landing pages, email outbound, API design, etc.). Load when user says "create philosophy doc", "generate standards for [domain]", "build best practices guide", or "create benchmarking document". Conducts deep research, synthesizes findings, and produces structured philosophy documents with principles, frameworks, anti-patterns, checklists, case studies, and metrics.
2SKILL.mdUpdated Mar 30, 2026
abdullahbeam/validate-system
development
VerifiedTrustedCommunity
Validate Nexus-v3 system integrity and fix common issues automatically. Load when user mentions "validate system", "check system", or "fix problems". Runs comprehensive checks on folder structure, metadata files, and framework consistency with auto-repair capabilities.
2SKILL.mdUpdated Mar 30, 2026
abdullahbeam/validate-docs-implementation
development
VerifiedTrustedCommunity
Load when user says "validate docs", "check documentation consistency", "docs vs implementation", or "find documentation mismatches". Systematically compares implementation code against documentation to identify and fix inconsistencies.
2SKILL.mdUpdated Mar 30, 2026