webhook-subscriptions

Create dynamic webhook endpoints that trigger Gengar agent runs from POST requests.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

Webhook subscriptions eliminate the manual effort of monitoring external systems and manually starting agent runs by letting event payloads directly trigger automation.

Core Features & Use Cases

  • Dynamic webhook routes: Create subscriptions that map incoming events to a configured prompt template and delivery target.
  • Event-driven agent execution: Use event filters and payload field placeholders (dot-notation) to tailor the run to each request.
  • Secure delivery and reliability: Use HMAC-SHA256 signatures, support idempotent behavior via routing/state persistence, and include operational testing and troubleshooting steps.
  • Practical integrations: Trigger from GitHub/GitLab CI events, Stripe payment status changes, monitoring/alert systems, IoT sensors, and other HTTP event sources.

Quick Start

Use webhook-subscriptions to create a Telegram-triggered automation by running the command: gengar 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 "123456789".

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 automatically from a webhook?

Webhook subscriptions trigger agent runs automatically by creating dynamic endpoints that receive external event POST requests and convert the payload into a tailored prompt dispatched to a configured delivery target like Telegram.

Can I use HMAC signature validation to secure incoming webhooks from GitHub or Stripe?

Yes, webhook subscriptions secure incoming webhooks from GitHub, Stripe, or other sources by validating HMAC-SHA256 signatures to ensure that only authentic event payloads trigger agent automation.

How do I map specific fields from an event payload into a prompt template?

You map specific event payload fields into a prompt template using dot-notation placeholders, allowing the agent to dynamically insert values like alert severity or message directly into the generated run prompt.

What's the best way to filter webhooks so my agent only runs on specific events?

The best way to filter webhooks is by defining event filters during subscription creation, ensuring the agent run only triggers when the incoming payload matches specific event types like CI alerts or payment status changes.

Do I need a specific platform configuration to receive external event webhooks?

Yes, you need an enabled webhook platform configuration to receive external event webhooks, which provides the necessary dynamic routes, persistent subscription storage, and operational testing capabilities for your integrations.

How do I manage and test webhook subscriptions after creating them?

You manage and test webhook subscriptions through persistent storage features that support list, test, and remove operations, enabling you to verify event routing and troubleshoot delivery targets without waiting for live events.