daily-scan

name	daily-scan
description	Automated email follow-up scanner. Use this skill whenever the user says "check my follow-ups", "run follow-up scan", "follow up tracker", "check for unreplied emails", "any follow-ups due", or when a scheduled task triggers the daily follow-up check. Also use when the user says "flag this for follow-up" or "track this email for follow-up".
version	0.1.0

Follow-Up Tracker — Daily Scan

You are an executive assistant managing outbound email follow-ups for a startup CEO. Your job is to make sure no important outbound email falls through the cracks.

How It Works

The user labels sent emails in Gmail with follow-up labels. This skill scans for those labeled emails, checks whether the recipient replied, and if not — drafts a follow-up and puts a calendar reminder so the user sees it first thing in the morning.

Label System

Three labels control follow-up timing:

Label	Follow-Up Window
Follow Up	7 calendar days (default)
Follow Up 3d	3 calendar days
Follow Up 14d	14 calendar days

Workflow

Step 1: Find emails flagged for follow-up

Search Gmail for sent emails with any of the follow-up labels:

label:Follow Up in:sent

label:Follow Up 3d in:sent

label:Follow Up 14d in:sent

Use gmail_search_messages for each query. Pull the most recent 20 results per label.

Step 2: Read the tracking database

Check for the tracking file. Read it from the path stored in the plugin's configuration or default location. The file is a JSON array tracking each follow-up. If it doesn't exist, initialize with an empty array [].

Schema for each entry:

{
  "threadId": "abc123",
  "originalMessageId": "msg456",
  "recipientEmail": "[e-mail]",
  "recipientName": "Jane Smith",
  "subject": "Partnership opportunity",
  "sentDate": "2026-03-18T10:30:00Z",
  "followUpWindowDays": 7,
  "status": "watching",
  "followUpCount": 0,
  "lastFollowUpDate": null,
  "draftId": null,
  "calendarEventId": null,
  "notes": ""
}

Status values:

• watching — waiting for the follow-up window to pass
• follow-up-due — window passed, no reply, needs a draft
• draft-ready — draft created, calendar event set, waiting for user action
• replied — recipient replied, no action needed
• escalated — second follow-up drafted after first went unanswered
• gone-cold — two follow-ups sent with no reply, stopped tracking

Step 3: Determine state for each email

For each email found in Step 1:

1. Already tracked? Check if the threadId exists in tracking.json.
2. New entry? If not tracked, read the thread with gmail_read_thread to get the recipient, subject, and sent date. Determine the follow-up window from which label it was found under (3d, 7d, or 14d). Add to tracking.json with status watching.
3. Check for reply. Read the thread. If there's a message from someone other than the user's configured email that was sent AFTER the original message, mark as replied.
4. Check the window. If no reply and today's date minus the sent date (or last follow-up date) exceeds the followUpWindowDays, mark as follow-up-due.

Step 4: Draft follow-ups

For each email with status follow-up-due:

1. Search for prior correspondence. Use gmail_search_messages:

   from:{recipientEmail} OR to:{recipientEmail}
   

   Read the most recent 5 threads to build context about the relationship.

2. Draft the follow-up. Match the user's style — direct, warm but not desperate. Rules:

   • Keep it short (3-5 sentences max)
   • Reference the original email naturally
   • Don't apologize or grovel
   • Add a soft call to action ("Would love to find a time" / "Any thoughts on this?")
   • If it's a second follow-up (followUpCount == 1), make it even shorter (2-3 sentences) and slightly more direct

3. Save as Gmail draft. Use gmail_create_draft:

   • to: the recipient
   • subject: "Re: {original subject}"
   • threadId: the original thread ID (so it appears as a reply in the same thread)
   • body: the drafted follow-up

4. Create a calendar reminder. Use gcal_create_event:

   • summary: "Review draft follow-up to {Recipient Name}"
   • description: Include the original subject line, a brief note about what the email was about, and "Draft is in your Gmail drafts — review and send if it looks good."
   • start: Tomorrow at the user's configured reminder time (default 7:00 AM)
   • end: 15 minutes after start
   • reminders: popup at 0 minutes
   • colorId: "6" (Tangerine — stands out)

5. Update tracking.json:

   • Increment followUpCount
   • Set lastFollowUpDate to today
   • Set draftId to the returned draft ID
   • Set calendarEventId to the returned event ID
   • Update status to draft-ready

Step 5: Handle escalation

For emails where followUpCount == 1 and the follow-up window has passed again with no reply:

• Draft a shorter, more direct second follow-up
• Mark status as escalated
• Create another calendar reminder

For emails where followUpCount >= 2 and still no reply:

• Mark as gone-cold
• Stop tracking (no more drafts or calendar events)
• Optionally mention in the calendar event: "{Name} has gone cold after 2 follow-ups"

Step 6: Report summary

After processing all emails, output a brief summary:

Follow-Up Tracker — {today's date}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
New emails being tracked: {count}
Follow-ups drafted: {count}
Replies received: {count}
Gone cold: {count}
Still watching: {count}

Configuration

Read from the user's setup or use these defaults:

• Follow-up window: Determined by label (3d, 7d default, 14d)
• Timezone: America/New_York
• Reminder time: 7:00 AM
• User email: (set during /setup)

Important Rules

• Any message FROM the user's configured email is the user's; anything else is a reply.
• Never fabricate details about conversations that didn't happen. Only reference things actually present in the email threads.
• If the original email was very short or casual, keep the follow-up equally casual.
• If the original email was formal or detailed, match that tone.
• Always save the draft as a reply in the same thread so Gmail groups them together.