Railway Skills

Agent skills for Railway, following the Agent Skills open format.

Installation

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

You can also install via skills.sh

npx skills add railwayapp/railway-skills 

This will allow you to pick and choose which skills to install.

Supports Claude Code, OpenAI Codex, OpenCode, and Cursor. Re-run to update.

Manual Installation

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

Update with:

claude plugin marketplace update
claude plugin update railway@railway-skills

Copy plugins/railway/skills/ to your agent's skills directory:

• Claude: ~/.claude/skills/
• Codex: ~/.codex/skills/
• OpenCode: ~/.config/opencode/skill/
• Cursor: ~/.cursor/skills/

Available Skills

| Skill | Description | |-------|-------------| | status | Check Railway project status | | projects | List, switch, and configure projects | | new | Create projects, services, databases | | service | Manage existing services | | deploy | Deploy local code | | domain | Manage service domains | | environment | Manage config (vars, commands, replicas) | | deployment | Manage deployments (list, logs, redeploy, remove) | | database | Add Railway databases | | templates | Deploy from marketplace | | metrics | Query resource usage | | railway-docs | Fetch up-to-date Railway documentation |

Hooks

This plugin includes a PreToolUse hook that auto-approves railway-api.sh calls to avoid permission prompts on every GraphQL API request.

Repository Structure

railway-skills/
├── plugins/railway/
│   ├── .claude-plugin/
│   │   └── plugin.json
│   ├── hooks/
│   └── skills/
│       ├── _shared/           # Canonical shared files
│       │   ├── scripts/
│       │   └── references/
│       └── {skill-name}/
│           ├── SKILL.md
│           ├── scripts/       # Copied from _shared
│           └── references/    # Copied from _shared
├── scripts/
│   ├── install.sh             # Universal installer
│   └── sync-shared.sh         # Sync shared files
└── README.md

Creating New Skills

Create plugins/railway/skills/{name}/SKILL.md:

---
name: my-skill
description: What this skill does and when to use it
---

# Instructions

Step-by-step guidance for the agent.

## Examples

Concrete examples showing expected input/output.

Development

Shared Files

Scripts (railway-api.sh) and references (variables.md, etc.) are shared across skills. Canonical versions live in plugins/railway/skills/_shared/.

After editing files in _shared/, run:

./scripts/sync-shared.sh

This copies shared files to each skill. Do not edit copies in individual skills directly.

References

• Agent Skills Specification
• Railway Docs

License

MIT