alerts

name	alerts
description	Send alerts and notifications using AppleScript - banners, modals, and text-to-speech

Alerts Skill

Send alerts and notifications to Matt using AppleScript.

When to Use

• Reminders that need immediate attention
• Completion notifications for long-running tasks
• Important alerts that shouldn't be missed

Alert Types

Non-Modal (Banner/Notification Center)

Use for informational alerts that don't require immediate action:

osascript /path/to/skill/alerts/notify.scpt "Title" "Message body here"

The notification appears briefly and goes to Notification Center.

Modal (Dialog Box)

Use for alerts that require acknowledgement:

osascript /path/to/skill/alerts/dialog.scpt "Title" "Message body here"

This blocks until the user clicks OK. Use sparingly.

Modal with Sound

For urgent alerts:

osascript /path/to/skill/alerts/dialog.scpt "Title" "Message body here" "Ping"

Available sounds: Basso, Blow, Bottle, Frog, Funk, Glass, Hero, Morse, Ping, Pop, Purr, Sosumi, Submarine, Tink

Say (Text-to-Speech)

For hands-free alerts:

osascript /path/to/skill/alerts/say.scpt "Your meeting starts in 5 minutes"

Script Locations

All scripts are in the same directory as this SKILL.md:

• notify.scpt - Non-modal banner notification
• dialog.scpt - Modal dialog (blocks until dismissed)
• say.scpt - Text-to-speech

Guidelines

1. Prefer non-modal for most alerts - they're less disruptive
2. Use modal only when acknowledgement is required
3. Use say when Matt might not be looking at the screen
4. Combine methods for critical alerts (e.g., say + modal)

Examples

# Reminder about a meeting
osascript ~/.opencode/skill/alerts/notify.scpt "Calendar" "Team sync in 15 minutes"

# Task completed
osascript ~/.opencode/skill/alerts/notify.scpt "Build Complete" "All tests passed"

# Urgent - needs action
osascript ~/.opencode/skill/alerts/dialog.scpt "Action Required" "PR review requested by Sarah" "Ping"

# Hands-free reminder
osascript ~/.opencode/skill/alerts/say.scpt "Don't forget to submit the form before noon"