Railway Skills

Agent skill for Railway, following the Agent Skills format.

Installation

curl -fsSL railway.com/skills.sh | bash

You can also install via skills.sh:

npx skills add railwayapp/railway-skills

Supports Claude Code, OpenAI Codex, OpenCode, and Cursor. Run the installer again to update.

Claude Code plugin marketplace

/plugin marketplace add railwayapp/railway-skills
/plugin install railway@railway-skills

Skill surface

This repo ships one installable skill:

use-railway

use-railway is route-first. Intent routing is defined in SKILL.md, and execution details are split into action-oriented references.

Workflow coverage

use-railway covers:

Project and service setup
Deploy and release operations
Troubleshooting and recovery
Environment config and variables
Networking and domains
Status and observability
Projects and workspaces
Docs and community search

Repository structure

railway-skills/
├── plugins/railway/
│   ├── .claude-plugin/
│   │   └── plugin.json
│   ├── hooks/
│   └── skills/
│       └── use-railway/
│           ├── SKILL.md
│           ├── scripts/
│           │   └── railway-api.sh
│           └── references/
│               ├── setup.md
│               ├── deploy.md
│               ├── configure.md
│               ├── operate.md
│               └── request.md
├── scripts/
│   └── install.sh
├── AGENTS.md
├── CLAUDE.md -> AGENTS.md
└── rfc.md

Development notes

Keep SKILL.md concise and routing-focused.
Keep workflow behavior in action-oriented references.
Keep deep schema and reference material separate from runbooks.
Prefer canonical CLI syntax in examples.
Keep API requests in scripts/railway-api.sh for consistent auth handling.

References

License

MIT

Name	new
Description	This skill should be used when the user says "setup", "deploy to railway", "initialize", "create project", "create service", or wants to deploy from GitHub. Handles initial setup AND adding services to existing projects. For databases, use the database skill instead.

new

SKILL.md