Railway Skills

Agent skills for Railway, following the Agent Skills format.

This repository also includes Railway plugin packaging for ChatGPT, OpenAI Codex,
Claude Code, Grok Build, and Cursor. Each plugin package includes the
use-railway Agent Skill and Railway's hosted MCP server. Railway is also
available as a connector for Claude.

Railway agent setup

To install the Railway CLI and configure agent support, run:

curl -fsSL agents.railway.com | sh

This installs the Railway CLI and skills, configures the Railway MCP server for
detected tools, and checks Railway authentication. If you are not authenticated,
run:

railway login

If the Railway CLI is already installed, configure agent support directly:

railway setup agent

Installing Railway integrations

ChatGPT and OpenAI Codex

Install the official Railway plugin for ChatGPT and
Codex
from the shared plugin directory. The plugin includes the use-railway skill
and Railway's hosted MCP server. Connect your Railway account when prompted,
then start a new chat or task to use the plugin.

To install the version published by this repository directly, add this GitHub
repository as a Codex marketplace:

1. Open Codex.
2. Select Plugins in the sidebar.
3. Open the More dropdown.
4. Click Add more.
5. Enter railwayapp/railway-skills as the marketplace source.

• Plugin manifest: plugins/railway/.codex-plugin/plugin.json
• Marketplace: .agents/plugins/marketplace.json

Claude

Add the official Railway connector for
Claude from Claude's connector
directory. The connector uses Railway's hosted MCP server and OAuth, so it
doesn't require the Railway CLI.

For terminal-based workflows with Railway's agent skill and hooks, install the
Claude Code plugin.

Claude Code

The official Anthropic marketplace is available in Claude Code by default.
Install Railway and reload plugins:

/plugin install railway@claude-plugins-official
/reload-plugins

You can also run /plugin and select the Discover tab to browse the
official marketplace. If Claude Code can't find Railway, refresh the marketplace
and retry the installation:

/plugin marketplace update claude-plugins-official

The official marketplace pins each plugin to a specific commit. Changes in this
repository become available through claude-plugins-official after the Railway
entry in anthropics/claude-plugins-official is updated to a commit that
contains them.

To install the version published by this repository's Claude Code marketplace,
add the marketplace and install the railway plugin from it:

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

Cursor

Install from the official Cursor Marketplace:

/add-plugin railway

To install the version published by this repository directly instead, add it
as a plugin source from Cursor settings:

1. Open Settings.
2. Select Plugins.
3. Paste https://github.com/railwayapp/railway-skills in the Search or Paste Link input.
4. Click the Railway plugin.
5. Click Add to Cursor.

• Plugin manifest: plugins/railway/.cursor-plugin/plugin.json
• Marketplace: .cursor-plugin/marketplace.json

Grok Build

Railway is published in the official xAI plugin
marketplace. Install it from
Grok's TUI:

1. Run grok.
2. Open the extensions modal with /plugins.
3. Go to the Marketplace tab.
4. Select railway from the marketplace.
5. Press i to install.

The official marketplace entry resolves the nested plugin at plugins/railway
from this repository and pins it to a specific commit.

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.

License

MIT

{
  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  "name": "railway-skills",
  "description": "Railway agent skills and hosted MCP server for deploying, configuring, monitoring, and troubleshooting apps and infrastructure on Railway from Claude Code.",
  "owner": {
    "name": "Railway",
    "email": "contact@railway.com"
  },
  "plugins": [
    {
      "name": "railway",
      "description": "Railway agent skills and hosted MCP server for deploying, configuring, monitoring, and troubleshooting apps and infrastructure on Railway from Claude Code. Manage services, environments, deployments, databases, object storage, networking, and observability.",
      "author": {
        "name": "Railway"
      },
      "source": "./plugins/railway",
      "category": "deployment",
      "homepage": "https://docs.railway.com/agents"
    }
  ]
}