custom-skills-notify
發送通知到 Telegram 或 Discord。支援手動發送、初始化設定、測試連線。長時間任務時搭配 plugin hooks 自動通知。
How do I install this agent skill?
npx skills add https://github.com/valorvie/ai-dev-skills --skill custom-skills-notifyIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides a notification system for Claude Code that sends messages to Telegram or Discord based on event hooks or manual commands. It securely manages user-provided tokens in a local configuration file and does not exhibit malicious patterns.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
custom-notify — Claude Code 通知系統
透過 Telegram 或 Discord 接收 Claude Code 的重要事件通知。
指令
/notify init — 初始化設定
引導使用者建立通知設定檔。詢問使用者要啟用哪些頻道(可多選)。
Telegram 設定步驟:
- 請使用者提供 Telegram Bot Token(從 @BotFather 取得)
- 請使用者提供 Chat ID(可用 @userinfobot 取得)
Discord 設定步驟:
- 請使用者提供 Discord Webhook URL(從 Discord 頻道設定 → 整合 → Webhook 取得)
設定檔範例 ~/.config/claude-notify/config.json:
{
"channels": {
"telegram": {
"enabled": true,
"bot_token": "<使用者提供的 token>",
"chat_id": "<使用者提供的 chat_id>"
},
"discord": {
"enabled": true,
"webhook_url": "<使用者提供的 webhook URL>"
}
},
"events": {
"task_complete": true,
"task_failed": true,
"needs_input": true,
"tool_rejected": true
}
}
建立完成後,自動執行 /notify test 驗證連線。
注意:
- 確保目錄存在:
mkdir -p ~/.config/claude-notify - 如果使用者只要其中一個頻道,另一個設
"enabled": false或不寫即可 - 如果已有設定檔,詢問是否要新增頻道或覆蓋
/notify test — 測試連線
執行以下命令發送測試訊息:
node "<skill_path>/scripts/notify.js" --test
- 成功:告知使用者「測試訊息已發送,請檢查通知頻道」
- 失敗:顯示錯誤訊息並協助排查
/notify <訊息> — 手動發送通知
當使用者輸入 /notify 後面接任何文字時,發送該文字作為通知:
node "<skill_path>/scripts/notify.js" --manual --message "<使用者的訊息>"
範例:
/notify 部署完成,請來檢查/notify 測試全部通過
/notify config — 查看目前設定
讀取並顯示 ~/.config/claude-notify/config.json 的內容(隱藏 bot_token 和 webhook_url 的中間部分)。
/notify toggle <event> — 開關事件通知
修改 ~/.config/claude-notify/config.json 中的 events 設定。
可用的 event 名稱:
task_complete— 任務完成通知task_failed— 工具執行失敗通知needs_input— 需要使用者決策通知tool_rejected— 工具被拒絕通知
範例: /notify toggle task_complete — 切換任務完成通知的開關狀態
自動通知
npx skills 只安裝本 skill,不會安裝 Claude Code plugin。自動通知由
custom-skills-notify plugin
處理,監聽以下 Claude Code hook 事件:
| 事件 | 觸發時機 |
|---|---|
Notification | 需要權限、閒置提示、需要回答問題 |
Stop | Claude 完成回應 |
PostToolUseFailure | 工具執行失敗 |
需要自動通知時,另外執行:
claude plugin marketplace add https://github.com/ValorVie/custom-skills.git
claude plugin install custom-skills-notify@custom-skills
這個 plugin 安裝是獨立操作,不屬於 npx skills add 的結果。
腳本路徑
通知腳本位於:<skill_path>/scripts/notify.js
使用 <skill_path> 代表此 skill 的根目錄路徑。在執行命令時,用實際的絕對路徑替換。
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/valorvie/ai-dev-skills/custom-skills-notify">View custom-skills-notify on skillZs</a>