Agent skill · Railway
Use Railway skill for Claude Code, Codex and Cursor
Officialname: use-railway★ 335 (repo)pushed 2026-10-15MITSKILL.md on GitHubchecked 2026-11-07
What it does, in the publisher's words
Operate Railway infrastructure: sign up for or sign in to a Railway account, create projects, provision services, databases, and buckets, deploy code, configure infrastructure as code, environments and variables, manage domains, trace requests with OpenTelemetry, troubleshoot failures, check status and metrics, manage feature flags, database recovery and HA, cloud agents, usage limits, and Railway agent tooling.
The description field of the SKILL.md. The agent reads only this at startup and decides from it when to load the full skill.
Install Use Railway
The skills CLI copies the skill into the folder of each agent you pick (Claude Code, Codex, Cursor, Copilot, Gemini CLI, OpenCode, Windsurf...). Add -g for all projects. Needs Node.js 22.20+. docs
npx skills add railwayapp/railway-skills --skill use-railway
This repo is a plugin marketplace. Inside Claude Code, add it and install the plugin that holds the skill (railway), or copy only this skill into ~/.claude/skills. docs
/plugin marketplace add railwayapp/railway-skills /plugin install <plugin>@railway-skills # or only this skill: npx skills add railwayapp/railway-skills --skill use-railway -a claude-code
Download the skill folder, zip it, then Customize > Skills > + > Create skill > Upload a skill. Code execution must be on (Settings > Capabilities). docs
git clone --depth 1 https://github.com/railwayapp/railway-skills.git /tmp/use-railway-src cp -r /tmp/use-railway-src/plugins/railway/skills/use-railway ./use-railway zip -r use-railway.zip use-railway
Codex reads skills from .agents/skills in the repo or ~/.agents/skills. Type $ in Codex to use one. docs
npx skills add railwayapp/railway-skills --skill use-railway -a codex
gh skill (GitHub CLI 2.90+, preview) installs it for Copilot in VS Code, the CLI and the cloud agent. Copilot also reads .github/skills and ~/.copilot/skills. docs
gh skill install railwayapp/railway-skills use-railway
Cursor reads .cursor/skills, .agents/skills and ~/.cursor/skills (and .claude/skills). It does not install loose skills from a GitHub URL, so copy it in. docs
npx skills add railwayapp/railway-skills --skill use-railway -a cursor
Installs from the GitHub repo; --path picks this skill out of the repo. Default scope is user (all projects). docs
gemini skills install https://github.com/railwayapp/railway-skills.git --path plugins/railway/skills/use-railway
OpenCode reads .opencode/skills, ~/.config/opencode/skills and the Claude and .agents folders. docs
npx skills add railwayapp/railway-skills --skill use-railway -a opencode
Windsurf (now Devin Desktop) reads .devin/skills, .windsurf/skills and ~/.codeium/windsurf/skills. docs
npx skills add railwayapp/railway-skills --skill use-railway -a windsurf
Works with
Claude Code, Claude.ai and Claude Desktop, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Windsurf and other agents that read the open Agent Skills format.
- Pre-approves these tools (allowed-tools, experimental in the spec): Bash(railway:*), Bash(which:*), Bash(command:*), Bash(npm:*), Bash(npx:*), Bash(curl:*), Bash(python3:*).
- Bundles 8 Python/shell scripts the agent can run, so it needs Python on the machine. In the Claude apps, code execution must be on.
What's in the SKILL.md
- Railway resource model
- Tool routing
- Parsing Railway URLs
- Intent-based routing
- Preflight
- Skill freshness
- Account creation & sign-in
- Agent tooling
- Common quick operations
- Routing
- Execution rules
- User-only commands (NEVER execute directly)
- Composition patterns
- Setup decision flow
- Response format
Bundled files
- references/analyze-db-mongo.md
- references/analyze-db-mysql.md
- references/analyze-db-postgres.md
- references/analyze-db-redis.md
- references/analyze-db.md
- references/cloud-agents.md
- references/configure.md
- references/databases.md
- references/deploy.md
- references/feature-flags.md
- references/iac.md
- references/operate.md
- references/request.md
- references/sandbox.md
- references/setup.md
- references/tracing.md
- references/usage.md
- scripts/analyze-mongo.py
- scripts/analyze-mysql.py
- scripts/analyze-postgres.py
- + 5 more
Loaded only when the instructions point to them.
Facts
- Skill name
- use-railway
- Publisher
- Railway (official)
- Repo
- railwayapp/railway-skills
- License
- MIT
- SKILL.md size
- 4,199 words, 356 lines
- Bundled files
- 25, 8 scripts (Python, shell), 17 docs
- Repo stars
- 335 (as of 2026-10-24)
- SKILL.md checked
- 2026-11-07
Pairs with the Railway MCP server: the server gives the agent the tools, the skill teaches it how to use them.
Related cloud & devops skills
- Deploy to Vercel · Vercel
- GitHub: Fix CI · OpenAI
- gcloud CLI · Google
- Cloudflare Platform · Cloudflare
- Next.js on Cloudflare · Cloudflare
- Workers Best Practices · Cloudflare
- Wrangler CLI · Cloudflare
- Azure Deploy · Microsoft (Azure)
FAQ
What does the use-railway skill do?+
Creates Railway projects, services and databases, deploys code and manages variables and domains. In its own SKILL.md, Railway describes it as: "Operate Railway infrastructure: sign up for or sign in to a Railway account, create projects, provision services, databases, and buckets, deploy code, configure infrastructure as code, environments and variables, manage domains, trace requests with OpenTelemetry, troubleshoot failures, check status..."
How do I install the use-railway skill?+
Run npx skills add railwayapp/railway-skills --skill use-railway and pick your agents, or use the tab for your agent above. In Claude Code the skill ends up in ~/.claude/skills/use-railway/SKILL.md; in Codex and Cursor in .agents/skills/use-railway/.
Does Use Railway work in Codex, Cursor and Copilot, or only Claude?+
It's a standard SKILL.md, so any agent that reads the Agent Skills format can use it: Claude Code, the Claude apps, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Windsurf and more.
Who maintains Use Railway?+
Railway, the company or project behind it, in the railwayapp/railway-skills repo on GitHub, last pushed 2026-10-15. License: MIT.
Read a skill's SKILL.md and scripts before you install it: skills aren't verified by any agent vendor. Claude skills marketplace · How to install skills · MCP servers