morning-briefing

# Morning Briefing

Start your day with a single summary of everything that matters. This skill pulls your unread emails, today's calendar, pending tasks, and local weather into one concise briefing — delivered to your Telegram, Discord, or saved as a daily file.

Run it on a cron every morning, or trigger it on-demand whenever you need a status check.

## What You Get

- Unread email summary (count + top 5 by priority)
- Today's calendar events with times and locations
- Pending tasks or reminders from your task system
- Local weather forecast (temperature, conditions, rain probability)
- All in one message — no switching between 4 different apps

## Setup

### Required
- **Email access** — Gmail (via Gmail API/skill) or any email provider your agent can read
- **Calendar access** — Google Calendar API or Apple Calendar

### Optional (but recommended)
- **Weather** — No API key needed. Your agent can fetch weather from any free source (wttr.in, Open-Meteo, etc.)
- **Task system** — If you use a task manager (Todoist, Asana, Notion, plain text files), tell your agent where tasks live
- **Delivery channel** — Telegram bot, Discord bot, or file output. If no channel is configured, the briefing is saved to `memory/briefings/YYYY-MM-DD.md`

### Configuration

Tell your agent these preferences (it will store them in memory):

1. **Your timezone** — so the cron fires at the right local time
2. **Briefing time** — when you want it (default: 7:30 AM local)
3. **Email account** — which inbox to scan
4. **Calendar** — which calendar(s) to check
5. **Weather location** — your city or zip code
6. **Delivery** — where to send the briefing (Telegram, Discord, file)
7. **Format preference** — concise (bullet points) or detailed (with email previews)

## How It Works

When triggered (by cron or on-demand), your agent executes this workflow:

### Step 1: Gather Email
- Check your inbox for unread messages
- Count total unread
- Identify the top 5 by sender importance and subject urg...