railway — Claude Code skill for Railway deployment
This skill guides Railway deployments, database setup, and service configuration. Use it when a project needs container deployment or several connected services.
no license ★ 301 updated 2026-10-23
npx skills add hoodini/ai-agents-skills --skill railway -a claude-codeWhat railway 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.
What it helps with
- 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 for the agent
- Set up this app for deployment on Railway and prepare a suitable
railway.toml. - Configure a Railway PostgreSQL connection and set
DATABASE_URLfor the app. - Plan separate Railway deployments for
api,worker, andfrontend.
How to install railway
1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill railway -a claude-code2Manually: put the files in place
~/.claude/skills/railway/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/railway/
1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill railway -a codex2Manually: put the files in place
.agents/skills/railway/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill railway -a cursor2Manually: put the files in place
.cursor/skills/railway/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install hoodini/ai-agents-skills skills/railway2Manually: put the files in place
.github/skills/railway/SKILL.md1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill railway -a gemini-cli2Platform CLI
gemini skills install https://github.com/hoodini/ai-agents-skills --path skills/railwayManually: put the files in place
.devin/skills/railway/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about railway
How do I install railway in Claude Code?
Run npx skills add hoodini/ai-agents-skills --skill railway -a claude-code. The skill file is located at ~/.claude/skills/railway/SKILL.md.
What does the railway skill do?
It guides Railway deployment setup, environment variables, database services, private networking, persistent volumes, and cron jobs.
What is needed to deploy with Railway CLI?
The instructions use @railway/cli and railway login before project initialization and deployment with railway init and railway up.