setup-and-ops

An operations guide for setting up, running, maintaining, and deploying a codebase that uses Node, PostgreSQL, Redis, and Heroku.

In plain words
What is it for?
Use it to start servers, manage Redis, back up or restore the database, run migrations, compile translations or email templates, and deploy to Heroku.
Why use it?
It collects the project-specific commands and procedures needed for local development, database operations, services, and deployment.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/hackbyrd/orbital-express/setup-and-ops
Any agent
npx skills add Hackbyrd/orbital-express --skill setup-and-ops
Clone the repo
git clone --depth 1 https://github.com/Hackbyrd/orbital-express

Made for: Claude Code, Codex.

Per session 68 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,405 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00068 $0.01405
Opus 5 $0.00034 $0.00702
Sonnet 5 $0.00014 $0.00281
Haiku 4.5 $0.00007 $0.00140

Measured 3d ago against content hash eb3e0ccbe080, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade B, and why

setup-and-ops scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Asks for rootmediumPrivilege escalation

A mod that escalates privileges can change anything on the machine, not only the project.

- Mac: `brew install redis`. Windows: install via WSL2 (`sudo apt-get install redis-server`). Linux: `sudo apt-get install redis-server`.
.claude/skills/setup-and-ops/SKILL.md · 58 lines

How it starts

The opening of the file, as written. The whole thing — 58 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Setup & operations

Operational reference for running and deploying the app. (For building features, use the build skills.) Read README "Before You Begin", "The Entry Points", "Config Folder", "Database Folder", "Deploying to Heroku". Full command cheat sheet, health probes, ngrok details, and troubleshooting table: docs/reference/operations.md.

Prerequisites

  • Node v22.x, Yarn. PostgreSQL running locally. Redis installed on the machine (see below). Both Postgres + Redis are required for the app and the test suite.

Redis (installed on your machine)

Redis is installed system-wide — there is no project-local redis/ folder anymore (older versions built Redis inside the repo; that approach is deprecated — delete any leftover redis/ folder).

  • Mac: brew install redis. Windows: install via WSL2 (sudo apt-get install redis-server). Linux: sudo apt-get install redis-server.
  • Manage the service via yarn (wraps brew services): yarn redis / yarn redis:start (start), yarn redis:restart, yarn redis:stop, yarn redis:status, yarn redis:logs, yarn redis:info, yarn redis:edit, yarn redis:cleanup, yarn redis:reset. Full steps: docs/redis.txt.

Local dev only. The locally installed Redis is just for your machine. Production uses a managed Redis add-on (Heroku Redis / Redis Cloud) reached via the REDIS_URL config var.

First-time setup

  1. yarn install — installs deps and runs postinstallyarn lang (compiles locales/). Pin exact versions when adding deps: yarn add <pkg> --exact.
  2. Create env files in config/ from the template: copy .env.template.env.development, .env.test (and .env.production/.env.staging only if connecting to prod locally). These are gitignored. Every new env var → also add it to .env.template (committed).
    • Required for auth: ACCESS_TOKEN_SECRET, REFRESH_TOKEN_SECRET (distinct), ACCESS_TOKEN_EXPIRES_IN=15m, REFRESH_TOKEN_EXPIRES_IN=60d — in every env file incl. .env.test.
  3. Create the dev DB, run migrations: yarn migrate. Optionally yarn seed for dev seed data.

Read the full file on GitHub · 58 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 58 lines · 68 tokens per session scan B eb3e0ccbe080

Subscribe to this mod's changes

setup-and-ops is a skill published in the GitHub repository Hackbyrd/orbital-express (14 stars, last pushed 14d ago), licensed MIT. It adds 68 tokens to every session and 1,405 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it B with 1 finding (asks for root). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

database-patterns

Use when designing PostgreSQL + Redis data models, indexes, caching strategies, JSONB usage, tiered storage, or cache consistency contracts.

majiayu000/spellbook · 32 tokens

edge-serverless-db-expert

Expert guide for Serverless & Edge Databases (Neon Serverless Postgres, Cloudflare D1, Turso/libsql, Upstash Redis), cold-start mitigation, and connection pooling / Panduan ahli database Serverless & Edge (Neon, Cloudflare D1, Turso, Upstash).

roedyrustam/vibes-plug · 69 tokens

developing-serverpod-backend

Develops full-stack Dart backends using the Serverpod framework with PostgreSQL, Redis, and Docker. Use when building type-safe API endpoints, defining YAML data models, configuring Serverpod auth, writing server-side tests, running database migrations, deploying to Docker/AWS/GCP, or using Serverpod Mini for…

Poorgramer-Zack/dart-expert-skills · 76 tokens

database

Manage PostgreSQL, SQLite, and Redis databases: create, migrate, backup, restore, query, optimize.

JansenAnalytics/claudex · 24 tokens

database

Database standards for PostgreSQL persistence and Redis caching. Use when designing schemas, writing migrations, optimizing queries, configuring Redis, or implementing cache invalidation.

ndisisnd/cook · 32 tokens

backend-developer

Expert backend developer skill for Fastify, tRPC, Prisma, PostgreSQL, Redis, and BullMQ. Use when building API routes, services, middleware, database queries, background jobs, authentication flows, or integrations.

mtnyilmaz/agents · 48 tokens