daily-briefing

# daily-briefing

Generates a compact, warm daily message suitable for cron delivery (stdout/chat reply). Always succeeds even with minimal context.

---

## Skill Type: System Skill (Orchestrator Pattern)

This skill uses the **System Skill pattern** for execution on macOS. The agent must:

1. **Never run raw CLI commands** directly (except `curl` for weather).
2. **Always invoke the runner script** to gather data.
3. **Read gathered data from JSON** after the script completes.
4. **Generate the briefing text** using the agent's own capabilities.

**Quick reference:**
```bash
# Invoke data gatherer (waits for completion)
"{baseDir}/skills/daily-briefing/bin/run_daily_briefing.sh"

# Read output
cat /tmp/daily_briefing_data.json
```

---

## Output Contract (STRICT)

**CRITICAL:** Output **only** the briefing text. No prefaces, no explanations, no "Done", no file paths, no tool output, no markdown code fences around the briefing.

### Line 1 Format (Required)

Line 1 **must begin exactly** with the time-appropriate greeting:

```
Good {time_of_day} - Today is {Weekday}, {Month} {D}, {YYYY}. {Skies sentence}.
```

- Use **full month name** (e.g., "February", not "Feb").
- If today is the user's birthday (matched by name in contacts): replace greeting with:
  ```
  🎉 Happy Birthday! Today is {Weekday}, {Month} {D}, {YYYY}. {Skies sentence}.
  ```

### Greeting Selection (Local Time)

| Time Range | Greeting |
|------------|----------|
| 05:00–11:59 | Good morning |
| 12:00–16:59 | Good afternoon |
| 17:00–21:59 | Good evening |
| 22:00–04:59 | Good night |
| Unknown | Good morning (default) |

### Skies Sentence Rules

**If weather is usable:**
```
{Conditions} skies, around {TEMP}°{time_clause}{low_clause}{precip_clause}.
```

- Use **high temp** if reliable → time clause: " this afternoon"
- Otherwise use **current temp** → time clause: " right now"
- If low exists: append `, with a low around {LOW}°`
- If precip chance ≥30%: append `, and a {CHANCE}% chance of {ra...

# daily-briefing

🌅 Generates a warm, compact daily briefing with weather, calendar, reminders, birthdays, and important emails for cron or chat delivery.

## Features

- **Weather** — Current conditions, highs/lows, precipitation chances via wttr.in
- **Calendar Events** — Unified view from Google Calendar and iCloud Calendar
- **Reminders** — Due and past-due items from Apple Reminders
- **Birthdays** — Today and upcoming from iCloud Contacts and Google Contacts
- **Important Emails** — AI-powered semantic analysis to surface actionable emails (transactions, shipments, security alerts, etc.)
- **Cron-safe** — Always succeeds with sensible defaults; never prompts in automation mode
- **Warm, calm tone** — A gentle gift for the day with no productivity pressure

## Installation

### 1. Install via ClawHub (recommended)

```bash
clawhub install daily-briefing
```

Or copy manually to any skills directory:
- `~/.openclaw/skills/daily-briefing`
- `<workspace>/skills/daily-briefing`

### 2. Run the installer

```bash
cd <skill-directory>
chmod +x install.sh
./install.sh
```

### 3. Grant macOS permissions

Grant Terminal.app (or your terminal) access in **System Settings > Privacy & Security**:

| Permission | Required for |
|------------|--------------|
| Contacts | Birthday tracking from iCloud Contacts |
| Calendars | iCloud Calendar events (via icalpal) |
| Reminders | Apple Reminders (via remindctl) |

### 4. Install optional CLI tools

```bash
# Google services (Calendar, Gmail, Contacts)
brew install steipete/tap/gogcli

# iCloud Calendar
brew install ajrosen/tap/icalpal

# Apple Reminders
brew install steipete/tap/remindctl

# iCloud Mail
brew install himalaya
```

## Configuration

Edit `~/.openclaw/openclaw.json`:

```json
{
  "skills": {
    "entries": {
      "daily-briefing": {
        "config": {
          "location": "New York, NY",
          "timezone": "America/New_York",
          "units": "F",
          "birthdays": {
            "enabled": true,...