webhook-subscriptions

Create webhook routes that trigger Hermes agent runs from POSTed payloads.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/MarbleSodas/Mavis --skill webhook-subscriptions-marblesodas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: webhook-subscriptions
Source: https://github.com/MarbleSodas/Mavis/tree/main/skills/devops/webhook-subscriptions
Command: npx skills add https://github.com/MarbleSodas/Mavis --skill webhook-subscriptions-marblesodas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of manually coordinating agent actions when external systems generate events, by turning incoming webhook events into automated Hermes agent runs.

Core Features & Use Cases

  • Dynamic webhook subscriptions: Create named routes that accept POSTed events and map them to an agent prompt.
  • Event-to-prompt templating: Use payload dot-notation to render prompts from nested JSON fields.
  • Flexible delivery targets: Deliver agent results to chat adapters (or forward messages directly with deliver-only to avoid LLM cost).
  • HMAC security & persistence: Automatically generate and validate HMAC-SHA256 secrets and persist subscriptions locally.

Quick Start

Enable the webhook platform in your Hermes gateway, then ask an AI assistant to create a webhook subscription that listens for your provider’s event type and forwards matching events into a Hermes agent run with a payload-templated prompt.

Frequently Asked Questions about webhook-subscriptions

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

FAQPage Schema
How do I trigger an agent run from an external webhook?

To trigger an agent run from an external webhook, create event-driven routes that accept POSTed payloads and map them to a Hermes agent prompt. This automates reactions to specific event types from external systems.

How do I set up automated event routing for GitHub or Stripe notifications?

Automated event routing for GitHub or Stripe notifications is set up by creating named webhook subscriptions that listen for your provider's event type and forward matching events into an agent run.

Can I use payload fields to dynamically generate agent prompts?

Yes, you can dynamically generate agent prompts using event-to-prompt templating. This feature renders prompts by extracting values from nested JSON fields using payload dot-notation.

Do I need to configure HMAC signature validation for webhook subscriptions?

HMAC-SHA256 signature validation is required for webhook subscriptions to ensure security. The system automatically generates and validates HMAC secrets while persisting subscriptions locally.

Can I forward webhook events directly to chat without incurring LLM costs?

You can forward webhook events directly to chat without incurring LLM costs by using the deliver-only feature. This bypasses the agent run and sends messages directly to configured chat adapters.

What is the best way to manage webhook subscriptions via CLI?

The best way to manage webhook subscriptions is via the hermes webhook CLI. This requires enabling the webhook platform in your Hermes gateway first to handle subscription creation and persistence.