notify
Send notifications via ntfy.sh to alert about completed tasks, errors, or important events
When & Why to Use This Skill
The Notify skill for Claude provides a seamless integration with ntfy.sh, enabling automated real-time push notifications for developers and power users. It solves the challenge of monitoring background processes by delivering instant alerts for task completions, system errors, and critical events directly to your devices, ensuring you stay informed without needing to manually poll for status updates.
Use Cases
- Long-Running Task Alerts: Receive an instant notification on your phone or desktop when a time-consuming data processing job or software build is finished.
- Error and Incident Reporting: Get immediate alerts when a script fails or a CI/CD pipeline encounters an error, allowing for faster debugging and incident response.
- Workflow Milestone Tracking: Automatically ping the user when a multi-step agentic workflow reaches a specific milestone or requires manual intervention.
- System Monitoring: Send periodic status updates or 'heartbeat' notifications from automated scripts to ensure remote systems are operating correctly.
| name | notify |
|---|---|
| description | Send notifications via ntfy.sh to alert about completed tasks, errors, or important events |
Notify Skill
Send notifications via ntfy.sh to alert the user about completed tasks, errors, or any important events.
Usage
Use this skill when:
- A long-running task has completed
- An error or issue needs attention
- The user explicitly asks to be notified
- Any event that warrants alerting the user
How to Send Notifications
Execute the following command with an appropriate message using fish shell:
fish -c 'curl -d "<MESSAGE>" "ntfy.sh/$NTFY_SUB_TOPIC"'
Replace <MESSAGE> with a concise, descriptive message about the event.
Note: $NTFY_SUB_TOPIC is a private fish shell variable, so the command must be run via fish -c.
Message Guidelines
- Keep messages short and actionable (under 100 characters when possible)
- Include relevant context (e.g., task name, file, error type)
- Use clear language
Example Messages
- "Build completed successfully"
- "Tests passed: 42/42"
- "Error: TypeScript compilation failed in src/index.ts"
- "PR #123 is ready for review"
- "Task complete: Database migration finished"