gws-gmail-triage
Manage Gmail Inbox Efficiently
Quickly scan and prioritize unread Gmail messages without opening your browser. This skill provides sender, subject, and date information to help you triage your inbox efficiently.
Download the skill ZIP
Upload in Claude
Go to Settings → Capabilities → Skills → Upload skill
Toggle on and start using
Test it
Using "gws-gmail-triage". Show me my unread Gmail messages
Expected outcome:
Displays a formatted table with columns for sender, subject, and date for up to 20 unread messages
Using "gws-gmail-triage". Export unread messages to JSON and extract the subject lines
Expected outcome:
Returns JSON array of message objects, then filters and displays only the subject fields using jq
Security Audit
SafeStatic analysis detected 13 potential security issues, all are FALSE POSITIVES. The 'external_commands' patterns appear in markdown code blocks showing command-line usage examples. The 'filesystem' patterns are relative markdown links to other documentation files. The 'weak cryptography' patterns match text in YAML description and markdown table headers, not actual cryptographic implementations. This is a documentation-only skill that provides instructions for using the Google Workspace CLI tool.
Risk Factors
⚙️ External commands (8)
📁 Filesystem access (3)
Quality Score
What You Can Build
Quick Inbox Scan
Rapidly review new unread emails to identify urgent messages requiring immediate attention
Targeted Email Search
Find specific unread messages from important senders using Gmail query filters
Batch Email Processing
Export unread message data to JSON for automated analysis or integration with other tools
Try These Prompts
Show me my unread Gmail messages
Show the last 5 unread messages from my boss
Find unread messages with the label 'urgent' and show them with labels
Export unread messages to JSON and extract just the subject lines
Best Practices
- Start with the basic command without flags to get a quick overview of your unread inbox
- Use the --max flag to limit results when you only need to see the most recent messages
- Combine with Gmail search queries using --query to filter by sender, date, label, or other criteria
- Pipe JSON output to jq or other tools when you need to extract specific fields or process data programmatically
Avoid
- Do not expect to read full message content—this tool only shows metadata (sender, subject, date)
- Do not use for bulk email management—this is a read-only triage tool, not a management interface
- Do not forget to run 'gws generate-skills' if you get a 'missing shared skill' error