# railway

This skill guides Railway deployments, database setup, and service configuration. Use it when a project needs container deployment or several connected services.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 301 repo stars
- Author: hoodini
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hoodini/ai-agents-skills/tree/HEAD/skills/railway/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/railway

## What it does

The skill covers Railway CLI workflows and project configuration for builds, startup commands, environment variables, health checks, and cron schedules. It outlines settings for both Dockerfile and Nixpacks builds. Deploying with the CLI requires `@railway/cli` to be installed and a Railway login.

It also explains how to attach PostgreSQL, Redis, or MySQL, connect services through internal DNS names, and mount persistent volumes. Separate project components can be deployed from directories such as `api`, `worker`, and `frontend`. Set values such as `DATABASE_URL` and `API_KEY` for the services that need them; a missing or incorrect value can leave an app unable to reach its database or API.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add hoodini/ai-agents-skills --skill railway -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/railway/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/railway/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add hoodini/ai-agents-skills --skill railway -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/railway/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add hoodini/ai-agents-skills --skill railway -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/railway/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install hoodini/ai-agents-skills skills/railway
```

2. **Manually: put the files in place**
- File: `.github/skills/railway/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add hoodini/ai-agents-skills --skill railway -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/hoodini/ai-agents-skills --path skills/railway
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/railway/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/hoodini/ai-agents-skills/tree/HEAD/skills/railway/SKILL.md

## When to use it
- deploy an application with Railway CLI
- configure build and startup commands in `railway.toml`
- attach PostgreSQL, Redis, or MySQL to a service
- connect services over Railway private networking
- set a health check or cron schedule

## Example prompts
- Set up this app for deployment on Railway and prepare a suitable `railway.toml`.
- Configure a Railway PostgreSQL connection and set `DATABASE_URL` for the app.
- Plan separate Railway deployments for `api`, `worker`, and `frontend`.

## Similar
- [use-railway](https://affpapa.org/en/nevibecode/skills/use-railway.md) — skill · 1200 installs
- [railway-docs](https://affpapa.org/en/nevibecode/skills/railway-docs.md) — skill · 74 installs
- [service-architecture](https://affpapa.org/en/nevibecode/rules/service-architecture.md) — rule · ★ 1216 repo stars
- [infisical-self-host](https://affpapa.org/en/nevibecode/skills/infisical-self-host.md) — skill · 834 installs
- [docker-compose-production](https://affpapa.org/en/nevibecode/skills/docker-compose-production.md) — skill · 487 installs
- [GitLab Stack Config Generator](https://affpapa.org/en/nevibecode/skills/gitlab-stack-config-generator.md) — skill · 303 installs

From the same set: [hoodini/ai-agents-skills](https://affpapa.org/en/nevibecode/by/hoodini/ai-agents-skills.md) — 34 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
