AGENT SKILL

poke-assistant

Send messages and notifications to Poke (poke.com) via webhook API. Use when alerting the user, sending task completion notifications, status updates, reminders, or any message to their Poke assistant.

License 许可
MIT
最近更新
2026-11-14
Stars
★ 1
Forks
0

01 前言 Front Matter

name
poke-assistant
description
Send messages and notifications to Poke (poke.com) via webhook API. Use when alerting the user, sending task completion notifications, status updates, reminders, or any message to their Poke assistant.

02 资源文件 1

03 SKILL.md 正文

Poke Assistant

Overview

Send messages to your Poke assistant via the inbound webhook API. Poke is a conversational AI assistant that supports iMessage, SMS, and WhatsApp messaging. This skill enables Claude to send you notifications, alerts, and updates directly to your Poke.

When to Use

  • Notifying the user when a long-running task completes
  • Sending error alerts or warnings that need attention
  • Providing status updates on build, test, or deployment progress
  • Sending reminders or summaries
  • Alerting about important events (CI failures, security issues, etc.)

Prerequisites

  • Poke account at poke.com
  • POKE_API_KEY environment variable

Installation

Getting Your API Key

  1. Go to poke.com/settings
  2. Navigate to the Advanced section
  3. Generate or copy your API key
  4. Add to your shell profile:
echo 'export POKE_API_KEY="your-api-key"' >> ~/.zshrc
source ~/.zshrc

Quick Start

Send a simple message:

python scripts/send_message.py -m "Hello from Claude Code!"

Pipe content to Poke:

echo "Build completed successfully" | python scripts/send_message.py

Command Reference

python scripts/send_message.py [options]

Options:
  -m, --message TEXT    Message to send to Poke
  -v, --verbose         Show detailed output
  -h, --help            Show help message

Input:
  Message can be provided via -m flag or piped to stdin.
  If both are provided, -m takes precedence.

Exit codes:
  0  Success
  1  Missing message or API key
  2  API error (authentication, rate limit, etc.)
  3  Network error

Examples

Task Completion Alert

python scripts/send_message.py -m "Build completed: 42 tests passed, 0 failed"

Error Notification

python scripts/send_message.py -m "ERROR: Deployment to production failed. Check logs."

Pipe Command Output

git log --oneline -5 | python scripts/send_message.py -m "Recent commits:
$(cat)"

Status Update with Details

python scripts/send_message.py -m "Code review complete:
- 3 files changed
- 2 suggestions made
- Ready for merge"

Alert on Test Failure

npm test || python scripts/send_message.py -m "Tests failed! Check the output."

Workflow Integration

Notify After Long Tasks

When running tasks that take time, notify on completion:

# Run build and notify
npm run build && python scripts/send_message.py -m "Build finished successfully" \
  || python scripts/send_message.py -m "Build failed!"

Daily Summary

Send a summary of work done:

python scripts/send_message.py -m "Daily summary:
- Implemented user auth
- Fixed 3 bugs
- Updated documentation"

Best Practices

When to Send Notifications

  • Tasks taking longer than 2-3 minutes
  • Errors requiring user attention
  • Important milestones (deployment, release)
  • Security-related alerts

When NOT to Send

  • Routine operations that complete quickly
  • Every small step (avoid notification fatigue)
  • Sensitive information (credentials, tokens)

Message Guidelines

  • Keep messages concise but informative
  • Include actionable context (what happened, what to do)
  • Use clear formatting for multi-line messages

Troubleshooting

"POKE_API_KEY environment variable not set"

Set your API key:

export POKE_API_KEY="your-api-key"

Or add to ~/.zshrc for persistence.

"API returned 401: Unauthorized"

Your API key is invalid or expired. Generate a new one at poke.com/settings.

"API returned 429: Too Many Requests"

You're being rate limited. Wait a few minutes before sending more messages.

"Network error: Connection refused"

Check your internet connection. The Poke API requires network access.

Message not appearing in Poke

  • Verify your API key is correct
  • Check that messaging is enabled in your Poke settings
  • Ensure your messaging channel (iMessage/SMS/WhatsApp) is configured

04 同仓库更多 Skills

surfingalien
surfingalien/FinSurfing

portfolio-management

暂无简介

★ 1
surfingalien
surfingalien/FinSurfing

financial-analysis

暂无简介

★ 1
surfingalien
surfingalien/FinSurfing

tradingview-mcp

AI Trading Intelligence — live prices, 30+ technical indicators, backtesting (6 strategies), walk-forward overfitting detection, trade logs, equity curves, Reddit sentiment, news, and multi-market screener. Supports stocks, crypto, ETFs, indices, Turkish (BIST), and Egyptian (EGX) markets.

★ 1
surfingalien
surfingalien/FinSurfing

sales-engineer

Analyzes RFP/RFI responses for coverage gaps, builds competitive feature comparison matrices, and plans proof-of-concept (POC) engagements for pre-sales engineering. Use when responding to RFPs, bids, or proposal requests; comparing product features against competitors; planning or scoring a customer POC or sales demo; preparing a technical proposal; or performing win/loss competitor analysis. Handles tasks described as 'RFP response', 'bid response', 'proposal response', 'competitor comparison', 'feature matrix', 'POC planning', 'sales demo prep', or 'pre-sales engineering'.

★ 1
surfingalien
surfingalien/FinSurfing

revenue-operations

Analyzes sales pipeline health, revenue forecasting accuracy, and go-to-market efficiency metrics for SaaS revenue optimization. Use when analyzing sales pipeline coverage, forecasting revenue, evaluating go-to-market performance, reviewing sales metrics, assessing pipeline analysis, tracking forecast accuracy with MAPE, calculating GTM efficiency, or measuring sales efficiency and unit economics for SaaS teams.

★ 1
surfingalien
surfingalien/FinSurfing

customer-success-manager

Monitors customer health, predicts churn risk, and identifies expansion opportunities using weighted scoring models for SaaS customer success. Use when analyzing customer accounts, reviewing retention metrics, scoring at-risk customers, or when the user mentions churn, customer health scores, upsell opportunities, expansion revenue, retention analysis, or customer analytics. Runs three Python CLI tools to produce deterministic health scores, churn risk tiers, and prioritized expansion recommendations across Enterprise, Mid-Market, and SMB segments.

★ 1