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	deployment
Description	This skill should be used when the user wants to manage Railway deployments, view logs, or debug issues. Covers deployment lifecycle (remove, stop, redeploy, restart), deployment visibility (list, status, history), and troubleshooting (logs, errors, failures, crashes, why deploy failed). NOT for deleting services - use environment skill with isDeleted for that.

deployment

SKILL.md