AgentSkillsCN

ntfy-notify

通过 ntfy.sh 发送推送通知。当用户要求接收通知、需要警报，或长时间运行的任务完成并需告知用户时，请使用此技能。

SKILL.md
--- frontmatter
name: ntfy-notify
description: Send push notifications via ntfy.sh. Use this skill when the user asks to be notified, wants an alert, or when a long-running task completes and the user should be informed.

ntfy.sh Notifications

Send push notifications to the user's device via ntfy.sh.

Configuration

  • •Topic: YOUR_TOPIC
  • •Endpoint: https://ntfy.sh/YOUR_TOPIC

How to Send Notifications

Use curl to send a notification:

bash
curl -d "Your message here" ntfy.sh/YOUR_TOPIC

With a Title

bash
curl -H "Title: Task Complete" -d "Your message here" ntfy.sh/YOUR_TOPIC

With Priority

Priority levels: min, low, default, high, urgent

bash
curl -H "Priority: high" -d "Your message here" ntfy.sh/YOUR_TOPIC

With Tags/Emojis

bash
curl -H "Tags: white_check_mark" -d "Build succeeded" ntfy.sh/YOUR_TOPIC

Click Actions (Deeplinks)

Make the notification clickable - tapping it opens a URL or deeplink.

bash
curl -H "Click: https://example.com" -d "Click to open" ntfy.sh/YOUR_TOPIC

Supports any URI scheme: https://, mailto:, app deeplinks, etc.

Action Buttons

Add up to 3 interactive buttons to notifications. Separate multiple actions with semicolons.

View Action (Open URL/App)

bash
curl \
  -H "Actions: view, Open Link, https://example.com" \
  -d "Check this out" ntfy.sh/YOUR_TOPIC

HTTP Action (Trigger API)

bash
curl \
  -H "Actions: http, Run Build, https://api.example.com/build, method=POST" \
  -d "Ready to deploy?" ntfy.sh/YOUR_TOPIC

Multiple Actions

bash
curl \
  -H "Actions: view, View Logs, https://logs.example.com; http, Retry, https://api.example.com/retry, method=POST" \
  -d "Build failed" ntfy.sh/YOUR_TOPIC

Action Format

code
<type>, <label>, <url>, [options]
  • •type: view or http
  • •label: Button text
  • •url: Target URL or deeplink
  • •options: method=POST, body={"key":"value"}, clear=true

Combined Example

bash
curl \
  -H "Title: Deploy Complete" \
  -H "Tags: rocket" \
  -H "Priority: high" \
  -H "Click: https://app.example.com" \
  -H "Actions: view, View Site, https://app.example.com; view, View Logs, https://logs.example.com" \
  -d "Production deployment finished successfully" \
  ntfy.sh/YOUR_TOPIC

When to Use

  • •After completing a long-running task (builds, tests, deployments)
  • •When an error occurs that needs attention
  • •When user explicitly asks to be notified
  • •When waiting for user input after completing work

Example Messages

  • •Task completion: "Build completed successfully"
  • •Error alert: "Build failed: 3 type errors found"
  • •Status update: "Deployment to staging complete"