railway-skills
Railway agent skills and hosted MCP server for deploying, configuring, monitoring, and troubleshooting apps and infrastructure on Railway from Claude Code.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/railwayapp/railway-skills with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/railwayapp/railway-skills'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/railwayapp-railway-skills)HTML
<a href="/listings/railwayapp-railway-skills"><img src="/api/listings/railwayapp-railway-skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
ChatGPT and OpenAI Codex
Install the official [Railway plugin for ChatGPT and Codex](https://chatgpt.com/plugins/plugin_asdk_app_6a502589384081919c5decf93496c9d1) 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`](https://github.com/railwayapp/railway-skills) as the marketplace source.
- Plugin manifest: [`plugins/railway/.codex-plugin/plugin.json`](plugins/railway/.codex-plugin/plugin.json) - Marketplace: [`.agents/plugins/marketplace.json`](.agents/plugins/marketplace.json)
Claude
Add the official [Railway connector for Claude](https://claude.ai/directory/connectors/railway) 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](https://cursor.com/marketplace/railway):
/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`](plugins/railway/.cursor-plugin/plugin.json) - Marketplace: [`.cursor-plugin/marketplace.json`](.cursor-plugin/marketplace.json)
Grok Build
Railway is published in the [official xAI plugin marketplace](https://github.com/xai-org/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.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 21 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- {
- "$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"
- }
- ]
- }
README.md · README · 155 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # Railway Skills
- Agent skills for [Railway](https://railway.com), following the [Agent Skills](https://agentskills.io) format.
- This repository also includes Railway plugin packaging for ChatGPT, OpenAI Codex,
- Claude Code, Grok Build, Cursor, and Google Antigravity. 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:
- ```bash
- 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:
- ```bash
- railway login
- ```
- If the Railway CLI is already installed, configure agent support directly:
- ```bash
- railway setup agent
- ```
- ## Installing Railway integrations
- ### ChatGPT and OpenAI Codex
- Install the official [Railway plugin for ChatGPT and
- Codex](https://chatgpt.com/plugins/plugin_asdk_app_6a502589384081919c5decf93496c9d1)
- 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`](https://github.com/railwayapp/railway-skills) as the marketplace source.
- - Plugin manifest: [`plugins/railway/.codex-plugin/plugin.json`](plugins/railway/.codex-plugin/plugin.json)
- - Marketplace: [`.agents/plugins/marketplace.json`](.agents/plugins/marketplace.json)
- ### Claude
- Add the official [Railway connector for
- Claude](https://claude.ai/directory/connectors/railway) 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:
- ```text
- /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:
- ```text
- /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:
- ```text
- /plugin marketplace add railwayapp/railway-skills
- /plugin install railway@railway-skills
- /reload-plugins
- ```
- ### Cursor
- Install from the official [Cursor Marketplace](https://cursor.com/marketplace/railway):
- ```text
- /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`](plugins/railway/.cursor-plugin/plugin.json)
- - Marketplace: [`.cursor-plugin/marketplace.json`](.cursor-plugin/marketplace.json)
- ### Grok Build
- Railway is published in the [official xAI plugin
- marketplace](https://github.com/xai-org/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.
- ### Google Antigravity
- Install the plugin from this repository:
- 1. Open Antigravity.
- 2. Click **Customizations** in the sidebar, then select **Plugins**.
- 3. Click **+ Install from URL**.
- 4. Enter `https://github.com/railwayapp/railway-skills`.
- 5. Connect your Railway account when prompted.
- - Plugin manifest: [`plugins/railway/.antigravity-plugin/plugin.json`](plugins/railway/.antigravity-plugin/plugin.json)
- - MCP config: [`plugins/railway/mcp_config.json`](plugins/railway/mcp_config.json)
- ## Skill surface
- This repo ships one installable skill:
- - [`use-railway`](plugins/railway/skills/use-railway/SKILL.md)
- `use-railway` is route-first. Intent routing is defined in `SKILL.md`, and execution details are split into action-oriented references.
- ## License
- MIT
plugins/railway/hooks/auto-approve-api.sh · Bundled script · 141 lines · 1 finding marked
- #!/bin/bash
- # Auto-approve railway-api.sh and railway CLI commands.
- #
- # An "allow" decision covers the WHOLE Bash command, so a prefix or substring
- # match is not enough: `printf x # railway-api.sh` and `railway status; rm -rf ~`
- Note: Quoted as data in code: Runs `rm -rf` against a root or home-directory path
- Line 5 on GitHub
- # both start with (or contain) a trusted token yet run something else. We only
- # approve when the command is a single simple invocation of the railway CLI or
- # the railway-api.sh helper. Anything that chains, substitutes, redirects, or
- # comments is left for the normal confirmation prompt — the safe direction.
- input=$(cat)
- tool_name=$(echo "$input" | jq -r '.tool_name // empty')
- command=$(echo "$input" | jq -r '.tool_input.command // empty')
- cwd=$(echo "$input" | jq -r '.cwd // empty')
- if [[ "$tool_name" != "Bash" ]]; then
- exit 0
- fi
- approve() {
- cat <<EOF
- {
- "hookSpecificOutput": {
- "hookEventName": "PreToolUse",
- "permissionDecision": "allow",
- "permissionDecisionReason": "$1"
- }
- }
- EOF
- exit 0
- }
- # Command substitution and expansion fire even inside double quotes, so check the
- # raw command for them before stripping anything. Legit GraphQL uses `$var`, not
- # `$(`, backticks, or `${`.
- case "$command" in
- *\$\(* | *\`* | *\$\{*) exit 0 ;;
- esac
- # Build the shell skeleton by dropping everything bash treats as literal data —
- # quoted spans and backslash-escaped characters — leaving only the characters
- # where bash's metacharacters actually operate. Tracking bash's quoting state
- # character by character is the whole point: `\"` is a literal to bash though it
- # looks like a delimiter, and a quote of one type inside a span of the other
- # closes nothing, so any reading that disagrees with bash on where a quoted span
- # begins and ends will hide a top-level `;` behind what it mistakes for data.
- skeleton=""
- state=unquoted
- i=0
- len=${#command}
- while ((i < len)); do
- char=${command:i:1}
- case "$state" in
- unquoted)
- case "$char" in
- \\)
- # Escapes whatever follows, so that character is data rather than
- # structure — and `\<newline>` is a line continuation. A backslash with
- # nothing after it doesn't parse; don't approve what we can't read.
- ((i + 1 < len)) || exit 0
- ((i++))
- ;;
- "'") state=single ;;
- '"') state=double ;;
- *) skeleton+="$char" ;;
- esac
- ;;
- single)
- # Backslash is not special inside single quotes: the span ends at the next `'`.
- [[ "$char" == "'" ]] && state=unquoted
- ;;
- double)
- case "$char" in
- \\)
- ((i + 1 < len)) || exit 0
- ((i++))
- ;;
- '"') state=unquoted ;;
- esac
- ;;
- esac
- ((i++))
- done
- # An unterminated quote means the command does not parse the way we just read it.
- [[ "$state" == unquoted ]] || exit 0
- # On the skeleton every remaining metacharacter is top-level: command chaining
- # (`;` `|` `&`), redirection or heredoc (`<` `>`), comments (`#`), grouping or
- # subshells (`(` `)` `{` `}`), or a newline joining two commands. Any of them
- # means more than one simple command.
- case "$skeleton" in
- *';'* | *'|'* | *'&'* | *'<'* | *'>'* | *'#'* | *'('* | *')'* | *'{'* | *'}'* | *$'\n'*) exit 0 ;;
- esac
- # Drop the optional skill telemetry env prefixes to reach the executable itself.
- env_assignment="^[[:space:]]*(RAILWAY_CALLER|RAILWAY_AGENT_SESSION|RAILWAY_SKILL_VERSION)=[^[:space:]]+[[:space:]]+(.*)$"
- remainder=$skeleton
- while [[ "$remainder" =~ $env_assignment ]]; do
- remainder=${BASH_REMATCH[2]}
- done
- remainder=${remainder#"${remainder%%[![:space:]]*}"}
- executable=${remainder%%[[:space:]]*}
- # Resolve a path the way the command would, so the comparison below is about the
- # file that will run rather than the spelling used to reach it. Symlinks and `..`
- # in the directory part collapse; a directory that doesn't exist fails outright.
- canonical_path() {
- local path=$1 dir
- if [[ "$path" != /* ]]; then
- [[ -n "$cwd" ]] || return 1
- path="$cwd/$path"
- fi
- dir=$(cd "$(dirname "$path")" 2>/dev/null && pwd -P) || return 1
- printf '%s/%s' "$dir" "$(basename "$path")"
- }
- # The helper this hook vouches for is the one shipped beside it, so locate it
- # from the hook's own path rather than trusting the name in the command. A file
- # is only that helper if it resolves to the same path; the name alone says
- # nothing about which file it is, and anything a repo or temp directory can
- # supply is not this plugin's script.
- if [[ "$executable" == *railway-api.sh ]]; then
- hook_dir=$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd -P) || exit 0
- helper=$(canonical_path "$hook_dir/../skills/use-railway/scripts/railway-api.sh") || exit 0
- [[ -f "$helper" ]] || exit 0
- invoked=$(canonical_path "$executable") || exit 0
- if [[ "$invoked" == "$helper" ]]; then
- approve "Railway API call auto-approved"
- fi
- exit 0
- fi
- # The railway CLI is resolved from PATH by name, so require exactly that name —
- # a path-qualified `railway` is some other file and gets the normal prompt.
- if [[ "$executable" == "railway" ]]; then
- approve "Railway CLI command auto-approved"
- fi
- exit 0
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.