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 Code (plugin)

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

Local skills copy (any agent)

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