Outpost

Skill hookdeck/agent-skills/skills/outpost

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

Install

npx -y skills add hookdeck/agent-skills --skill outpost

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing 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.

What its author says it does

Copied from the file, not written here

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.

SKILL.md

7.1 KB, 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 .md URLs; 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)