Agent skill

slack-notifier

Slackチャンネルにフォーマット済みメッセージを送信するSkill。 「Slackに通知して」「チームに連絡して」「#channelに投稿して」 などのリクエストで自動発火する。 MCP連携（フルAPI）とWebhookフォールバック（送信のみ）の両方に対応。

View SKILL.md on GitHub Repository
Stars 7
Forks 1

Install this agent skill to your Project

npx add-skill https://github.com/knishioka/machine-learning-workshop/tree/main/claude-skills/slack-notifier

SKILL.md

Slack通知 Skill

Slackチャンネルにフォーマット済みメッセージを送信します。 MCP連携とWebhookフォールバックの2つのモードをサポート。

連携モード

モード1: Slack MCP（推奨）

MCP経由でフルSlack APIアクセス。MCP設定が必要。

利用可能な場合: mcp__slack__* ツールが設定されている 機能: メッセージ送信、チャンネル一覧、スレッド返信、リアクション追加

MCPツール一覧:

  • mcp__slack__slack_list_channels - ワークスペースのチャンネル一覧
  • mcp__slack__slack_post_message - メッセージ投稿
  • mcp__slack__slack_reply_to_thread - スレッド返信
  • mcp__slack__slack_add_reaction - リアクション追加

モード2: Webhook フォールバック

Incoming Webhook経由のシンプルなHTTP POST。MCP不要。

利用可能な場合: SLACK_WEBHOOK_URL 環境変数が設定されている 機能: メッセージ送信のみ（読み取り、リアクションは不可）

クイックスタート

連携モードの確認

送信前に、利用可能な連携方法を確認:

  1. MCPを試行: mcp__slack__slack_list_channels
  2. 利用不可の場合、SLACK_WEBHOOK_URL 環境変数を確認
  3. 利用可能なモードをユーザーに報告

シンプルなメッセージ送信

MCPモード:

mcp__slack__slack_post_message を使用:
  channel: "#channel-name"
  text: "メッセージ内容"

Webhookモード:

bash
python3 scripts/send_webhook.py --message "メッセージ内容"

メッセージフォーマット

1. シンプルテキスト

プレーンテキスト通知。クイックな更新に。

2. フォーマット済み（mrkdwn）

Slackのmarkdown形式。サポート:

  • *太字* で強調
  • _斜体_ で控えめに
  • `コード` でインラインコード
  • コードブロック で複数行コード
  • <url|テキスト> でリンク

3. 構造化（Blocks）

セクション、ヘッダー、区切り線を使ったリッチレイアウト。 resources/message-templates.md にテンプレートあり。

テンプレート

resources/message-templates.md で利用可能:

アラートテンプレート

  • success: 緑チェックマーク、成功通知
  • warning: 黄色警告、注意喚起
  • error: 赤バツ、失敗通知
  • info: 青情報マーク、お知らせ

レポートテンプレート

  • build-report: ビルドステータスとメトリクス
  • deploy-report: デプロイサマリー
  • test-report: テスト結果サマリー

使用例

例1: シンプル通知

ユーザー: 「#dev-teamにビルド完了を通知して」

アクション: MCPまたはWebhookで送信:
"ビルドが完了しました！レビューお願いします。"

例2: エラーアラート

ユーザー: 「#ops-channelにDB接続エラーをアラートして」

アクション: errorテンプレートを使用:
" **アラート: データベース接続失敗**
時刻: 2025-11-27 10:30 UTC
詳細: 30秒後に接続タイムアウト
対応: データベースサーバーの状態を確認してください"

セキュリティ注意事項

重要: 認証情報の取り扱い

  1. Webhook URLをSKILL.mdやスクリプトに直接書かない
  2. 環境変数を使用: SLACK_WEBHOOK_URL
  3. MCPトークンはClaude MCP設定で管理
  4. URLの検証を送信前に行う（スクリプトで自動実行）

セットアップ要件

MCPモード用

  1. Bot TokenでSlackアプリを作成
  2. Claude設定でMCPサーバーを構成
  3. 必要なスコープ: channels:read, chat:write, reactions:write

Webhookモード用

  1. Slack Incoming Webhookを作成
  2. 環境変数を設定: export SLACK_WEBHOOK_URL="https://hooks.slack.com/..."
  3. 追加設定は不要

詳細は resources/setup-guide.md を参照。

スクリプトインターフェース

bash
# シンプルメッセージ
python scripts/send_webhook.py --message "Hello!"

# テンプレート使用
python scripts/send_webhook.py --message "ビルド失敗" --template error --title "CIアラート"

# カスタムJSON
python scripts/send_webhook.py --json '{"text": "カスタムメッセージ"}'

エラーハンドリング

エラー 原因 対処
"Slack連携なし" MCPもWebhookも未設定 セットアップガイド参照
"チャンネルが見つかりません" 無効なチャンネル名（MCP） チャンネル存在を確認
"Webhook失敗" 無効なURLまたはネットワーク SLACK_WEBHOOK_URLを確認
"レート制限" メッセージ送信過多 待機してリトライ

制限事項

  • Webhookモード: 送信のみ、チャンネル一覧やメッセージ読み取り不可
  • WebhookでのDM不可: Webhookは特定チャンネル専用
  • メッセージ長: 1メッセージ最大40,000文字
  • レート制限: Slackは約1メッセージ/秒に制限

テスト実行

bash
cd /path/to/slack-notifier
python -m pytest scripts/test_send_webhook.py -v

注意: テストはモック化されており、実際のSlack送信は行いません。

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

knishioka/machine-learning-workshop

meeting-actions

会議メモからアクションアイテムを抽出するSkill。 「アクションを抽出して」「TODOをまとめて」「会議のアクションは？」 などのリクエストで自動発火する。

7 1
Explore
knishioka/machine-learning-workshop

daily-report-generator

GitコミットログとCalendar情報から日報・週報を自動生成するSkill。 「日報を作って」「週報を書いて」「今週何やったか教えて」「スタンドアップノート」 などのリクエストで自動発火する。

7 1
Explore
knishioka/machine-learning-workshop

markdown-to-slides

MarkdownファイルをPowerPointプレゼンテーション（PPTX）に変換するSkill。 「Markdownをスライドに変換して」「プレゼン資料を作って」「PPTXを生成して」 などのリクエストで自動発火する。python-pptxライブラリを使用。

7 1
Explore
mattpocock/skills

handoff

Compact the current conversation into a handoff document for another agent to pick up.

111,310 9,758
Explore
mattpocock/skills

setup-pre-commit

Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.

111,310 9,758
Explore
mattpocock/skills

obsidian-vault

Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.

111,310 9,758
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results