webhook-subscriptions

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

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill webhook-subscriptions-avatar-arts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: webhook-subscriptions
Source: https://github.com/AvaTar-ArTs/.Agent-skills/tree/main/skills/devops/webhook-subscriptions
Command: npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill webhook-subscriptions-avatar-arts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? External services like GitHub, Stripe, and CI/CD pipelines emit events that require manual monitoring; this Skill lets those services trigger automated agent runs by POSTing events to a webhook URL. ## Core Features & Use Cases - Dynamic Subscriptions: Create, list, test, and remove webhook subscriptions via the hermes webhook CLI with HMAC-SHA256 signature validation. - Prompt Templating: Render agent prompts from incoming payloads using dot-notation fields like {issue.title} or {data.object.amount}. - Multi-Target Delivery: Route agent responses to Telegram, Discord, Slack, or GitHub comments, with a --deliver-only mode for zero-LLM-cost direct notifications. - 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 Set up a webhook subscription 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 before creating subscriptions?

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 start the gateway.

Can webhook events be delivered 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, returning 200 on success or 502 on delivery failure.

Why is my webhook subscription not triggering on incoming events?

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 HMAC secret matches and the URL is reachable, using a tunnel like ngrok for local development.

How are webhook payloads secured against unauthorized requests?

Each subscription gets an auto-generated HMAC-SHA256 secret, or you can supply your own with `--secret`. The adapter validates signatures on every POST, supporting GitHub's X-Hub-Signature-256 and GitLab's X-Gitlab-Token headers.