| name | outpost |
| description | Sets up and configures Hookdeck Outpost for outbound event delivery to customer endpoints. Use when sending webhooks to customers, building webhook delivery infrastructure, managing tenants and destinations with supported types (webhooks, Hookdeck Event Gateway, AWS SQS/Kinesis/S3, Azure Service Bus, GCP Pub/Sub, RabbitMQ, Kafka), or aligning topics and publishes. EventBridge support is tracked in GitHub issues. |
| allowed-tools | WebFetch |
Hookdeck Outpost
Outbound event delivery: publish platform events to tenants’ destinations (webhooks, queues, cloud buses—see supported destinations). Open source on GitHub; managed on Hookdeck Cloud or self-hosted.
Single source of truth: Use Hookdeck Outpost documentation for concepts, API, quickstarts, and UI guidance. This skill links there and adds agent workflow notes under references/.
Documentation index for agents
Quickstarts (smallest path first)
Use the official managed-Outpost walkthroughs before opening full-stack examples in this repo:
Compact link list: references/outpost-quickstarts.md.
Test webhook destination URLs (README and docs)
When you need a throwaway HTTPS URL for a webhook destination (quickstarts, curl examples, “verify delivery”):
- Prefer Hookdeck Console — create a Source, copy its URL (e.g.
https://hkdk.events/…), and inspect or replay deliveries in one place. This is the Hookdeck-native default for agents and humans.
Fast path for agents
- Start with references/outpost-scope.md to pick Quick path vs New minimal app vs Existing app.
- If scope is ambiguous, default to the smallest quickstart-shaped artifact.
- Fetch only the language quickstart you need (curl, TypeScript, Python, Go).
- Use references/outpost-verify.md before finishing.
- Open full-stack examples only when the task clearly requires BFF/UI integration patterns.
Scope and verification (agent workflow)
Dashboard-style guidance (no {{PLACEHOLDERS}} — those stay dashboard-only):
BFF / wire JSON: Authentication · Wire JSON, SDK responses, and your UI
Supported destination types
Available: Webhooks (HTTP), Hookdeck Event Gateway, AWS SQS, AWS Kinesis, AWS S3, Azure Service Bus, GCP Pub/Sub, RabbitMQ (AMQP), Kafka
Planned: AWS EventBridge
Deployment and API pointers
Full-stack reference examples (advanced)
Use only when the task needs realistic BFF + dashboard patterns—not for “smallest example” (use Quickstarts and llms.txt first).
Integration maps (read before opening trees):
Treat examples as references, not copy-paste scaffolds. Prefer the user’s codebase and use maps for Outpost-specific behavior (server-only admin key, tenant mapping, BFF routes, domain publish).
Dependency and version pins live in the example manifests (package.json, pyproject.toml).
How to use the examples: Read the integration maps and README overviews first; open other files only when they match the user’s task.
Tests: npm test in nextjs-saas (Vitest); pytest test_outpost_wire.py in fastapi-saas/backend via ./scripts/test-examples.sh outpost. Next.js example uses npm.
Future skills
Destination-specific skills (outpost-webhooks, outpost-sqs, …) may be added as documentation matures.
Related skills
