alerts
Send alerts and notifications using AppleScript - banners, modals, and text-to-speech
When & Why to Use This Skill
The Alerts Claude skill leverages AppleScript to provide a robust notification system for macOS users. It enables AI agents to communicate effectively with users through non-intrusive banners, urgent modal dialogs, and hands-free text-to-speech alerts, ensuring critical updates and task completions are never missed.
Use Cases
- Task Completion Alerts: Automatically notify the user via a banner when a long-running background process, such as a code build or data scraping task, has finished.
- Urgent Action Required: Use modal dialog boxes with sound effects to interrupt the user for critical issues that require immediate manual intervention or approval.
- Hands-free Status Updates: Utilize the text-to-speech feature to announce progress or reminders when the user is away from their screen or multitasking.
- Workflow Monitoring: Send periodic non-modal notifications to keep the user informed of the status of complex, multi-step agentic workflows without disrupting their focus.
| 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
# 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"