Scan Inbox

scan-inbox

Scan Apple Mail inbox for unread, actionable, and priority messages. Use this when the user asks to check their email, see unread messages, find urgent emails, or triage their inbox. Returns categorized email counts and details from the last 24-48 hours.

mattnigh/skills_collection·0installs24stars

SKILL.md

Full skill instructions

Scan Inbox

Analyzes your Apple Mail inbox to identify unread, actionable, and priority messages within a specified time range.

When to Use This Skill

Activate this skill when the user asks questions like:

"Check my email"
"What unread emails do I have?"
"Any urgent emails?"
"Show me actionable items from my inbox"
"Triage my email from today"

What This Skill Does

Scans all inbox accounts in Apple Mail
Filters messages by time range (default: last 24 hours)
Identifies unread messages
Detects actionable keywords (deadline, urgent, action required, meeting, request, etc.)
Identifies priority/flagged messages
Returns structured data with counts and message details

Instructions

Step 1: Determine Time Range

Ask the user if they want a specific time range, or use these defaults:

"Today" or "recent" → 24 hours
"This week" or "recent days" → 48-72 hours
Specific request → Honor their time range

Step 2: Execute the Scan

Run the AppleScript skill using the Bash tool:

```bash osascript .claude/skills/scan-inbox/scripts/scan_inbox.scpt <hours> false ```

Parameters:

<hours>: Number of hours to look back (e.g., 24, 48, 72)
false: Set to true for priority-only mode

Step 3: Parse Results

The script returns:

success: boolean (true/false)
unreadCount: Total unread messages
actionableCount: Messages with actionable keywords
priorityCount: Flagged/priority messages
unreadList: Array of unread message details (sender, subject, date, flagged status)
actionableList: Array of actionable messages
priorityList: Array of priority messages

Step 4: Present Results to User

Format the output in a clear, actionable way:

Example Response: ``` 📬 Inbox Summary (Last 24 Hours)

📊 Overview:

38 unread messages
0 actionable items
0 priority/flagged

📧 Recent Unread:

Google - Security alert
C# Digest - Newsletter
BAC Credomatic - Transaction notification ... (showing top 5-10)

💡 Next Steps:

No urgent items requiring immediate attention
Review newsletters when you have time ```

Step 5: Offer Follow-up Actions

Ask if the user wants to:

See more details about specific emails
Flag or organize certain messages
Extract tasks from actionable emails
Check a different time range

Actionable Keywords Detected

The skill identifies these keywords in email subjects:

deadline
urgent
action required
meeting
request
please review
asap
todo
action item

Error Handling

If the script fails:

Check Mail automation permissions: System Settings → Privacy & Security → Automation → Terminal/Claude
Verify Apple Mail is running
Try with a smaller time range if timeout occurs

Example Usage

User: "Check my email from today"

Claude Response: ```bash osascript .claude/skills/scan-inbox/scripts/scan_inbox.scpt 24 false ```

Then format and present the results to the user.

Supporting Files

For advanced usage and detailed documentation, see reference.md.

For examples of common use cases, see examples.md.

Performance

Typical execution: ~2 seconds
Max timeout: 30 seconds
Works with multiple Mail accounts

Privacy Note

This skill only reads mail metadata (sender, subject, date, flags). It does not access email body content to protect privacy.

Install skill

Copy and run in your terminal

npx -y skills add https://github.com/mattnigh/skills_collection --skill ronnycoding__my-personal-assistant__claude__skills__scan-inbox__SKILL.md

View on GitHub

collection/ronnycoding__my-personal-assistant__claude__skills__scan-inbox__SKILL.md

frontend-design
Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications, OR when they provide screenshots/images/designs to replicate or draw inspiration from. For screenshot inputs, extracts design guide...
1 installs
animation-motion
CSS animations, transitions, and scroll-driven effects with accessibility (prefers-reduced-motion). Use when adding motion, hover effects, loading states, or scroll-based animations.
1 installs
laravel
Laravel v12 - The PHP Framework For Web Artisans
1 installs
gemini-document-processing
Guide for implementing Google Gemini API document processing - analyze PDFs with native vision to extract text, images, diagrams, charts, and tables. Use when processing documents, extracting structured data, summarizing PDFs, answering questions about document content, or converting documents to...
0 installs

More skills from mattnigh

mattnigh/skills_collection

spring-framework-patterns

Comprehensive Spring Framework and Spring Boot best practices including dependency injection patterns, bean lifecycle and scopes, REST API development, Spring Data JPA, service layer design, Spring Security, testing strategies, caching, AOP, async processing, error handling, and common anti-patte...

24 0

View

mattnigh/skills_collection

When Stuck - Problem-Solving Dispatch

Dispatch to the right problem-solving technique based on how you're stuck

24 0

View

mattnigh/skills_collection

.claude/skills/type-safety-patterns/SKILL.md

TypeScript厳格モードによる型安全性設計を専門とするスキル。 📖 参照書籍: - 『Effective TypeScript』（Dan Vanderkam）: 型設計 📚 リソース参照: - `resources/Level1_basics.md`: レベル1の基礎ガイド - `resources/Level2_intermediate.md`: レベル2の実務ガイド - `resources/Level3_advanced.md`: レベル3の応用ガイド - `resources/Level4_expert.md`: レベル4の専門ガイド - `resources/di...

24 0

View

mattnigh/skills_collection

deploying-cloud-k8s

Deploys applications to cloud Kubernetes (AKS/GKE/DOKS) with CI/CD pipelines. Use when deploying to production, setting up GitHub Actions, troubleshooting deployments. Covers build-time vs runtime vars, architecture matching, and battle-tested debugging.

24 0

View

mattnigh/skills_collection

moai-alfred-agent-guide

19-agent team structure, decision trees for agent selection, Haiku vs Sonnet model selection, and agent collaboration principles. Use when deciding which sub-agent to invoke, understanding team responsibilities, or learning multi-agent orchestration.

24 0

View

mattnigh/skills_collection

mermaid-diagram-generator

Converts architecture descriptions, module specs, or workflow docs into Mermaid diagrams. Use when visualizing brick module relationships, workflows (DDD, investigation), or system architecture. Supports: flowcharts, sequence diagrams, class diagrams, state machines, entity relationship diagrams,...

24 0

View

mattnigh/skills_collection

pre-flight-check

INVOKE FIRST before any code work. Validates git workflow (branch, issue, worklog) and checks approach. Use at START of every task and END before completing. Prevents skipped steps.

24 0

View

mattnigh/skills_collection

browser-dev-tools

This skill should be used when working with browser-rendered artifacts (i.e. Bun, React/React Native) to proactively validate that development work on localhost is being built appropriately and to support debugging browser-rendered content. Use this skill after making frontend changes to verify t...

24 0

View

mattnigh/skills_collection

lead-dev

Lead Développeur - Coordination technique opérationnelle, code review, mentoring et livraison. Pair de web-dev-process au niveau OPÉRATIONS.

24 0

View

mattnigh/skills_collection

worker-monitor

Monitor Docker workers, RQ queue health, and auto-scale workers (max 4). Use when: checking job progress, monitoring queue depth, scaling workers up/down, diagnosing slow processing, or waiting for jobs to complete. Referenced by data-quality skill during reprocessing.

24 0

View

mattnigh/skills_collection

quality-advisor

Proactive quality guidance system that monitors artifact creation and provides real-time feedback on documentation quality

24 0

View

mattnigh/skills_collection

bump-version

This skill should be used when the user wants to bump the version number in the workspace. It updates versions across all pyproject.toml files (root, tde, and tda packages) and the CHANGELOG.md to keep them synchronized.

24 0

View