Outpost
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.From its SKILL.md
npx -y skills add hookdeck/agent-skills --skill outpostAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
- fetches URLsInstructs the agent to fetch 1 URL, including https://hookdeck.com/docs/outpost/llms.txt.
SKILL.md
7.1 KB, ~1.7k tokens by cl100k_base, as published. Nobody here has run it
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
llms.txt: https://hookdeck.com/docs/outpost/llms.txt — plain-text map of doc pages as.mdURLs; fetch once when you need the full tree or many pages.- Concepts: Tenants, destinations, topics, publish
- API reference: REST / OpenAPI; self-hosted spec file:
https://github.com/hookdeck/outpost/blob/main/docs/apis/openapi.yaml - SDKs: Overview — for TypeScript, Python, or Go, follow that language’s quickstart for correct signatures.
- Building your own UI: Guide — screen flow, BFF pattern, implementation checklists.
- Destinations / topics: Destination types · Topics and subscriptions
Quickstarts (smallest path first)
Use the official managed-Outpost walkthroughs before opening full-stack examples in this repo:
| curl (HTTP only) | Hookdeck Outpost curl quickstart |
| TypeScript | TypeScript quickstart |
| Python | Python quickstart |
| Go | Go quickstart |
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):
- references/outpost-scope.md — three-path ladder, default-to-smallest, language vs architecture, topic reconciliation, SDK vs OpenAPI / BFF pointers with links to Building your own UI anchors.
- references/outpost-verify.md — trimmed “before you stop” checklist.
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
- Managed: Hookdeck Outpost docs and per-language quickstarts.
- Self-hosted quickstarts: Docker, Kubernetes, Railway, Configuration.
- API reference: Outpost REST / OpenAPI.
- Base URL note: Managed API base is project-specific (quickstarts currently show
https://api.outpost.hookdeck.com/2025-07-01); verify live docs/project settings if unsure.
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):
- Next.js: references/nextjs-saas-integration-map.md
- FastAPI: references/fastapi-saas-integration-map.md
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).
| Example | Stack | Location |
|---|---|---|
| SaaS (Next.js) | App Router + @hookdeck/outpost-sdk + dashboard UI | examples/nextjs-saas/ — README |
| SaaS (FastAPI + React) | FastAPI BFF (httpx → Outpost) + template UI | examples/fastapi-saas/ — README |
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
- hookdeck — skill router for Hookdeck products
- event-gateway — Hookdeck Event Gateway (inbound webhooks)
What ships with it: 290 files
1370.1 KB alongside SKILL.md, 129 of them executable
examples/
- fastapi-saas/backend/alembic.iniruns1.6 KB
- fastapi-saas/backend/app/alembic/env.pyruns2.3 KB
- fastapi-saas/backend/app/alembic/READMEruns39 B
- fastapi-saas/backend/app/alembic/script.py.makoruns523 B
- fastapi-saas/backend/app/alembic/versions/1a31ce608336_add_cascade_delete_relationships.pyruns1.1 KB
- fastapi-saas/backend/app/alembic/versions/9c0a54914c78_add_max_length_for_string_varchar_.pyruns2.2 KB
- fastapi-saas/backend/app/alembic/versions/d98dd8ec85a3_edit_replace_id_integers_in_all_models_.pyruns3.7 KB
- fastapi-saas/backend/app/alembic/versions/e2412789c190_initialize_models.pyruns1.7 KB
- fastapi-saas/backend/app/alembic/versions/fe56fa70289e_add_created_at_to_user_and_item.pyruns852 B
- fastapi-saas/backend/app/alembic/versions/.keepruns0 B
- fastapi-saas/backend/app/api/deps.pyruns1.7 KB
- fastapi-saas/backend/app/api/__init__.pyruns0 B
- fastapi-saas/backend/app/api/main.pyruns452 B
- fastapi-saas/backend/app/api/routes/__init__.pyruns0 B
- fastapi-saas/backend/app/api/routes/items.pyruns3.4 KB
- fastapi-saas/backend/app/api/routes/login.pyruns4.0 KB
- fastapi-saas/backend/app/api/routes/outpost.pyruns10.6 KB
- fastapi-saas/backend/app/api/routes/private.pyruns777 B
- fastapi-saas/backend/app/api/routes/users.pyruns8.5 KB
- fastapi-saas/backend/app/api/routes/utils.pyruns783 B
- fastapi-saas/backend/app/backend_pre_start.pyruns921 B
- fastapi-saas/backend/app/core/config.pyruns3.8 KB
- fastapi-saas/backend/app/core/db.pyruns1.2 KB
- fastapi-saas/backend/app/core/__init__.pyruns0 B
- fastapi-saas/backend/app/core/security.pyruns921 B
- fastapi-saas/backend/app/crud.pyruns2.4 KB
- fastapi-saas/backend/app/email-templates/src/new_account.mjml1.3 KB
- fastapi-saas/backend/app/email-templates/src/reset_password.mjml1.9 KB
- fastapi-saas/backend/app/email-templates/src/test_email.mjml623 B
- fastapi-saas/backend/app/initial_data.pyruns402 B
- fastapi-saas/backend/app/__init__.pyruns0 B
- fastapi-saas/backend/app/main.pyruns923 B
- fastapi-saas/backend/app/models.pyruns3.4 KB
- fastapi-saas/backend/app/tests_pre_start.pyruns917 B
- fastapi-saas/backend/app/utils.pyruns3.8 KB
- fastapi-saas/backend/Dockerfile1.4 KB
- fastapi-saas/backend/.dockerignore76 B
- fastapi-saas/backend/.gitignore74 B
- fastapi-saas/backend/pyproject.toml1.9 KB
- fastapi-saas/backend/README.md7.5 KB
250 more files not listed here. See all 290 in the repository.
Gives 0 of the 12 instructions most containers cloud skills give in ~1.7k tokens
Counted across 607 of the 705 authors here whose files we hold, read 2026-09-06
- Run as non-root userin 34 of 607, across 27 files
- Use multi-stage buildsin 29 of 607
- Set resource requests and limitsin 24 of 607, across 20 files
- Configure liveness and readiness probesin 18 of 607, across 14 files
- Use named volumes for persistent datain 14 of 607, across 9 files
- Pin base image versionsin 14 of 607
- Set up environment variablesin 14 of 607, across 10 files
- Pin provider versionsin 14 of 607
- Apply least privilege RBAC permissionsin 10 of 607, across 7 files
- Create a dockerignore filein 10 of 607
- Use remote state with lockingin 9 of 607
- Pin base images by digestin 9 of 607, across 8 files
Said here and by no other author read
- Start with scope references to pick the correct path
- Default to the smallest quickstart-shaped artifact
- Fetch only the language quickstart you need
- Use verification references before finishing
- Prefer the Hookdeck Console for throwaway HTTPS URLs
Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.