[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M74W6Y0P9CJ0NQ1EPQZVC82K":3,"skill-same:01M74W6Y0P9CJ0NQ1EPQZVC82K":63},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":29,"commitSha":30,"skillDirectory":5,"forksCount":14,"repositoryHtmlUrl":31,"repositoryHomepageUrl":6,"ownerHtmlUrl":32,"ownerBlogUrl":33,"ownerDescription":6,"updatedAt":34,"install":35,"resources":48},"01M74W6Y0P9CJ0NQ1EPQZVC82K","creating-webhook-handlers",null,"Create webhook endpoints with signature verification, retry logic, and payload validation.\nUse when receiving and processing webhook events.\nTrigger with phrases like \"create webhook\", \"handle webhook events\", or \"setup webhook handler\".","SamuelChien\u002Fmega-skills-collection","SamuelChien","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F4652114?v=4","01M74KK34WVHA0P5ZYSJRDDFMG","Samuel Chien","01M74KK35FQN1N9VZ9EPTH3P2S",0,"MIT","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Fcreating-webhook-handlers\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: creating-webhook-handlers\ndescription: |\n  Create webhook endpoints with signature verification, retry logic, and payload validation.\n  Use when receiving and processing webhook events.\n  Trigger with phrases like \"create webhook\", \"handle webhook events\", or \"setup webhook handler\".\n  \nallowed-tools: Read, Write, Edit, Grep, Glob, Bash(api:webhook-*)\nversion: 1.0.0\nauthor: Jeremy Longshore \u003Cjeremy@intentsolutions.io>\nlicense: MIT\ncompatible-with: claude-code, codex, openclaw\n---\n# Creating Webhook Handlers\n\n## Overview\n\nCreate 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.\n\n## Prerequisites\n\n- Web framework with raw body access (Express with `express.raw()`, FastAPI with `Request.body()`)\n- Webhook provider credentials: signing secret or shared secret key\n- Persistent storage for idempotency tracking (Redis or database table for processed event IDs)\n- Queue system for async processing (optional: Bull, Celery, SQS)\n- ngrok or similar tunnel for local development testing\n\n## Instructions\n\n1. Examine existing route definitions and middleware using Grep and Read to identify where webhook endpoints integrate into the application.\n2. Create a dedicated webhook route (e.g., `POST \u002Fwebhooks\u002F:provider`) that captures the raw request body before any JSON parsing middleware runs.\n3. 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`).\n4. 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.\n5. Parse the event type from the payload (`event.type`, `action`, `EventType`) and route to the appropriate handler function using a dispatch map.\n6. Respond with 200 OK immediately, then enqueue the event payload for asynchronous processing to avoid webhook timeout failures.\n7. Implement dead-letter handling for events that fail processing after maximum retry attempts, logging the full payload for manual inspection.\n8. Write tests that replay recorded webhook payloads with valid and tampered signatures to verify acceptance and rejection behavior.\n\nSee `${CLAUDE_SKILL_DIR}\u002Freferences\u002Fimplementation.md` for the full implementation guide.\n\n## Output\n\n- `${CLAUDE_SKILL_DIR}\u002Fsrc\u002Fwebhooks\u002Freceiver.js` - Webhook endpoint with signature verification\n- `${CLAUDE_SKILL_DIR}\u002Fsrc\u002Fwebhooks\u002Fhandlers\u002F` - Per-event-type handler functions\n- `${CLAUDE_SKILL_DIR}\u002Fsrc\u002Fwebhooks\u002Fverify.js` - HMAC signature verification utilities\n- `${CLAUDE_SKILL_DIR}\u002Fsrc\u002Fwebhooks\u002Fidempotency.js` - Duplicate event detection logic\n- `${CLAUDE_SKILL_DIR}\u002Fsrc\u002Fqueues\u002Fwebhook-processor.js` - Async event processing queue worker\n- `${CLAUDE_SKILL_DIR}\u002Ftests\u002Fwebhooks\u002F` - Replay tests with recorded payloads\n\n## Error Handling\n\n| Error | Cause | Solution |\n|-------|-------|----------|\n| 401 Signature Mismatch | HMAC verification failed against provider signature | Log the expected vs. received signature (redacted); verify signing secret rotation status |\n| 400 Malformed Payload | Raw body is not valid JSON or missing required fields | Return 400 so provider marks delivery as failed; log raw body for debugging |\n| 200 OK (duplicate) | Event ID already processed; idempotency guard triggered | Return 200 to prevent provider retry loops; log duplicate detection for monitoring |\n| 504 Gateway Timeout | Synchronous processing exceeded provider timeout (typically 5-30s) | Move processing to async queue; respond 200 immediately upon signature verification |\n| 500 Handler Exception | Business logic threw unhandled error during processing | Catch at dispatch layer; log full error with event payload; allow provider to retry |\n\nRefer to `${CLAUDE_SKILL_DIR}\u002Freferences\u002Ferrors.md` for comprehensive error patterns.\n\n## Examples\n\n**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.\n\n**GitHub push webhook**: Validate `X-Hub-Signature-256`, parse `push` events, extract commit list, and trigger CI\u002FCD pipeline via queue message.\n\n**Multi-provider router**: Single `\u002Fwebhooks\u002F:provider` endpoint that loads provider-specific signature verifier and event schema from a registry, supporting Stripe, GitHub, Twilio, and custom providers.\n\nSee `${CLAUDE_SKILL_DIR}\u002Freferences\u002Fexamples.md` for additional examples.\n\n## Resources\n\n- Stripe Webhook Signatures: https:\u002F\u002Fstripe.com\u002Fdocs\u002Fwebhooks\u002Fsignatures\n- GitHub Webhook Events: https:\u002F\u002Fdocs.github.com\u002Fen\u002Fwebhooks\n- RFC 2104 HMAC specification for signature computation\n- OWASP Webhook Security best practices","# Creating Webhook Handlers\n\n## Overview\n\nCreate 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.\n\n## Prerequisites\n\n- Web framework with raw body access (Express with `express.raw()`, FastAPI with `Request.body()`)\n- Webhook provider credentials: signing secret or shared secret key\n- Persistent storage for idempotency tracking (Redis or database table for processed event IDs)\n- Queue system for async processing (optional: Bull, Celery, SQS)\n- ngrok or similar tunnel for local development testing\n\n## Instructions\n\n1. Examine existing route definitions and middleware using Grep and Read to identify where webhook endpoints integrate into the application.\n2. Create a dedicated webhook route (e.g., `POST \u002Fwebhooks\u002F:provider`) that captures the raw request body before any JSON parsing middleware runs.\n3. 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`).\n4. 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.\n5. Parse the event type from the payload (`event.type`, `action`, `EventType`) and route to the appropriate handler function using a dispatch map.\n6. Respond with 200 OK immediately, then enqueue the event payload for asynchronous processing to avoid webhook timeout failures.\n7. Implement dead-letter handling for events that fail processing after maximum retry attempts, logging the full payload for manual inspection.\n8. Write tests that replay recorded webhook payloads with valid and tampered signatures to verify acceptance and rejection behavior.\n\nSee `${CLAUDE_SKILL_DIR}\u002Freferences\u002Fimplementation.md` for the full implementation guide.\n\n## Output\n\n- `${CLAUDE_SKILL_DIR}\u002Fsrc\u002Fwebhooks\u002Freceiver.js` - Webhook endpoint with signature verification\n- `${CLAUDE_SKILL_DIR}\u002Fsrc\u002Fwebhooks\u002Fhandlers\u002F` - Per-event-type handler functions\n- `${CLAUDE_SKILL_DIR}\u002Fsrc\u002Fwebhooks\u002Fverify.js` - HMAC signature verification utilities\n- `${CLAUDE_SKILL_DIR}\u002Fsrc\u002Fwebhooks\u002Fidempotency.js` - Duplicate event detection logic\n- `${CLAUDE_SKILL_DIR}\u002Fsrc\u002Fqueues\u002Fwebhook-processor.js` - Async event processing queue worker\n- `${CLAUDE_SKILL_DIR}\u002Ftests\u002Fwebhooks\u002F` - Replay tests with recorded payloads\n\n## Error Handling\n\n| Error | Cause | Solution |\n|-------|-------|----------|\n| 401 Signature Mismatch | HMAC verification failed against provider signature | Log the expected vs. received signature (redacted); verify signing secret rotation status |\n| 400 Malformed Payload | Raw body is not valid JSON or missing required fields | Return 400 so provider marks delivery as failed; log raw body for debugging |\n| 200 OK (duplicate) | Event ID already processed; idempotency guard triggered | Return 200 to prevent provider retry loops; log duplicate detection for monitoring |\n| 504 Gateway Timeout | Synchronous processing exceeded provider timeout (typically 5-30s) | Move processing to async queue; respond 200 immediately upon signature verification |\n| 500 Handler Exception | Business logic threw unhandled error during processing | Catch at dispatch layer; log full error with event payload; allow provider to retry |\n\nRefer to `${CLAUDE_SKILL_DIR}\u002Freferences\u002Ferrors.md` for comprehensive error patterns.\n\n## Examples\n\n**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.\n\n**GitHub push webhook**: Validate `X-Hub-Signature-256`, parse `push` events, extract commit list, and trigger CI\u002FCD pipeline via queue message.\n\n**Multi-provider router**: Single `\u002Fwebhooks\u002F:provider` endpoint that loads provider-specific signature verifier and event schema from a registry, supporting Stripe, GitHub, Twilio, and custom providers.\n\nSee `${CLAUDE_SKILL_DIR}\u002Freferences\u002Fexamples.md` for additional examples.\n\n## Resources\n\n- Stripe Webhook Signatures: https:\u002F\u002Fstripe.com\u002Fdocs\u002Fwebhooks\u002Fsignatures\n- GitHub Webhook Events: https:\u002F\u002Fdocs.github.com\u002Fen\u002Fwebhooks\n- RFC 2104 HMAC specification for signature computation\n- OWASP Webhook Security best practices",{"name":5,"author":24,"license":15,"version":25,"description":26,"allowed-tools":27,"compatible-with":28},"Jeremy Longshore \u003Cjeremy@intentsolutions.io>","1.0.0","Create webhook endpoints with signature verification, retry logic, and payload validation.\nUse when receiving and processing webhook events.\nTrigger with phrases like \"create webhook\", \"handle webhook events\", or \"setup webhook handler\".\n","Read, Write, Edit, Grep, Glob, Bash(api:webhook-*)","claude-code, codex, openclaw","main","c2b1fdccc779e99ac814e55fb69ca8d71215dd0f","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection","https:\u002F\u002Fgithub.com\u002FSamuelChien","http:\u002F\u002Fsamuelchien.com\u002F","2026-05-26 08:27:14",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add SamuelChien\u002Fmega-skills-collection --skill creating-webhook-handlers",{"tool":41,"command":42},"bunx","bunx skills add SamuelChien\u002Fmega-skills-collection --skill creating-webhook-handlers",{"tool":44,"command":45},"pnpm","pnpm dlx skills add SamuelChien\u002Fmega-skills-collection --skill creating-webhook-handlers","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Fcreating-webhook-handlers\u002FSKILL.md",true,[49,55,59],{"path":50,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":53,"sourceHtmlUrl":54},"references\u002Ferrors.md","REFERENCE","参考文档",901,"https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Fcreating-webhook-handlers\u002Freferences\u002Ferrors.md",{"path":56,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":57,"sourceHtmlUrl":58},"references\u002Fexamples.md",6957,"https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Fcreating-webhook-handlers\u002Freferences\u002Fexamples.md",{"path":60,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":61,"sourceHtmlUrl":62},"references\u002Fimplementation.md",1405,"https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Fcreating-webhook-handlers\u002Freferences\u002Fimplementation.md",[64,71,78,85,92,100],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M76R4WZQZAXGGXMQCA0FZ716","zustand-store-ts","Create Zustand stores with TypeScript, subscribeWithSelector middleware, and proper state\u002Faction separation. Use when building React state management, creating global stores, or implementing reactive state patterns with Zustand.","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Fzustand-store-ts\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M76R4T9KENDH7FENGZQHBW4G","zustand-store-creator","Zustand Store Creator - Auto-activating skill for Frontend Development.\nTriggers on: zustand store creator, zustand store creator\nPart of the Frontend Development skill category.","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Fzustand-store-creator\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M76R3YWN84B7SANJ52X799ZE","zero-trust-config-helper","Zero Trust Config Helper - Auto-activating skill for Security Advanced.\nTriggers on: zero trust config helper, zero trust config helper\nPart of the Security Advanced skill category.","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Fzero-trust-config-helper\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M76R3HNSV2AEYSKHM915GJ58","zapier-integration-helper","Zapier Integration Helper - Auto-activating skill for Business Automation.\nTriggers on: zapier integration helper, zapier integration helper\nPart of the Business Automation skill category.","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Fzapier-integration-helper\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":96,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":19},"01M76R3DJSKAT4FA7DV4BF3GCE","zai-cli","Execute z.AI CLI providing vision, search, reader, and GitHub exploration via CLI and MCP.\nUse when user needs image\u002Fvideo analysis, OCR, UI-to-code conversion, error diagnosis,\nreal-time web search, web page to markdown extraction, or GitHub code exploration.\nTrigger with phrases like \"analyze this image\", \"search the web for\", \"read this page\",\n\"explore this repo\", or \"use zai\". Requires Z_AI_API_KEY.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Fzai-cli\u002FSKILL.md",[],[],{"skillNo":101,"name":102,"nameZh":6,"description":103,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":104,"categories":105,"keywords":106,"publishedAt":19},"01M76R2KAM699XE9AJVAWE4H2E","yt-research","Research competitor YouTube channels, niches, and trending topics for your content strategy.\nUse this skill whenever the user says \"research channels\", \"analyze competitors\", \"find trending topics\",\n\"niche analysis\", \"competitive research\", \"what are other creators doing\", \"scrape YouTube channels\",\nor wants to understand the competitive landscape for a specific tool or topic area. Use when working with yt research. Trigger with 'yt', 'research'.","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Fyt-research\u002FSKILL.md",[],[]]