webhook-subscriptions

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

14|5|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill webhook-subscriptions-mlt-oss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: webhook-subscriptions
Source: https://github.com/MLT-OSS/hermes-agent-go/tree/main/skills/devops/webhook-subscriptions
Command: npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill webhook-subscriptions-mlt-oss

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? External services like GitHub, Stripe, and CI/CD pipelines emit events that often require manual monitoring and response. This Skill lets you create webhook subscriptions so those services can automatically trigger Hermes agent runs by POSTing events to a URL, with responses delivered to Telegram, Discord, or other targets. ## Core Features & Use Cases - Dynamic Subscription Management: Create, list, test, and remove webhook subscriptions via the hermes webhook CLI, with HMAC-SHA256 signature validation on every incoming POST. - Prompt Templating: Use {dot.notation} placeholders to inject nested payload fields (issue titles, PR authors, payment amounts) into agent prompts. - Multi-Platform Delivery: Route agent responses to Telegram, Discord, GitHub comments, or the origin channel. - Use Case: Subscribe to GitHub issue events so every new issue automatically triggers an agent run that triages it and posts the result to your Telegram chat. ## Quick Start Set up a webhook subscription that triggers an agent run whenever a new GitHub issue is opened and delivers the triage 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 placeholders like {issue.title}, and a delivery target. Then add the returned webhook URL and secret in your GitHub repo's Settings under Webhooks.

How do I enable the webhook platform in Hermes?

Run `hermes gateway setup` and follow the prompts, or manually add a webhook section with enabled, port, and secret to ~/.hermes/config.yaml. You can also set WEBHOOK_ENABLED, WEBHOOK_PORT, and WEBHOOK_SECRET environment variables, then start the gateway.

Can I use webhook subscriptions with Stripe or CI/CD pipelines?

Yes, any service that can POST JSON to a URL works, including Stripe payment events, GitLab pipelines, and monitoring tools. Use dot-notation placeholders like {data.object.amount} to reference nested payload fields in the prompt template.

How are webhook requests secured against unauthorized triggers?

Each subscription gets an auto-generated HMAC-SHA256 secret, and the adapter validates signatures on every incoming POST. GitHub sends X-Hub-Signature-256 and GitLab sends X-Gitlab-Token, which are checked against the stored secret.

Why is my webhook subscription not triggering the agent?

Check that the gateway is running, the health endpoint at /health returns ok, and the --events filter matches what the service sends. Verify the secret matches and use `hermes webhook test <name>` to confirm the route works.