Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Generates a warm, compact daily briefing with weather, calendar, reminders, birthdays, and important emails for cron or chat delivery.
Generates a warm, compact daily briefing with weather, calendar, reminders, birthdays, and important emails for cron or chat delivery.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
Generates a compact, warm daily message suitable for cron delivery (stdout/chat reply). Always succeeds even with minimal context.
This skill uses the System Skill pattern for execution on macOS. The agent must: Never run raw CLI commands directly (except curl for weather). Always invoke the runner script to gather data. Read gathered data from JSON after the script completes. Generate the briefing text using the agent's own capabilities. Quick reference: # Invoke data gatherer (waits for completion) "{baseDir}/skills/daily-briefing/bin/run_daily_briefing.sh" # Read output cat /tmp/daily_briefing_data.json
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 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}.
Time RangeGreeting05:00β11:59Good morning12:00β16:59Good afternoon17:00β21:59Good evening22:00β04:59Good nightUnknownGood morning (default)
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 {rain/snow/precipitation} If weather is not usable: Use exact fallback: I can't access weather right now.
{Line 1: Greeting with skies sentence} {Birthdays section - only if any today or upcoming} {Calendar events section - only if any} {Reminders section - only if any} {Important emails section - only if enabled and any} {Anchors - only if real priorities from context} {Closing line - always required} Always include a blank line after Line 1. Each section separated by a blank line if present. Target ~5β15 lines depending on enabled integrations.
Gentle gift for the day: warm, calm, compassionate, quietly hopeful. No scolding, no urgency, no productivity pressure. Telegram-friendly: short lines, roomy spacing, easy to skim.
If interactive AND missing critical info (location/timezone/units): Prompt briefly for missing info before generating briefing. Offer toggles for integrations. Mention the important emails feature: explain it uses AI-powered semantic analysis to surface actionable emails (transactions, shipments, security alerts, etc.) and can be enabled via emails.enabled in config; note iCloud Mail requires an app-specific password (emails.icloudPassword). If non-interactive (cron/automation): Do NOT ask questions (cron-safe). Use defaults. Do NOT create/modify any files. Do NOT spawn background tasks/sub-agents. Omit weather if location is unavailable.
"{baseDir}/skills/daily-briefing/bin/run_daily_briefing.sh" The runner script executes scripts/daily_briefing_orchestrator.sh. TCC permissions are granted to Terminal.app (or the calling process).
After the app completes, read: /tmp/daily_briefing_data.json JSON structure: { "generated_at": "ISO timestamp", "system": { "timezone": "America/New_York", "local_time": "2024-02-03T08:30:00", "hour": 8 }, "config": { "location": "New York, NY", "units": "C", "birthdays_enabled": true, "birthdays_lookahead": 14, "calendar_google_enabled": true, "calendar_icloud_enabled": true, "calendar_lookahead": 0, "reminders_enabled": true, "reminders_due_filter": "today", "reminders_include_past_due": true, "emails_enabled": false, "emails_limit": 10, "emails_sort_newest": true, "emails_starred_first": true, "emails_unread_only": true }, "birthdays": { "available": true, "user_birthday_today": false, "data": [ {"name": "Jane Doe", "date": "2024-02-03", "days_until": 0}, {"name": "John Smith", "date": "2024-02-05", "days_until": 2} ] }, "calendar": { "available": true, "data": [ {"title": "Team standup", "start": "09:00", "end": "09:30", "all_day": false, "date": "2024-02-03", "source": "google"}, {"title": "Doctor appointment", "start": null, "end": null, "all_day": true, "date": "2024-02-03", "source": "icloud"} ] }, "reminders": { "available": true, "data": [ {"title": "Pick up prescription", "due": "2024-02-03"} ] }, "emails": { "available": true, "data": [ {"id": "abc123", "from": "Amazon", "from_email": "shipment@amazon.com", "subject": "Your order has shipped", "preview": "Your package is on its way...", "starred": false, "unread": true, "date": "2024-02-03T07:30:00Z", "source": "gmail"}, {"id": "def456", "from": "Chase", "from_email": "alerts@chase.com", "subject": "Payment received", "preview": "We received your payment of...", "starred": true, "unread": true, "date": "2024-02-03T06:15:00Z", "source": "icloud"} ] }, "contacts": { "available": true, "data": [ {"name": "Jane Doe", "email": "jane@example.com"}, {"name": "John Smith", "email": "john@example.com"} ] } }
The agent must fetch weather directly using curl (not via orchestrator): curl -fsSL --max-time 12 "https://wttr.in/{ENCODED_LOCATION}?format=j1" Location: Use config.location from gathered data; if empty/null, weather is unavailable. Retry: Retry once on failure. If still failing or unusable: Weather is unavailable; use fallback sentence. Parse from JSON response: Conditions: current_condition[0].weatherDesc[0].value Current temp (C): current_condition[0].temp_C Current temp (F): current_condition[0].temp_F High temp (C): weather[0].maxtempC High temp (F): weather[0].maxtempF Low temp (C): weather[0].mintempC Low temp (F): weather[0].mintempF Precip chance: max of weather[0].hourly[*].chanceofrain (as integers) Units: Use config.units ("C" or "F"). Default to Celsius if unknown. CRITICAL: Do NOT output raw curl/tool output. Do NOT use wttr.in one-line formats.
Only if config.emails_enabled is true and emails.available is true. For each email in emails.data, use the agent's own semantic analysis to determine importance. Important Email Criteria (any match qualifies): From contacts in the gathered contacts list Order shipment notifications Receipts for purchases or transaction confirmations Incoming/outgoing transaction alerts Refund-related messages Customer service interactions Upcoming subscription renewal notices Upcoming payment heads-up notices Technical newsletters Job application updates Messages from recruiters (exclude WITCH-like outsourcing firms) Banking alerts Calendar invites Account security emails (e.g., "your account is locked") Shared items (e.g., Google Drive shares) Wishlist-related alerts Starred/flagged emails (positive signal, not sole determinant) Any other contextually important emails Exclusions: The following are never important, even if matching other criteria: Promotional/marketing emails LinkedIn Job Alert emails (LinkedIn message notifications are fine) Unsolicited recruiter/job-posting emails and mass hiring notices (e.g., subjects or bodies containing keywords like "hire", "hiring", "job", "position", "onsite", "fulltime", "recruiter", "application", or obvious bulk outreach), unless the sender is in the user's contacts or the message is starred/readily identified as personally relevant. Product announcement / product update emails and vendor/platform notifications (e.g., "[Product Update]", release announcements, automatic enablement notices), unless the sender is in the user's contacts or the message is explicitly starred. Vendor newsletters, community announcements, and general technical mailing-list posts (e.g., blog posts, release notes, product previews, digests), unless clearly personal or from a contact. Failure behavior: If semantic analysis fails, silently omit the entire email section. Apply filters and sorting: Filter by emails_unread_only if true If emails_starred_first is true, starred emails first Sort by date per emails_sort_newest Limit to emails_limit
Using all gathered and processed data, compose the briefing text following the Output Contract. Section Formats: Birthdays: π **Birthdays:** β’ Today: Name β’ Feb 5: Name Group multiples per date Today entries first Up to 5 upcoming (excluding today) Calendar Events: π **Today's schedule:** β’ All-day: Event title β’ 9:00 AM: Event title Single day: "Today's schedule" Multi-day: "Schedule" with "Today/Tomorrow/{Month} {D}" labels All-day events first, then timed by start Up to 3 events per day Reminders: β **Reminders:** β’ Pick up prescription Due-today reminders only Up to 3 reminders Important Emails: π§ **Emails needing attention:** β’ Amazon: Your order has shipped β’ Chase: Payment received Format: β’ Sender: Subject (truncated if needed) Anchors: Only if you can confidently infer 1β3 real priorities from user-provided context. Plain bullets, no heading. If not real/uncertain, omit entirely (do not invent). Closing Line: Required. Use the quote field from the gathered JSON data. The orchestrator provides a random motivational quote each run.
Return only the briefing text. Nothing else.
Configuration is read from ~/.openclaw/openclaw.json at path skills.entries.daily-briefing.config: { "skills": { "entries": { "daily-briefing": { "config": { "location": "New York, NY", "timezone": "America/New_York", "units": "C", "birthdays": { "enabled": true, "lookahead": 14, "sources": ["contacts", "google"] }, "calendar": { "enabled": true, "lookahead": 0, "sources": ["google", "icloud"] }, "reminders": { "enabled": true }, "emails": { "enabled": false, "icloudPassword": "", "limit": 10, "sortNewest": true, "starredFirst": true, "unreadOnly": true } } } } } }
OptionTypeDefaultDescriptionlocationstring""Location for weather (e.g., "New York, NY")timezonestringsystemTimezone (e.g., "America/New_York")unitsstring"C"Temperature units: "C" or "F"birthdays.enabledbooltrueEnable birthday trackingbirthdays.lookaheadint14Days ahead to show upcoming birthdaysbirthdays.sourcesarray["contacts"]Sources: "contacts" (iCloud), "google"calendar.enabledbooltrueEnable calendar eventscalendar.lookaheadint0Days ahead (0 = today only)calendar.sourcesarray["google", "icloud"]Calendar sourcesreminders.enabledbooltrueEnable Apple Remindersreminders.dueFilterstring"today"Due date filter: "today", "week", or "all"reminders.includePastDuebooltrueInclude overdue/past-due remindersemails.enabledboolfalseEnable important emails featureemails.icloudPasswordstring""iCloud Mail app-specific passwordemails.limitint10Maximum emails to showemails.sortNewestbooltrueSort newest firstemails.starredFirstbooltruePrioritize starred emailsemails.unreadOnlybooltrueOnly show unread emails
Timezone: User's local timezone; fallback to UTC if unknown. Location: User's location if present; omit weather if unavailable in cron mode. Units: User's preferred units if known; otherwise Celsius.
Required: curl β for weather fetching bash β for orchestrator script Optional: gog β brew install steipete/tap/gogcli (Google Calendar, Gmail, Contacts) icalpal β brew install ajrosen/tap/icalpal (iCloud Calendar) himalaya β brew install himalaya (iCloud Mail via IMAP)
daily-briefing/ βββ SKILL.md βββ README.md βββ install.sh βββ scripts/ β βββ daily_briefing_orchestrator.sh βββ bin/ βββ run_daily_briefing.sh (created by install.sh)
Good morning - Today is Saturday, February 3, 2024. Partly cloudy skies, around 45Β°F this afternoon, with a low around 32Β°F. π **Birthdays:** β’ Today: Jane Doe β’ Feb 5: John Smith π **Today's schedule:** β’ All-day: Doctor appointment β’ 9:00 AM: Team standup β **Reminders:** β’ Pick up prescription π§ **Emails needing attention:** β’ Amazon: Your order has shipped β’ Chase: Payment received Take things one step at a time todayβyou've got this.
"{baseDir}/skills/daily-briefing/bin/run_daily_briefing.sh" --cleanup
Workflow acceleration for inboxes, docs, calendars, planning, and execution loops.
Largest current source with strong distribution and engagement signals.