webhook-subscriptions

Create dynamic webhook routes that trigger Hermes agent runs from POST payloads.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Hermes needs a reliable way to let external services trigger automated agent runs based on incoming events, without manually starting conversations.

Core Features & Use Cases

  • Event-driven webhook subscriptions: Create routes that accept POSTed event payloads from systems like GitHub, GitLab, Stripe, CI/CD, IoT sensors, and monitoring tools.
  • Prompt templating from payloads: Render agent prompts using {dot.notation} fields so the event data becomes the task input.
  • Configurable delivery targets: Route the agent’s response to chat or platform adapters (e.g., Telegram, Discord, GitHub comments), including a low-cost --deliver-only mode for direct notifications.
  • Security controls: Use per-subscription HMAC-SHA256 secrets with signature validation, plus persisted subscription state for durable routing.

Quick Start

Run the webhook subscription manager by enabling the webhook platform and then creating a subscription that posts events into Hermes using hermes webhook subscribe alerts --events "alert" --prompt "Alert: {alert.name}\nSeverity: {alert.severity}\nMessage: {alert.message}\n\nPlease investigate and suggest remediation." --deliver telegram --deliver-chat-id "12345".

Frequently Asked Questions about webhook-subscriptions

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

FAQPage Schema
How do I trigger automated agent runs from external webhook events?▼

To trigger automated agent runs from external webhook events, you can create dynamic webhook subscription routes that accept POST event payloads from external services and automatically initiate Hermes agent processing.

Can I use GitHub or Stripe webhook payloads to generate agent prompts?▼

Yes, you can use GitHub, Stripe, or other webhook payloads to generate agent prompts by rendering event data fields using `{dot.notation}` prompt templating within the subscription configuration.

How do I secure webhook subscriptions for event-driven automation?▼

To secure webhook subscriptions for event-driven automation, configure per-subscription HMAC-SHA256 secrets to validate incoming POST request signatures and ensure authenticated delivery.

What platforms and delivery targets are supported for webhook event notifications?▼

Supported delivery targets for webhook event notifications include chat or platform adapters like Telegram, Discord, and GitHub comments, plus a `--deliver-only` mode for direct low-cost notifications.

Does webhook subscription route configuration persist across incoming requests?▼

Yes, webhook subscription route configuration persists across incoming requests because the system maintains persistent subscription state, ensuring durable routing and automatic configuration reload.