never-ask-twice: Skill for Claude Code

Railway configuration skill

Use this skill when editing this repository's Railway configuration.

The source of desired Railway project state is:

.railway/railway.ts

Core rules

1. Express Railway product intent, not internal API details.
2. Do not write Railway UUIDs into .railway/railway.ts.
3. Do not write EnvironmentConfigPatch, ServiceInstance, Backboard internals, or generated Railway domains into source.
4. Prefer Railway configuration helpers like service(), postgres(), redis(), mysql(), mongo(), bucket(), group(), github(), and image().
5. Use service.env.VARIABLE and database.env.VARIABLE for references.
6. Keep secrets out of source. Imported unknown secret values should use preserve() or be omitted when the user wants a smaller import.
7. Prefer product DSL names such as domains, replicas, and group; avoid internal names like customDomains and multiRegionConfig.
8. Do not add platform defaults unless the user explicitly wants them.
9. Do not manage a service from both .railway/railway.ts and railway.json / railway.toml; migrate the repo config first.
10. After editing .railway/railway.ts, run railway config plan.
11. Do not run railway config apply unless the user explicitly asks.
12. Never use railway config apply --yes or railway config apply --confirm-destructive from an agent session without explicit user approval for the exact plan.

Commands

Initialize configuration files:

railway config init

Import current Railway state:

railway config pull

Import current Railway state with a smaller generated file that omits unknown variable values:

railway config pull --omit-preserved-variables

Preview changes:

railway config plan

Apply changes:

railway config apply

Machine-readable preview:

railway config plan --json

Authoring

Use Railway configuration helpers:

import {
  bucket,
  defineRailway,
  github,
  group,
  image,
  mongo,
  mysql,
  postgres,
  preserve,
  project,
  redis,
  service,
} from "railway/iac";