starred-email_skill

Overview

This skill retrieves your starred Gmail messages and produces a concise digest with metadata, short summaries, follow-up actions, and direct Gmail links. It honors optional filters for timeframe, keywords, senders/recipients, and limits results to the most relevant starred items.

How this skill works

The skill builds a Gmail query starting with is:starred and applies timeframe and user filters (relative or absolute dates, sender, recipient, subject, labels). It calls search_gmail_messages to find threads, then read_gmail_thread for full thread details, deduplicates starred instances, summarizes each starred message in ≤30 words, extracts follow-up items, and prepares Gmail links and normalized metadata for output.

When to use it

• When you want a focused view of priority messages you starred recently
• To filter starred emails by date range, keyword, sender, recipient, or label
• When preparing a quick action list from starred conversations
• To check which starred threads require follow-up or contain deadlines
• If you only need starred items rather than full inbox activity

Best practices

• Specify timeframe (today, last 7 days, since YYYY/MM/DD) to limit results; default is last 30 days
• Provide keywords or participant emails to narrow results and avoid hitting the 20-item limit
• Confirm timezone preference if you need local timestamps; otherwise UTC is used
• Expect up to 20 results by recency; if more exist, refine filters or request the next page
• Do not rely on summaries for sensitive details—open the message link for full context

Example use cases

• Show my starred emails from the last 7 days to extract immediate todos
• List starred messages with subject containing 'Invoice' to find unpaid bills
• Get starred messages from alice@example.com to follow up on her thread
• Review starred hiring threads to surface outstanding interview action items
• Produce a digest of starred client feedback for a stand-up meeting