webhook-subscriptions

Create webhook subscriptions that trigger agent runs from external service events.

Updated Jun 30, 2026
One-click install
npx skills add https://github.com/zhoulingxiao1216/testworkspace --skill webhook-subscriptions-zhoulingxiao1216
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: webhook-subscriptions
Source: https://github.com/zhoulingxiao1216/testworkspace/tree/main/all_Skills/devops/webhook-subscriptions
Command: npx skills add https://github.com/zhoulingxiao1216/testworkspace --skill webhook-subscriptions-zhoulingxiao1216

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? External services like GitHub, Stripe, and CI/CD pipelines emit events that normally require manual checking; this Skill lets those events automatically trigger Hermes agent runs via HTTP POSTs to a webhook URL. ## Core Features & Use Cases - Dynamic Subscriptions: Create, list, test, and remove webhook subscriptions with the hermes webhook CLI, each protected by an HMAC-SHA256 secret. - Prompt Templating: Use {dot.notation} placeholders to inject nested payload fields (issue titles, PR authors, payment amounts) into agent prompts. - Direct Delivery Mode: Use --deliver-only to push rendered messages straight to Telegram, Discord, Slack, or GitHub comments without an LLM round trip. - Use Case: Subscribe to GitHub issues events so every new issue is triaged by an agent and the result is delivered to a Telegram chat. ## Quick Start Enable the webhook platform with hermes gateway setup, then ask the agent to create a webhook subscription for GitHub issue events that delivers triage results to Telegram.

Frequently Asked Questions about webhook-subscriptions

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

FAQPage Schema
How do I create a webhook subscription that triggers an agent run?▼

Run `hermes webhook subscribe <name>` with a `--prompt` template, optional `--events` filter, and a `--deliver` target. The command returns a webhook URL and HMAC secret that you configure in the external service's webhook settings.

How do I set up the webhook platform in Hermes?▼

Run `hermes gateway setup` and follow the prompts, or manually add a `platforms.webhook` section with host, port, and secret to `~/.hermes/config.yaml`. Then start the gateway with `hermes gateway run` and verify with `curl http://localhost:8644/health`.

Can I send webhook notifications without running an LLM agent?▼

Yes, add `--deliver-only` to the subscribe command. The rendered prompt template is dispatched directly to the delivery target such as Telegram or Discord, returning 200 on success and 502 on failure, with no LLM cost.

How do I reference payload fields in a webhook prompt template?▼

Use dot-notation placeholders like `{issue.title}` or `{pull_request.user.login}` inside the `--prompt` string. If no prompt is specified, the full JSON payload is dumped into the agent prompt.

Why is my webhook subscription not receiving events?▼

Check that the gateway is running, the health endpoint returns ok, and the secret in your service matches the one from `hermes webhook list`. Also verify the `--events` filter matches what the service sends and that the URL is reachable, using a tunnel like ngrok for local development.

How are webhook subscriptions secured?▼

Each subscription gets an auto-generated HMAC-SHA256 secret, or you can supply your own with `--secret`. The adapter validates signatures on every incoming POST, and static config routes cannot be overwritten by dynamic subscriptions.