poke-assistant

Send messages and notifications to Poke via its inbound webhook API.

1|Updated May 6, 2026
One-click install
npx skills add https://github.com/surfingalien/FinSurfing --skill poke-assistant-surfingalien
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: poke-assistant
Source: https://github.com/surfingalien/FinSurfing/tree/main/.claude/skills/poke-assistant
Command: npx skills add https://github.com/surfingalien/FinSurfing --skill poke-assistant-surfingalien

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Long-running builds, tests, and deployments leave you waiting without visibility into completion or failure. This Skill lets Claude push alerts, status updates, and reminders directly to your Poke assistant over iMessage, SMS, or WhatsApp. ## Core Features & Use Cases - Webhook Messaging: Send text messages to Poke through its inbound webhook API using a Bearer-token authenticated POST request. - Flexible Input: Pass messages via the -m flag or pipe command output through stdin. - Use Case: Run a long test suite and automatically get a Poke notification on your phone when it finishes, including pass/fail counts or error details. ## Quick Start Set the POKE_API_KEY environment variable, then ask Claude to send a message to your Poke assistant when the current task completes.

Frequently Asked Questions about poke-assistant

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send a message to Poke from the command line?

Run python scripts/send_message.py with the -m flag followed by your message text, or pipe content via stdin. The script posts the message to the Poke inbound webhook using your POKE_API_KEY for authentication.

How do I get a Poke API key for webhook notifications?

Go to poke.com/settings, open the Advanced section, and generate or copy your API key. Then set it as the POKE_API_KEY environment variable, for example by adding an export line to your shell profile.

Can I pipe command output to Poke notifications?

Yes, the script reads from stdin when no -m flag is provided, so you can pipe output like git logs or test results directly. If both stdin and -m are present, the -m message takes precedence.

Why does the Poke webhook return a 401 Unauthorized error?

A 401 response means your API key is invalid or expired. Generate a new key at poke.com/settings in the Advanced section and update your POKE_API_KEY environment variable.

What happens when Poke API rate limits are hit?

The API returns a 429 Too Many Requests error and the script exits with code 2. Wait a few minutes before sending additional messages, and avoid sending notifications for every small step to prevent rate limiting.