Skip to content
Back to search

railway-skills

MarketplaceWorks with Claude CodeGitHub

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/railwayapp-railway-skills/badge.svg)](/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.

  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "railway-skills",
  4. "description": "Railway agent skills and hosted MCP server for deploying, configuring, monitoring, and troubleshooting apps and infrastructure on Railway from Claude Code.",
  5. "owner": {
  6. "name": "Railway",
  7. "email": "contact@railway.com"
  8. },
  9. "plugins": [
  10. {
  11. "name": "railway",
  12. "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.",
  13. "author": {
  14. "name": "Railway"
  15. },
  16. "source": "./plugins/railway",
  17. "category": "deployment",
  18. "homepage": "https://docs.railway.com/agents"
  19. }
  20. ]
  21. }
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.

  1. # Railway Skills
  2. Agent skills for [Railway](https://railway.com), following the [Agent Skills](https://agentskills.io) format.
  3. This repository also includes Railway plugin packaging for ChatGPT, OpenAI Codex,
  4. Claude Code, Grok Build, Cursor, and Google Antigravity. Each plugin package includes the
  5. `use-railway` Agent Skill and Railway's hosted MCP server. Railway is also
  6. available as a connector for Claude.
  7. ## Railway agent setup
  8. To install the Railway CLI and configure agent support, run:
  9. ```bash
  10. curl -fsSL agents.railway.com | sh
  11. ```
  12. This installs the Railway CLI and skills, configures the Railway MCP server for
  13. detected tools, and checks Railway authentication. If you are not authenticated,
  14. run:
  15. ```bash
  16. railway login
  17. ```
  18. If the Railway CLI is already installed, configure agent support directly:
  19. ```bash
  20. railway setup agent
  21. ```
  22. ## Installing Railway integrations
  23. ### ChatGPT and OpenAI Codex
  24. Install the official [Railway plugin for ChatGPT and
  25. Codex](https://chatgpt.com/plugins/plugin_asdk_app_6a502589384081919c5decf93496c9d1)
  26. from the shared plugin directory. The plugin includes the `use-railway` skill
  27. and Railway's hosted MCP server. Connect your Railway account when prompted,
  28. then start a new chat or task to use the plugin.
  29. To install the version published by this repository directly, add this GitHub
  30. repository as a Codex marketplace:
  31. 1. Open Codex.
  32. 2. Select **Plugins** in the sidebar.
  33. 3. Open the **More** dropdown.
  34. 4. Click **Add more**.
  35. 5. Enter [`railwayapp/railway-skills`](https://github.com/railwayapp/railway-skills) as the marketplace source.
  36. - Plugin manifest: [`plugins/railway/.codex-plugin/plugin.json`](plugins/railway/.codex-plugin/plugin.json)
  37. - Marketplace: [`.agents/plugins/marketplace.json`](.agents/plugins/marketplace.json)
  38. ### Claude
  39. Add the official [Railway connector for
  40. Claude](https://claude.ai/directory/connectors/railway) from Claude's connector
  41. directory. The connector uses Railway's hosted MCP server and OAuth, so it
  42. doesn't require the Railway CLI.
  43. For terminal-based workflows with Railway's agent skill and hooks, install the
  44. Claude Code plugin.
  45. ### Claude Code
  46. The official Anthropic marketplace is available in Claude Code by default.
  47. Install Railway and reload plugins:
  48. ```text
  49. /plugin install railway@claude-plugins-official
  50. /reload-plugins
  51. ```
  52. You can also run `/plugin` and select the **Discover** tab to browse the
  53. official marketplace. If Claude Code can't find Railway, refresh the marketplace
  54. and retry the installation:
  55. ```text
  56. /plugin marketplace update claude-plugins-official
  57. ```
  58. The official marketplace pins each plugin to a specific commit. Changes in this
  59. repository become available through `claude-plugins-official` after the Railway
  60. entry in `anthropics/claude-plugins-official` is updated to a commit that
  61. contains them.
  62. To install the version published by this repository's Claude Code marketplace,
  63. add the marketplace and install the `railway` plugin from it:
  64. ```text
  65. /plugin marketplace add railwayapp/railway-skills
  66. /plugin install railway@railway-skills
  67. /reload-plugins
  68. ```
  69. ### Cursor
  70. Install from the official [Cursor Marketplace](https://cursor.com/marketplace/railway):
  71. ```text
  72. /add-plugin railway
  73. ```
  74. To install the version published by this repository directly instead, add it
  75. as a plugin source from Cursor settings:
  76. 1. Open **Settings**.
  77. 2. Select **Plugins**.
  78. 3. Paste `https://github.com/railwayapp/railway-skills` in the **Search or Paste Link** input.
  79. 4. Click the Railway plugin.
  80. 5. Click **Add to Cursor**.
  81. - Plugin manifest: [`plugins/railway/.cursor-plugin/plugin.json`](plugins/railway/.cursor-plugin/plugin.json)
  82. - Marketplace: [`.cursor-plugin/marketplace.json`](.cursor-plugin/marketplace.json)
  83. ### Grok Build
  84. Railway is published in the [official xAI plugin
  85. marketplace](https://github.com/xai-org/plugin-marketplace). Install it from
  86. Grok's TUI:
  87. 1. Run `grok`.
  88. 2. Open the extensions modal with `/plugins`.
  89. 3. Go to the **Marketplace** tab.
  90. 4. Select `railway` from the marketplace.
  91. 5. Press `i` to install.
  92. The official marketplace entry resolves the nested plugin at `plugins/railway`
  93. from this repository and pins it to a specific commit.
  94. ### Google Antigravity
  95. Install the plugin from this repository:
  96. 1. Open Antigravity.
  97. 2. Click **Customizations** in the sidebar, then select **Plugins**.
  98. 3. Click **+ Install from URL**.
  99. 4. Enter `https://github.com/railwayapp/railway-skills`.
  100. 5. Connect your Railway account when prompted.
  101. - Plugin manifest: [`plugins/railway/.antigravity-plugin/plugin.json`](plugins/railway/.antigravity-plugin/plugin.json)
  102. - MCP config: [`plugins/railway/mcp_config.json`](plugins/railway/mcp_config.json)
  103. ## Skill surface
  104. This repo ships one installable skill:
  105. - [`use-railway`](plugins/railway/skills/use-railway/SKILL.md)
  106. `use-railway` is route-first. Intent routing is defined in `SKILL.md`, and execution details are split into action-oriented references.
  107. ## License
  108. MIT
plugins/railway/hooks/auto-approve-api.sh · Bundled script · 141 lines · 1 finding marked
  1. #!/bin/bash
  2. # Auto-approve railway-api.sh and railway CLI commands.
  3. #
  4. # An "allow" decision covers the WHOLE Bash command, so a prefix or substring
  5. # 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
  6. # both start with (or contain) a trusted token yet run something else. We only
  7. # approve when the command is a single simple invocation of the railway CLI or
  8. # the railway-api.sh helper. Anything that chains, substitutes, redirects, or
  9. # comments is left for the normal confirmation prompt — the safe direction.
  10. input=$(cat)
  11. tool_name=$(echo "$input" | jq -r '.tool_name // empty')
  12. command=$(echo "$input" | jq -r '.tool_input.command // empty')
  13. cwd=$(echo "$input" | jq -r '.cwd // empty')
  14. if [[ "$tool_name" != "Bash" ]]; then
  15. exit 0
  16. fi
  17. approve() {
  18. cat <<EOF
  19. {
  20. "hookSpecificOutput": {
  21. "hookEventName": "PreToolUse",
  22. "permissionDecision": "allow",
  23. "permissionDecisionReason": "$1"
  24. }
  25. }
  26. EOF
  27. exit 0
  28. }
  29. # Command substitution and expansion fire even inside double quotes, so check the
  30. # raw command for them before stripping anything. Legit GraphQL uses `$var`, not
  31. # `$(`, backticks, or `${`.
  32. case "$command" in
  33. *\$\(* | *\`* | *\$\{*) exit 0 ;;
  34. esac
  35. # Build the shell skeleton by dropping everything bash treats as literal data —
  36. # quoted spans and backslash-escaped characters — leaving only the characters
  37. # where bash's metacharacters actually operate. Tracking bash's quoting state
  38. # character by character is the whole point: `\"` is a literal to bash though it
  39. # looks like a delimiter, and a quote of one type inside a span of the other
  40. # closes nothing, so any reading that disagrees with bash on where a quoted span
  41. # begins and ends will hide a top-level `;` behind what it mistakes for data.
  42. skeleton=""
  43. state=unquoted
  44. i=0
  45. len=${#command}
  46. while ((i < len)); do
  47. char=${command:i:1}
  48. case "$state" in
  49. unquoted)
  50. case "$char" in
  51. \\)
  52. # Escapes whatever follows, so that character is data rather than
  53. # structure — and `\<newline>` is a line continuation. A backslash with
  54. # nothing after it doesn't parse; don't approve what we can't read.
  55. ((i + 1 < len)) || exit 0
  56. ((i++))
  57. ;;
  58. "'") state=single ;;
  59. '"') state=double ;;
  60. *) skeleton+="$char" ;;
  61. esac
  62. ;;
  63. single)
  64. # Backslash is not special inside single quotes: the span ends at the next `'`.
  65. [[ "$char" == "'" ]] && state=unquoted
  66. ;;
  67. double)
  68. case "$char" in
  69. \\)
  70. ((i + 1 < len)) || exit 0
  71. ((i++))
  72. ;;
  73. '"') state=unquoted ;;
  74. esac
  75. ;;
  76. esac
  77. ((i++))
  78. done
  79. # An unterminated quote means the command does not parse the way we just read it.
  80. [[ "$state" == unquoted ]] || exit 0
  81. # On the skeleton every remaining metacharacter is top-level: command chaining
  82. # (`;` `|` `&`), redirection or heredoc (`<` `>`), comments (`#`), grouping or
  83. # subshells (`(` `)` `{` `}`), or a newline joining two commands. Any of them
  84. # means more than one simple command.
  85. case "$skeleton" in
  86. *';'* | *'|'* | *'&'* | *'<'* | *'>'* | *'#'* | *'('* | *')'* | *'{'* | *'}'* | *$'\n'*) exit 0 ;;
  87. esac
  88. # Drop the optional skill telemetry env prefixes to reach the executable itself.
  89. env_assignment="^[[:space:]]*(RAILWAY_CALLER|RAILWAY_AGENT_SESSION|RAILWAY_SKILL_VERSION)=[^[:space:]]+[[:space:]]+(.*)$"
  90. remainder=$skeleton
  91. while [[ "$remainder" =~ $env_assignment ]]; do
  92. remainder=${BASH_REMATCH[2]}
  93. done
  94. remainder=${remainder#"${remainder%%[![:space:]]*}"}
  95. executable=${remainder%%[[:space:]]*}
  96. # Resolve a path the way the command would, so the comparison below is about the
  97. # file that will run rather than the spelling used to reach it. Symlinks and `..`
  98. # in the directory part collapse; a directory that doesn't exist fails outright.
  99. canonical_path() {
  100. local path=$1 dir
  101. if [[ "$path" != /* ]]; then
  102. [[ -n "$cwd" ]] || return 1
  103. path="$cwd/$path"
  104. fi
  105. dir=$(cd "$(dirname "$path")" 2>/dev/null && pwd -P) || return 1
  106. printf '%s/%s' "$dir" "$(basename "$path")"
  107. }
  108. # The helper this hook vouches for is the one shipped beside it, so locate it
  109. # from the hook's own path rather than trusting the name in the command. A file
  110. # is only that helper if it resolves to the same path; the name alone says
  111. # nothing about which file it is, and anything a repo or temp directory can
  112. # supply is not this plugin's script.
  113. if [[ "$executable" == *railway-api.sh ]]; then
  114. hook_dir=$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd -P) || exit 0
  115. helper=$(canonical_path "$hook_dir/../skills/use-railway/scripts/railway-api.sh") || exit 0
  116. [[ -f "$helper" ]] || exit 0
  117. invoked=$(canonical_path "$executable") || exit 0
  118. if [[ "$invoked" == "$helper" ]]; then
  119. approve "Railway API call auto-approved"
  120. fi
  121. exit 0
  122. fi
  123. # The railway CLI is resolved from PATH by name, so require exactly that name —
  124. # a path-qualified `railway` is some other file and gets the normal prompt.
  125. if [[ "$executable" == "railway" ]]; then
  126. approve "Railway CLI command auto-approved"
  127. fi
  128. exit 0

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.