Skip to content

Agent Skills for working with Hookdeck products — Event Gateway (webhooks/events) and Outpost (outbound delivery). Follows the Agent Skills specification.

License

Notifications You must be signed in to change notification settings

hookdeck/agent-skills

Hookdeck Agent Skills

Equip your AI coding agent with webhook and event-driven architecture expertise. Receive, queue, route, and deliver webhooks with Hookdeck Event Gateway, test webhooks locally with the Hookdeck CLI, and build outbound webhook delivery with Outpost.

Install (Agent Skills / Other Agents)

For Claude, ChatGPT, and other agents that support the Agent Skills specification:

npx skills add hookdeck/agent-skills

Or install a specific skill:

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

Available Skills

Skill Purpose Use when...
hookdeck Skill 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

Roadmap

Hookdeck MCP Server (coming soon)

The Hookdeck CLI will host an MCP server (hookdeck mcp), giving your coding agent direct access to the full CLI toolchain. Beyond resource management, this enables a real-time development loop:

  • Live event tools: List, inspect, and retry events and deliveries without leaving your editor
  • Webhook tunnel in the agent loop: The MCP runs hookdeck listen in-process. When webhook events arrive (or deliveries fail), the MCP pushes updates to the agent. Your agent writes the webhook handler, receives a live event, sees the result, and iterates on the code—all in a single session with no context switching.
  • Both skill repos as MCP resources: Agent-skills (Hookdeck product knowledge) and webhook-skills (provider-specific webhook knowledge for Stripe, Shopify, GitHub, etc.) served as hookdeck:// and webhooks:// resources.

This turns the plugin from a knowledge layer into an interactive development environment for webhook integrations.

Documentation

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. See TESTING.md.

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Related

License

MIT

About

Agent Skills for working with Hookdeck products — Event Gateway (webhooks/events) and Outpost (outbound delivery). Follows the Agent Skills specification.

Topics

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Packages

No packages published