New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Creating Webhook Handlers

by jeremylongshore in jeremylongshore/tons-of-skills-marketplace

Create webhook endpoints with signature verification, retry logic, and payload validation.

MITAuto-check passedBackend & APIs

Install Creating Webhook Handlers

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill creating-webhook-handlers -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace creating-webhook-handlers --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.curated/creating-webhook-handlers .claude/skills/creating-webhook-handlers && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
creating-webhook-handlers
GitHub stars
2.8k
Token cost
~1.3k tokens
SKILL.md length
511 words
Files
4 (incl. references)
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Create webhook endpoints with signature verification, retry logic, and payload validation.

  • Works in 8 steps: Examine existing route definitions and… → Create a dedicated webhook route (e.g.,… → Implement HMAC-SHA256 signature… → …
  • Receiving and processing webhook events
  • SKILL.md covers Overview, Prerequisites, Instructions and Output, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Creating Webhook Handlers is an agent skill from jeremylongshore/tons-of-skills-marketplace. Create webhook endpoints with signature verification, retry logic, and payload validation. Use when receiving and processing webhook events. Trigger with phrases like "create webhook", "handle webhook events", or "setup webhook handler".

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/errors.md`, `references/examples.md` and `references/implementation.md`). Compatibility notes: Designed for Claude Code

It sits in Backend & APIs, covering Webhooks. The repository describes itself as: Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com. The licence is MIT.

When your agent uses it

  • Receiving and processing webhook events
  • With phrases like create webhook
  • Handle webhook events
  • Setup webhook handler

Example prompts

  • “create webhook”
  • “handle webhook events”
  • “setup webhook handler”
  • “/creating-webhook-handlers”

Requirements

  • Compatibility (from SKILL.md): Designed for Claude Code
  • Pre-approved tools (allowed-tools): Read, Write, Edit, Grep, Glob, Bash(api:webhook-*)

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Examine existing route definitions and middleware using Grep and Read to identify where webhook endpoints integrate into the application.
  2. Create a dedicated webhook route (e.g., POST /webhooks/:provider) that captures the raw request body before any JSON parsing middleware…
  3. Implement HMAC-SHA256 signature verification by computing HMAC(raw_body, signing_secret) and comparing against the provider's signature…
  4. Add idempotency protection by storing processed event IDs (e.g., evt_xxx) in Redis or a database table, rejecting duplicates with 200 OK…
  5. Parse the event type from the payload (event.type, action, EventType) and route to the appropriate handler function using a dispatch map.
  6. Respond with 200 OK immediately, then enqueue the event payload for asynchronous processing to avoid webhook timeout failures.
  7. Implement dead-letter handling for events that fail processing after maximum retry attempts, logging the full payload for manual inspection.
  8. Write tests that replay recorded webhook payloads with valid and tampered signatures to verify acceptance and rejection behavior.

What it can do on your machine

Read from SKILL.md and the folder at commit cfae287. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Grep
    • Glob
    • Bash(api:webhook-*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • stripe.com
    • docs.github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Designed for Claude Code

    From compatibility in the SKILL.md frontmatter.

Context cost

Creating Webhook Handlers loads about 1.3k tokens when it runs, and up to ~3.7k if it reads all its reference files. Until then it costs about 66 tokens; SKILL.md has 511 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~66
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit cfae287, republished under its MIT licence (© jeremylongshore). 511 words, ~1,261 tokens.

Download SKILL.mdSave it as .claude/skills/creating-webhook-handlers/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
creating-webhook-handlers
description
Create webhook endpoints with signature verification, retry logic, and payload validation. Use when receiving and processing webhook events. Trigger with phrases like "create webhook", "handle webhook events", or "setup webhook handler".
allowed-tools
Read, Write, Edit, Grep, Glob, Bash(api:webhook-*)
compatibility
Designed for Claude Code
version
1.27.0
author
Jeremy Longshore <jeremy@intentsolutions.io>
license
MIT
tags
api, webhooks, webhook-handlers

Creating Webhook Handlers

Overview

Create secure webhook receiver endpoints with HMAC signature verification, idempotent event processing, and automatic retry handling. Support ingestion from providers like Stripe, GitHub, Twilio, and Slack with provider-specific signature validation schemes and payload parsing.

Prerequisites

  • Web framework with raw body access (Express with express.raw(), FastAPI with Request.body())
  • Webhook provider credentials: signing secret or shared secret key
  • Persistent storage for idempotency tracking (Redis or database table for processed event IDs)
  • Queue system for async processing (optional: Bull, Celery, SQS)
  • ngrok or similar tunnel for local development testing

Instructions

  1. Examine existing route definitions and middleware using Grep and Read to identify where webhook endpoints integrate into the application.
  2. Create a dedicated webhook route (e.g., POST /webhooks/:provider) that captures the raw request body before any JSON parsing middleware runs.
  3. Implement HMAC-SHA256 signature verification by computing HMAC(raw_body, signing_secret) and comparing against the provider's signature header (X-Hub-Signature-256, Stripe-Signature, X-Twilio-Signature).
  4. Add idempotency protection by storing processed event IDs (e.g., evt_xxx) in Redis or a database table, rejecting duplicates with 200 OK to prevent provider retries.
  5. Parse the event type from the payload (event.type, action, EventType) and route to the appropriate handler function using a dispatch map.
  6. Respond with 200 OK immediately, then enqueue the event payload for asynchronous processing to avoid webhook timeout failures.
  7. Implement dead-letter handling for events that fail processing after maximum retry attempts, logging the full payload for manual inspection.
  8. Write tests that replay recorded webhook payloads with valid and tampered signatures to verify acceptance and rejection behavior.

See ${CLAUDE_SKILL_DIR}/references/implementation.md for the full implementation guide.

Output

  • ${CLAUDE_SKILL_DIR}/src/webhooks/receiver.js - Webhook endpoint with signature verification
  • ${CLAUDE_SKILL_DIR}/src/webhooks/handlers/ - Per-event-type handler functions
  • ${CLAUDE_SKILL_DIR}/src/webhooks/verify.js - HMAC signature verification utilities
  • ${CLAUDE_SKILL_DIR}/src/webhooks/idempotency.js - Duplicate event detection logic
  • ${CLAUDE_SKILL_DIR}/src/queues/webhook-processor.js - Async event processing queue worker
  • ${CLAUDE_SKILL_DIR}/tests/webhooks/ - Replay tests with recorded payloads
Show full SKILL.md (214 more words)Show less

Error Handling

ErrorCauseSolution
401 Signature MismatchHMAC verification failed against provider signatureLog the expected vs. received signature (redacted); verify signing secret rotation status
400 Malformed PayloadRaw body is not valid JSON or missing required fieldsReturn 400 so provider marks delivery as failed; log raw body for debugging
200 OK (duplicate)Event ID already processed; idempotency guard triggeredReturn 200 to prevent provider retry loops; log duplicate detection for monitoring
504 Gateway TimeoutSynchronous processing exceeded provider timeout (typically 5-30s)Move processing to async queue; respond 200 immediately upon signature verification
500 Handler ExceptionBusiness logic threw unhandled error during processingCatch at dispatch layer; log full error with event payload; allow provider to retry

Refer to ${CLAUDE_SKILL_DIR}/references/errors.md for comprehensive error patterns.

Examples

Stripe payment webhook: Verify Stripe-Signature header using stripe.webhooks.constructEvent(), then dispatch payment_intent.succeeded to fulfill orders and charge.refunded to process refund credits.

GitHub push webhook: Validate X-Hub-Signature-256, parse push events, extract commit list, and trigger CI/CD pipeline via queue message.

Multi-provider router: Single /webhooks/:provider endpoint that loads provider-specific signature verifier and event schema from a registry, supporting Stripe, GitHub, Twilio, and custom providers.

See ${CLAUDE_SKILL_DIR}/references/examples.md for additional examples.

Resources

© jeremylongshore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in skills/.curated/creating-webhook-handlers of jeremylongshore/tons-of-skills-marketplace.

  • SKILL.md
  • references/errors.md
  • references/examples.md
  • references/implementation.md

Open the folder on GitHubat commit cfae287

Compare with similar skills

Creating Webhook Handlers next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Creating Webhook Handlers compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Creating Webhook Handlers this skilljeremylongshore/tons-of-skills-marketplace2.8k—~1.3kAutomated safety check: PassMIT
Novu Design Workflownovuhq/novu40k—~2.6kAutomated safety check: PassCustom licence
Golivemikehasa/golive-skill1.3k—~13kAutomated safety check: NotesMIT
Stripe Appsfossasia/eventyay1.7k1 repos~3.6kAutomated safety check: PassApache-2.0
Dingtalk Messageagentscope-ai/ReMe3.6k—~1.6kAutomated safety check: PassApache-2.0
PR Review Provideryansongda/pay5.4k—~2.4kAutomated safety check: PassMIT

Similar skills

  • Novu Design Workflow

    novuhq/novu

    Design notification workflows the Novu way — choose channels, set severity, decide when a workflow is critical, configure digests, and route based on subscriber state.

    40k GitHub stars~2.6k tokensUpdated yesterday
    Backend & APIsAuto-check passed

  • Golive

    mikehasa/golive-skill

    Take an agent-written app from repo to live production on the user's OWN accounts, with providers they choose (hosting, database, auth, payments, email, domain/DNS).

    1.3k GitHub stars~13k tokensUpdated 7 days ago
    Backend & APIsAuto-check: notes

  • Stripe Apps

    fossasia/eventyay

    A skill your agent uses when building, modifying, or reviewing a Stripe App — or when the user describes something that implies one (e.g.

    1.7k GitHub starsUsed in 1 repo~3.6k tokens
    Backend & APIsAuto-check passed

  • Dingtalk Message

    agentscope-ai/ReMe

    钉钉消息发送技能。支持企业内部机器人（批量单聊/群聊）和 Webhook 自定义机器人两种接入方式，支持多机器人管理，支持文本、Markdown、链接、ActionCard、FeedCard等多种消息类型。

    3.6k GitHub stars~1.6k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed

  • PR Review Provider

    yansongda/pay

    A skill your agent uses when reviewing PRs that add or modify a payment Provider in yansongda/pay - covers plugin pipeline, multi-tenant safety, signature verification, docs, and naming conventions.

    5.4k GitHub stars~2.4k tokensUpdated 3 days ago
    Backend & APIsAuto-check passed

  • Stripe Best Practices

    kanchengw/cnllm

    Guides Stripe integration decisions — API selection (Checkout Sessions vs PaymentIntents), Connect platform setup (Accounts v2, controller properties), billing/subscriptions, Treasury financial…

    173 GitHub starsUsed in 2 repos~925 tokens
    Backend & APIsAuto-check passed

More from jeremylongshore/tons-of-skills-marketplace

All 3,342 skills in this repo

  • Performing Security Code Review

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.

    2.8k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check: notes

  • Adapting Transfer Learning Models

    jeremylongshore/tons-of-skills-marketplace

    Build this skill automates the adaptation of pre-trained machine learning models using transfer learning techniques.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed

  • Agent Context Loader

    jeremylongshore/tons-of-skills-marketplace

    Execute proactive auto-loading: automatically detects and loads agents.md files.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed

  • Aggregating Performance Metrics

    jeremylongshore/tons-of-skills-marketplace

    Aggregate and centralize performance metrics from applications, systems, databases, caches, and services.

    2.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed

  • Analyzing Capacity Planning

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to analyze capacity requirements and plan for future growth.

    2.8k GitHub stars~947 tokensUpdated today
    Auto-check passed

  • Analyzing Database Indexes

    jeremylongshore/tons-of-skills-marketplace

    Process use when you need to work with database indexing. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~2k tokensUpdated today
    Auto-check passed

Categories

Questions about Creating Webhook Handlers

What does Creating Webhook Handlers do?

Create webhook endpoints with signature verification, retry logic, and payload validation. Creating Webhook Handlers is an agent skill from jeremylongshore/tons-of-skills-marketplace. Create webhook endpoints with signature verification, retry logic, and payload validation.

When should I use Creating Webhook Handlers?

Creating Webhook Handlers fits situations like: receiving and processing webhook events; with phrases like create webhook; handle webhook events; setup webhook handler.

How do I install Creating Webhook Handlers in Claude Code?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill creating-webhook-handlers -a claude-code`. Or copy the skill folder (skills/.curated/creating-webhook-handlers in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/creating-webhook-handlers in your project. Claude Code loads it when a task matches its description.

How do I install Creating Webhook Handlers in Codex?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill creating-webhook-handlers -a codex`. Or copy the skill folder (skills/.curated/creating-webhook-handlers in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/creating-webhook-handlers in your project. Codex loads it when a task matches its description.

Can I use Creating Webhook Handlers in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill creating-webhook-handlers -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/creating-webhook-handlers, .gemini/skills/creating-webhook-handlers, .github/skills/creating-webhook-handlers and .opencode/skills/creating-webhook-handlers in your project.

What does Creating Webhook Handlers need to run?

SKILL.md names no scripts, command-line tools or credentials: Creating Webhook Handlers is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Write, Edit, Grep, Glob, Bash(api:webhook-*). Compatibility (from SKILL.md): Designed for Claude Code.

Does Creating Webhook Handlers access the network?

SKILL.md names 2 domains. As links in the text: stripe.com and docs.github.com. This is read from the text; nothing was executed.

Is Creating Webhook Handlers safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Creating Webhook Handlers use?

Creating Webhook Handlers is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Creating Webhook Handlers use?

About 1.3k tokens (SKILL.md is roughly 5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.4k tokens, read only when the agent opens those files.

What are the alternatives to Creating Webhook Handlers?

Skills that share tags, products or a category with Creating Webhook Handlers: Novu Design Workflow (novuhq/novu, 40k stars), Golive (mikehasa/golive-skill, 1.3k stars), Stripe Apps (fossasia/eventyay, 1.7k stars) and Dingtalk Message (agentscope-ai/ReMe, 3.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Creating Webhook Handlers?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,827 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 10, 2026.

Source: jeremylongshore/tons-of-skills-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.