Agent skill
Station ships with a Claude Code skill that teaches the AI assistant how to build with every Station package. Once installed, Claude knows how to create signals, broadcasts, adapters, runners, subscribers, and dashboard configs without you having to explain the API.
What is a skill?
A Claude Code skill is a set of markdown files that get injected into Claude’s context when relevant. Skills contain API references, code patterns, and rules that guide the assistant’s output. The Station skill covers all seven packages and the REST API.
Install
npx skills add porkytheblack/stationThe skill directory contains three files:
| File | Description |
|---|---|
SKILL.md | Main skill file. Contains critical rules, code patterns, builder method tables, subscriber events, and design principles. This is what Claude reads first. |
api-reference.md | Exhaustive API reference for all seven packages: station-signal, station-broadcast, station-adapter-sqlite, station-adapter-postgres, station-adapter-mysql, station-adapter-redis, and station-kit. Also covers the Station v1 REST API. |
examples.md | Seventeen complete, copy-pasteable examples covering basic signals, multi-step pipelines, recurring jobs, broadcasts, remote triggers, all four adapter backends, and a full project structure template. |
Usage
Once installed, the skill activates automatically when you ask Claude about Station topics. You can also invoke it explicitly:
/stationExample prompts that trigger the skill:
- “Create a signal that sends welcome emails with retry”
- “Set up a broadcast DAG for my CI pipeline”
- “Configure PostgreSQL adapters for signals and broadcasts”
- “Add a runner with SQLite persistence and graceful shutdown”
- “Write a subscriber that posts failures to Slack”
What the skill knows
| Topic | Coverage |
|---|---|
| Signals | Builder chain (.input(), .output(), .timeout(), .retries(), .every(), .onComplete(), .run()), multi-step pipelines (.step() + .build()), triggering, validation |
| Broadcasts | DAG builder (.node(), .then()), conditional nodes (when), failure policies, input/output mapping, fan-out and fan-in patterns |
| Adapters | All four backends (SQLite, PostgreSQL, MySQL, Redis) for both signals and broadcasts. Constructor patterns, connection options, subpath imports |
| Runners | SignalRunner and BroadcastRunner setup, auto-discovery, manual registration, graceful shutdown, poll intervals |
| Subscribers | All lifecycle events for both signal and broadcast runners. Custom subscriber patterns for logging, metrics, and alerting |
| Remote triggers | configure({ endpoint, apiKey }), HttpTriggerAdapter, environment variables, Station REST API endpoints |
| Dashboard | station.config.ts options, CLI usage, auth configuration |
Updating
Re-run the install command to pull the latest version:
npx skills add porkytheblack/station