webhook-subscriptions

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

Updated May 4, 2026
One-click install
npx skills add https://github.com/Junkfooooood/hermes-governance --skill webhook-subscriptions-junkfooooood
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: webhook-subscriptions
Source: https://github.com/Junkfooooood/hermes-governance/tree/main/skills/devops/webhook-subscriptions
Command: npx skills add https://github.com/Junkfooooood/hermes-governance --skill webhook-subscriptions-junkfooooood

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? External services like GitHub, Stripe, and CI/CD pipelines emit events that normally require manual checking or custom glue code to act on. This Skill lets you create dynamic webhook subscriptions so those services can trigger Hermes agent runs automatically by POSTing events to a URL. ## Core Features & Use Cases - Dynamic Subscriptions: Create, list, test, and remove webhook subscriptions via the hermes webhook CLI, with auto-generated HMAC-SHA256 secrets for signature validation. - Prompt Templates: Use {dot.notation} placeholders to inject nested payload fields (issue titles, PR authors, payment amounts) into agent prompts. - Flexible Delivery: Route agent responses to Telegram, Discord, Slack, or GitHub comments, or use --deliver-only to push notifications directly with zero LLM cost. - Use Case: Subscribe to GitHub issues events so every new issue is triaged by an agent and the result is delivered to your Telegram chat. ## Quick Start Set up a webhook subscription named github-issues that triggers an agent 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` with a name, an `--events` filter like "issues", a `--prompt` template using fields like {issue.title}, and a `--deliver` target. Then add the returned webhook URL and secret in your GitHub repo's webhook settings.

How do I enable the webhook platform in Hermes?

Run `hermes gateway setup` and follow the prompts, or manually set `platforms.webhook.enabled: true` with a port and secret in ~/.hermes/config.yaml. Alternatively set WEBHOOK_ENABLED, WEBHOOK_PORT, and WEBHOOK_SECRET in ~/.hermes/.env, then restart the gateway.

Can I send webhook notifications without running an LLM agent?

Yes, add `--deliver-only` to the subscribe command. The rendered prompt template is sent directly to the delivery target such as Telegram or Discord with no agent loop, and the POST returns 200 on success or 502 on delivery failure.

How are webhook requests authenticated and secured?

Each subscription gets an auto-generated HMAC-SHA256 secret, or you can supply your own with `--secret`. The webhook adapter validates the signature on every incoming POST, and subscriptions persist to ~/.hermes/webhook_subscriptions.json.

Why is my webhook subscription not triggering the agent?

Check that the gateway is running, `curl http://localhost:8644/health` returns ok, and the `--events` filter matches what the service sends. Also verify the secret matches and that the URL is reachable from the external service, using a tunnel like ngrok for local development.