Inkbox Webhook Providers

Use when adding support for verifying a new inbound-webhook source (a third-party service that will POST signed events to this agent's /webhook endpoint), or when asked how the plugin decides whether an incoming webhook is authentic. Explains the webhook_providers registry and how to onboard a new provider.

44 stars 10 forksAI, LLMs & Agents

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add inkbox-ai/hermes-agent-plugin --skill inkbox-webhook-providers
Manual install
git clone --depth 1 https://github.com/inkbox-ai/hermes-agent-plugin.git /tmp/hermes-agent-plugin
mkdir -p ~/.claude/skills
cp -r /tmp/hermes-agent-plugin/skills/inkbox-webhook-providers ~/.claude/skills/inkbox-webhook-providers

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Adding a webhook provider

Every request that reaches the plugin's `/webhook` endpoint is signed by
whoever sent it, but each source signs differently — a different header, a
different signed payload, and a different algorithm — so there is no single
signature to check. The plugin handles this with a small registry in the
`webhook_providers/` package: each source is a `WebhookProvider` in **its own
module** that knows how to recognise its own requests and verify their
signature. The package auto-imports every module in it at startup, so adding a
source is drop-in: **create one file, no central list to edit.**

## How verification is decided

`adapter._handle_webhook` **authenticates first, then routes on the verified
source** — never on the payload's claimed `event_type`. On each inbound webhook:

1. `match_provider(headers)` returns the first registered provider whose
   signature header is present, or `None`.
2. If a provider matched, it must `verify()` (unless `INKBOX_REQUIRE_SIGNATURE`
   is off); a present-but-invalid signature is rejected `401`.
3. The **verified source** decides routing:
   - `source == "inkbox"` → dispatched to the mail/text/iMessage/call handler by
     payload shape.
   - a verified **third-party** source → handed to the agent as an external event.
   - **no provider matched** (unknown source) → external pass-through **only**
     when `INKBOX_EXTERNAL_EVENTS_ENABLED` is true (off by default); otherwise
     dropped with `200 ignored`.
Read the full skill on GitHub

Details

Skill name
inkbox-webhook-providers
Path
skills/inkbox-webhook-providers/SKILL.md
Repo updated
18 November 2026

FAQ

What does the Inkbox Webhook Providers skill do?

Use when adding support for verifying a new inbound-webhook source (a third-party service that will POST signed events to this agent's /webhook endpoint), or when asked how the plugin decides whether an incoming webhook is authentic. Explains the webhook_providers registry and how to onboard a new provider.

How do I install the Inkbox Webhook Providers skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add inkbox-ai/hermes-agent-plugin --skill inkbox-webhook-providers. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Inkbox Webhook Providers popular?

It lives in inkbox-ai/hermes-agent-plugin, which has 44 GitHub stars and 10 forks.

Related skills

Inkbox Call Review

44

inkbox-ai/hermes-agent-plugin

Use when the user asks about Inkbox call history, transcripts, missed calls, active-call status, or post-call follow-up work.

Images, Video & Audio10

Inkbox Contact Lookup

44

inkbox-ai/hermes-agent-plugin

Use when the user asks "who is X", "what's the email for Y", "find a contact named Z", "save this contact", or any question that needs contact context. Contacts are shared across the Inkbox organization.

Productivity & Notes10

Inkbox Contact Rules

44

inkbox-ai/hermes-agent-plugin

Use when the user wants to block, allow, delete, or list Inkbox contact-rule filters for the agent's mailbox or phone number. Hermes does not expose contact-rule edit tools; guide the user to Inkbox Console or explain the limitation.

AI, LLMs & Agents10

Prompt Optimizer

24

ckanner/agent-skills

This skill should be used when users request help optimizing, improving, or refining their prompts or instructions for AI models. Use this skill when users provide vague, unclear, or poorly structured prompts and need assistance transforming them into clear, effective, and well-structured instructions that AI models can better understand and execute. This skill applies comprehensive prompt engineering best practices to enhance prompt quality, clarity, and effectiveness.

AI, LLMs & AgentsIn 1 list

Inkbox Outbound Calling

44

inkbox-ai/hermes-agent-plugin

Use when the user asks the agent to place an outbound Inkbox phone call, call a phone number/contact, or call someone with a specific purpose or opening message.

AI, LLMs & Agents10

Exam Answer Eval

48

harvard-lil/lawskills-hub

Provides feedback on practice exam answers, sample essays, or issue-spotter responses. Use when a law student wants to review a practice exam answer, get feedback on an essay, improve exam performance, or prepare for future exams.

AI, LLMs & Agents

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.