Skip to content

feat: Restructure Hookdeck skills and add dynamic test discovery#35

Merged
leggetter merged 2 commits intomainfrom
feat/hookdeck-skills-restructure
Feb 6, 2026
Merged

feat: Restructure Hookdeck skills and add dynamic test discovery#35
leggetter merged 2 commits intomainfrom
feat/hookdeck-skills-restructure

Conversation

@leggetter
Copy link
Collaborator

@leggetter leggetter commented Feb 6, 2026

Summary

  • Restructure hookdeck-event-gateway into a high-level router skill that sells the value proposition (queue replacement, guaranteed delivery, retries, rate limiting, observability) with doc links and before/after code examples
  • Create hookdeck-event-gateway-webhooks as a dedicated skill for x-hookdeck-signature verification with framework handlers, examples, and references (moved from the old monolithic skill)
  • Create outpost router skill for Hookdeck Outpost (outbound event delivery)
  • Replace test-all-examples.sh with test-examples.sh that dynamically discovers skills via the filesystem (19 skills found vs 5 hardcoded), accepts optional positional args to test specific skills
  • Update all 17 provider skills with consistent hookdeck-event-gateway Related Skills description
  • Update README.md with Webhook Infrastructure Skills section
  • Update CI, providers.yaml, TESTING.md, AGENTS.md to reflect new skill locations and script name

Test plan

  • Express examples pass (10 tests) at new hookdeck-event-gateway-webhooks location
  • Next.js examples pass (9 tests) at new location
  • FastAPI examples pass (8 tests) at new location
  • test-examples.sh --help discovers all 19 skills with examples
  • test-examples.sh stripe-webhooks github-webhooks multi-arg form works
  • Invalid skill name produces clean error
  • CI workflow runs on this PR (verify provider detection picks up hookdeck-event-gateway-webhooks)

Made with Cursor

leggetter and others added 2 commits February 6, 2026 18:56
Refactor hookdeck-event-gateway into a high-level overview skill that
sells the value proposition (queue replacement, guaranteed delivery,
retries, rate limiting, observability) with quick start and doc links,
and extract verification code/examples into a new
hookdeck-event-gateway-webhooks skill for x-hookdeck-signature handling.

- Rewrite hookdeck-event-gateway/SKILL.md as router skill with value
  prop, before/after code comparison, feature sections linked to docs
- Create hookdeck-event-gateway-webhooks/ with verification code,
  framework handlers, headers reference, examples, and references
- Move examples/ and relevant references/ from hookdeck-event-gateway
  to hookdeck-event-gateway-webhooks
- Create outpost/ router skill for Hookdeck Outpost (outbound events)
- Update README.md with Webhook Infrastructure Skills section
- Update Related Skills in all 17 provider skills with consistent
  hookdeck-event-gateway description
- Update providers.yaml, test-all-examples.sh, test-examples.yml CI,
  and TESTING.md to reflect new skill location

Co-authored-by: Cursor <cursoragent@cursor.com>
Replace hardcoded provider list (5 skills) with filesystem discovery
that automatically finds all skills with examples/ directories (19
skills). Accepts optional positional args to test specific skills.

- Discover skills via ls skills/*/examples/ instead of hardcoded array
- Accept optional args: ./scripts/test-examples.sh stripe-webhooks
- Add --help with dynamic list of available skills and frameworks
- Update providers.yaml to use default skillName convention
- Update CI workflow to remove hookdeck-event-gateway special case
- Update TESTING.md scenario 4 for hookdeck-event-gateway-webhooks
- Update AGENTS.md references to new script name

Co-authored-by: Cursor <cursoragent@cursor.com>
@leggetter leggetter changed the title Restructure Hookdeck skills and add dynamic test discovery feat: Restructure Hookdeck skills and add dynamic test discovery Feb 6, 2026
@leggetter leggetter merged commit 2d5c9da into main Feb 6, 2026
54 checks passed
@leggetter leggetter deleted the feat/hookdeck-skills-restructure branch February 6, 2026 19:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant