webhook-subscriptions

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

6|1|Updated May 11, 2026
One-click install
npx skills add https://github.com/yakeworld/Synthos --skill webhook-subscriptions-yakeworld
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: webhook-subscriptions
Source: https://github.com/yakeworld/Synthos/tree/main/skills/extended/external-automation/automation-skills/productivity/webhook-subscriptions
Command: npx skills add https://github.com/yakeworld/Synthos --skill webhook-subscriptions-yakeworld

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? External services like GitHub, Stripe, and CI/CD pipelines emit events that require manual polling or custom glue code to act on. This Skill lets you create dynamic webhook subscriptions so those services can trigger Hermes agent runs by POSTing events to a URL, with responses delivered to Telegram, Discord, Slack, or GitHub comments. ## Core Features & Use Cases - Dynamic Subscription Management: Create, list, test, and remove webhook subscriptions via the hermes webhook CLI, with HMAC-SHA256 signature validation on every incoming POST. - Prompt Templating: Use {dot.notation} placeholders to extract nested payload fields (e.g., {issue.title}, {data.object.amount}) into precise agent prompts. - Direct Delivery Mode: Use --deliver-only to push rendered messages straight to a chat target with zero LLM cost, returning 200 on success and 502 on target failure. - Use Case: Subscribe to GitHub issue events so every new issue is triaged by an agent and the result is delivered to your Telegram chat automatically. ## Quick Start Enable the webhook platform with hermes gateway setup, then ask the agent to create a webhook subscription for GitHub issue events that delivers triage results to your 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, --events filter, and a --prompt template using {dot.notation} fields like {issue.title}. The command returns a webhook URL and HMAC secret to configure in GitHub repo Settings under Webhooks.

How do I send webhook notifications without an LLM agent run?

Add --deliver-only to the subscribe command along with a real --deliver target like telegram or discord. The rendered prompt template is dispatched directly as the message body, returning 200 on success and 502 on target failure.

What setup is required before creating webhook subscriptions?

The webhook platform must be enabled first via hermes gateway setup, manual config.yaml entries, or WEBHOOK_ENABLED environment variables. Verify the gateway is listening by running curl http://localhost:8644/health and expecting an ok status.

Why is my webhook POST being rejected with a signature error?

Rejections happen when the HMAC-SHA256 signature from the upstream service does not match the subscription secret. Run hermes webhook list to check the server secret and confirm GitHub sends X-Hub-Signature-256 while GitLab sends X-Gitlab-Token.

Can I use --deliver-only with the log delivery target?

No, --deliver-only combined with --deliver log is rejected because log-only direct delivery is pointless. Use a real target such as telegram, discord, slack, or github_comment with a valid chat ID.