| 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 notificationdialog.scpt - Modal dialog (blocks until dismissed)say.scpt - Text-to-speech
Guidelines
- Prefer non-modal for most alerts - they're less disruptive
- Use modal only when acknowledgement is required
- Use say when Matt might not be looking at the screen
- Combine methods for critical alerts (e.g., say + modal)
Examples
osascript ~/.opencode/skill/alerts/notify.scpt "Calendar" "Team sync in 15 minutes"
osascript ~/.opencode/skill/alerts/notify.scpt "Build Complete" "All tests passed"
osascript ~/.opencode/skill/alerts/dialog.scpt "Action Required" "PR review requested by Sarah" "Ping"
osascript ~/.opencode/skill/alerts/say.scpt "Don't forget to submit the form before noon"
