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.