Hookdeck Agent Skills

Agent Skills for working with Hookdeck products. Follows the Agent Skills specification.

Install

npx skills add hookdeck/agent-skills

Or install a specific skill:

npx skills add hookdeck/agent-skills --skill event-gateway

Available Skills

Skill	Purpose	Use when...
hookdeck	Master router	You need help with any Hookdeck product and aren't sure which skill to use
event-gateway	Receive, route, and deliver webhooks	Getting started with Hookdeck, receiving webhooks, configuring connections, local development, monitoring, or API automation
outpost	Send webhooks to customers	Sending events to customer endpoints via HTTP, SQS, RabbitMQ, Pub/Sub, or other destinations

You Say -> Skill Used

What you say	Skill
"Set up Hookdeck for my project"	event-gateway
"Receive webhooks from Stripe"	event-gateway
"Test webhooks locally"	event-gateway
"Filter events by type"	event-gateway
"Why are my webhooks failing?"	event-gateway
"Create a connection via the API"	event-gateway
"Send webhooks to my users"	outpost

Event Gateway Workflow

The event-gateway skill includes a staged integration workflow:

1. Setup -- Create account, install CLI, create connection
2. Scaffold -- Build webhook handler with verification code (for provider webhooks like Stripe or Shopify, use event-gateway together with the matching skill from webhook-skills)
3. Listen -- Start hookdeck listen, trigger test events
4. Iterate -- Debug failures, fix code, replay events

Documentation

• Event Gateway docs
• Outpost docs
• API reference

Testing

• Code examples: Run ./scripts/test-examples.sh or see TESTING.md.
• Agent scenarios: Run the scenario tester to verify an agent follows the event-gateway workflow (and, for provider webhooks, uses webhook-skills). See TESTING.md.

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Related

• hookdeck/webhook-skills -- Provider-specific webhook skills (Stripe, Shopify, GitHub, etc.)

License

MIT