webhook-subscriptions

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

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/CHENHUI-X/toolbox --skill webhook-subscriptions-chenhui-x
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: webhook-subscriptions
Source: https://github.com/CHENHUI-X/toolbox/tree/main/custom-skills/devops/webhook-subscriptions
Command: npx skills add https://github.com/CHENHUI-X/toolbox --skill webhook-subscriptions-chenhui-x

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? External services like GitHub, GitLab, Stripe, and CI/CD pipelines emit events that often require manual monitoring. This Skill lets you create dynamic webhook subscriptions so those services can POST events to a URL that automatically triggers Hermes agent runs, with optional delivery of results to Telegram, Discord, Slack, or GitHub comments. ## Core Features & Use Cases - Dynamic Subscription Management: Create, list, test, and remove webhook routes via the hermes webhook CLI, with per-route HMAC-SHA256 secrets and event filters. - Prompt Templates with Payload Interpolation: Use {dot.notation} placeholders to inject nested JSON payload fields (issue titles, PR authors, payment amounts) into agent prompts. - Direct Delivery Mode: Use --deliver-only to push rendered messages straight to a chat target with no LLM round trip, ideal for monitoring alerts and notifications. - Use Case: Subscribe to GitHub issues events so every new issue POST triggers an agent run that triages the issue and delivers the analysis to your Telegram chat. ## Quick Start Set up a webhook subscription named github-issues that triggers an agent run to triage new GitHub issues and delivers the result to my Telegram chat.

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 to trigger an agent from GitHub events?

Run `hermes webhook subscribe <name>` with `--events`, a `--prompt` template using `{dot.notation}` payload fields, and a `--deliver` target. Then add the returned webhook URL and secret in your GitHub repo Settings under Webhooks.

How do I send webhook notifications without an LLM agent run?

Add the `--deliver-only` flag to `hermes webhook subscribe` with a real `--deliver` target like telegram or discord. The rendered prompt template is dispatched directly as the message body, skipping the agent loop entirely.

Which signature header formats does the webhook adapter support?

The adapter validates four formats: Svix headers, GitHub's X-Hub-Signature-256 with sha256 prefix, GitLab's X-Gitlab-Token plaintext comparison, and a generic X-Webhook-Signature hex HMAC-SHA256. All HMACs use SHA-256 over the raw request body.

Why does my webhook test return status ignored?

The test command sends the hardcoded event type `test`, so routes filtered to other events ignore it. Pass a matching payload with `hermes webhook test <name> --payload '{"event_type": "task"}'` or broaden the route's `--events` filter.

Why is my webhook unreachable from external services?

The server binds to 0.0.0.0 but may be blocked by local firewalls (ufw/iptables) and cloud provider firewall rules. For local development, tunnel the port with ngrok or cloudflared instead of opening firewall rules.