Agent skill

Railway API

by majiayu000 in majiayu000/claude-skill-registry

Railway.com GraphQL API automation for projects, services, deployments, and environment variables.

Install Railway API

skills CLI

$ npx skills add majiayu000/claude-skill-registry --skill railway-api -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install majiayu000/claude-skill-registry railway-api --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/majiayu000/claude-skill-registry.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/api/railway-api .claude/skills/railway-api && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "railway-api" agent skill from https://github.com/majiayu000/claude-skill-registry/tree/main/skills/api/railway-api into .claude/skills/railway-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "railway-api", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/majiayu000/claude-skill-registry/tree/main/skills/api/railway-api

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add majiayu000/claude-skill-registry --skill railway-api -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install majiayu000/claude-skill-registry railway-api --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/majiayu000/claude-skill-registry.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/api/railway-api .agents/skills/railway-api && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "railway-api" agent skill from https://github.com/majiayu000/claude-skill-registry/tree/main/skills/api/railway-api into .agents/skills/railway-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "railway-api", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add majiayu000/claude-skill-registry --skill railway-api -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install majiayu000/claude-skill-registry railway-api --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/majiayu000/claude-skill-registry.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/api/railway-api .cursor/skills/railway-api && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "railway-api" agent skill from https://github.com/majiayu000/claude-skill-registry/tree/main/skills/api/railway-api into .cursor/skills/railway-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "railway-api", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/majiayu000/claude-skill-registry.git --path skills/api/railway-api

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add majiayu000/claude-skill-registry --skill railway-api -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install majiayu000/claude-skill-registry railway-api --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/majiayu000/claude-skill-registry.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/api/railway-api .gemini/skills/railway-api && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "railway-api" agent skill from https://github.com/majiayu000/claude-skill-registry/tree/main/skills/api/railway-api into .gemini/skills/railway-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "railway-api", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install majiayu000/claude-skill-registry railway-api

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add majiayu000/claude-skill-registry --skill railway-api -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/majiayu000/claude-skill-registry.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/api/railway-api .github/skills/railway-api && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "railway-api" agent skill from https://github.com/majiayu000/claude-skill-registry/tree/main/skills/api/railway-api into .github/skills/railway-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "railway-api", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add majiayu000/claude-skill-registry --skill railway-api -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install majiayu000/claude-skill-registry railway-api --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/majiayu000/claude-skill-registry.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/api/railway-api .opencode/skills/railway-api && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "railway-api" agent skill from https://github.com/majiayu000/claude-skill-registry/tree/main/skills/api/railway-api into .opencode/skills/railway-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "railway-api", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: railway-api
GitHub stars: 666
Used in: 1 other repo
Token cost: ~2k tokens
SKILL.md length: 512 words
Files: 2
Skills in repo: 1,273
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Railway.com GraphQL API automation for projects, services, deployments, and environment variables.

Works in 3 steps: Authentication Setup → Basic Query Example → Basic Mutation Example
Automating Railway operations
SKILL.md covers Overview, Quick Start, Common Operations and Architecture, plus 9 more sections
Calls curl and railway; reaches backboard.railway.com; needs API_KEY

What it does

Railway API is an agent skill from majiayu000/claude-skill-registry. Railway.com GraphQL API automation for projects, services, deployments, and environment variables. Use when automating Railway operations, querying project data, managing deployments, setting variables via API, or integrating Railway into workflows.

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `metadata.json`).

It sits in DevOps & Cloud, covering Deployment, GraphQL and Secrets management. It works with GraphQL and Railway. The repository describes itself as: Searchable Claude Code skills catalog with source-linked guides and generated registry artifacts. The licence is MIT.

When your agent uses it

Automating Railway operations
Querying project data
Managing deployments
Setting variables via API

Example prompts

“/railway-api”

Requirements

Python 3
A credential in API_KEY

Workflow steps

3 steps, taken from the step headings in SKILL.md.

Authentication Setup
Basic Query Example
Basic Mutation Example

What it can do on your machine

Read from SKILL.md and the folder at commit 2d14a69. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- curl
- railway
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- backboard.railway.com
Also links to:
- docs.railway.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Railway API loads about 2k tokens when it runs. Until then it costs about 65 tokens; SKILL.md has 512 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~65
When it runs · the whole SKILL.md, loaded when a task matches: ~2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from majiayu000/claude-skill-registry at commit 2d14a69, republished under its MIT licence (© majiayu000). 512 words, ~1,992 tokens.

Download SKILL.mdSave it as .claude/skills/railway-api/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

name: railway-api
description: Railway.com GraphQL API automation for projects, services, deployments, and environment variables. Use when automating Railway operations, querying project data, managing deployments, setting variables via API, or integrating Railway into workflows.

Railway API

Comprehensive reference for Railway.com GraphQL API v2 automation including authentication, queries, mutations, and workflow automation.

Overview

The Railway GraphQL API enables programmatic access to all Railway platform features:

Project and service management
Environment variable configuration
Deployment triggering and monitoring
Team and resource management
Usage and billing queries

API Endpoint: https://backboard.railway.com/graphql/v2

Quick Start

1. Authentication Setup

Railway supports three token types with different scopes:

Token Type	Header	Scope	Use Case
Account	`Authorization: Bearer <token>`	All user resources	Personal automation
Team	`Team-Access-Token: <token>`	Team-specific resources	Team workflows
Project	`Project-Access-Token: <token>`	Single project only	CI/CD, project automation

Get tokens: Use the railway-auth skill or Railway dashboard → Account Settings → Tokens

2. Basic Query Example

bash

curl https://backboard.railway.com/graphql/v2 \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"query": "query { me { name email } }"}'

3. Basic Mutation Example

bash

curl https://backboard.railway.com/graphql/v2 \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "mutation($input: VariableUpsertInput!) { variableUpsert(input: $input) }",
    "variables": {
      "input": {
        "projectId": "project-id",
        "environmentId": "env-id",
        "name": "API_KEY",
        "value": "secret-value"
      }
    }
  }'

Common Operations

User & Account Information

graphql

query {
  me {
    id
    name
    email
    avatar
    isAdmin
  }
}

List Projects

graphql

query {
  projects {
    edges {
      node {
        id
        name
        description
        createdAt
        updatedAt
      }
    }
  }
}

Get Project Details with Services

graphql

query GetProject($projectId: String!) {
  project(id: $projectId) {
    id
    name
    description
    services {
      edges {
        node {
          id
          name
          serviceInstances {
            edges {
              node {
                id
                environmentId
                serviceId
              }
            }
          }
        }
      }
    }
    environments {
      edges {
        node {
          id
          name
        }
      }
    }
  }
}

Get Environment Variables

graphql

query GetVariables($projectId: String!, $environmentId: String!) {
  variables(projectId: $projectId, environmentId: $environmentId) {
    edges {
      node {
        name
        value
      }
    }
  }
}

Set/Update Variable

graphql

mutation SetVariable($input: VariableUpsertInput!) {
  variableUpsert(input: $input)
}

# Variables:
{
  "input": {
    "projectId": "your-project-id",
    "environmentId": "your-env-id",
    "name": "DATABASE_URL",
    "value": "postgresql://..."
  }
}

Trigger Deployment

graphql

mutation TriggerDeployment($serviceId: String!, $environmentId: String!) {
  deploymentTrigger(serviceId: $serviceId, environmentId: $environmentId) {
    id
    status
    createdAt
  }
}

Architecture

Progressive Disclosure Structure

SKILL.md (this file): Quick reference and common operations
references/: Detailed documentation
- graphql-endpoint.md - Complete API endpoint documentation
- authentication.md - Comprehensive authentication guide
- common-queries.md - 15+ query examples with responses
- common-mutations.md - 15+ mutation examples with patterns
scripts/: Automation tools
- query-project.py - Python script for querying Railway API
- set-variables.ts - TypeScript script for variable management

Error Handling

Railway API returns errors in this format:

json

{
  "errors": [
    {
      "message": "Error message",
      "extensions": {
        "code": "ERROR_CODE"
      }
    }
  ]
}

Common errors:

UNAUTHORIZED - Invalid or expired token
FORBIDDEN - Insufficient permissions for resource
NOT_FOUND - Resource doesn't exist
VALIDATION_ERROR - Invalid input data

Best practices:

Always check for errors field in response
Use appropriate token type for operation scope
Handle rate limiting (429 responses)
Validate input before mutations
Use variables for parameterized queries

Integration Patterns

CI/CD Pipeline

bash

# Get project token from railway-auth
# Set deployment variables
# Trigger deployment
# Monitor deployment status

See scripts/ for complete automation examples.

Infrastructure as Code

typescript

// Define Railway resources in code
// Apply changes via GraphQL mutations
// Track state and changes

Monitoring & Alerts

python

# Query deployment status
# Check resource usage
# Alert on failures

Cross-References

railway-auth: Token generation and management
railway-deployment: High-level deployment workflows
railway-troubleshooting: API error debugging

Learning Path

Start: Read references/graphql-endpoint.md for endpoint details
Authentication: Study references/authentication.md for token setup
Queries: Explore references/common-queries.md for data retrieval
Mutations: Review references/common-mutations.md for operations
Automation: Use scripts in scripts/ for workflow examples
Advanced: Combine patterns for complex automation

Show full SKILL.md (184 more words)Show less

Quick Reference

Essential Queries

Get user info: query { me { name email } }
List projects: query { projects { edges { node { id name } } } }
Get variables: Use variables query with projectId and environmentId
Deployment status: Query deployments with filters

Essential Mutations

Set variable: variableUpsert mutation
Trigger deploy: deploymentTrigger mutation
Create service: serviceCreate mutation
Delete variable: variableDelete mutation

Rate Limits

Account tokens: 100 requests/minute
Team tokens: 500 requests/minute
Project tokens: 1000 requests/minute

Notes

All timestamps are in ISO 8601 format (UTC)
IDs are opaque strings, don't parse or construct them
Pagination uses cursor-based edges/nodes pattern
Use GraphQL variables for all dynamic values
Production mutations should use Project tokens for security

Known API Limitations

Some GraphQL queries return "Problem processing request" even with valid tokens. This is a Railway API limitation, not a token issue.

Affected queries: deployment(id:), deploymentLogs, buildLogs, me.teams, teams

Workaround: Use Railway CLI for these operations:

bash

railway list --json     # Projects/teams
railway logs            # Deployment/build logs

See api-limitations.md for full details.

References

common-queries.md - 31 query examples
common-mutations.md - 37 mutation examples
api-limitations.md - Known limitations and workarounds
authentication.md - Token types and headers
graphql-endpoint.md - Endpoint details

Resources

Railway API Documentation: https://docs.railway.com/reference/public-api
GraphQL Explorer: https://backboard.railway.com/graphql/v2 (with GraphiQL)
Token Management: Use railway-auth skill

Files

SKILL.md and 1 other file in skills/api/railway-api of majiayu000/claude-skill-registry.

SKILL.md
metadata.json

Open the folder on GitHubat commit 2d14a69

Used in 1 other repository

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in majiayu000/claude-skill-registry, which our catalogue first saw on October 7, 2026.

NeverSight/learn-skills.devdata/skills-md/adaptationio/skrillz/railway-api

Compare with similar skills

Railway API next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Railway API compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Railway API this skillmajiayu000/claude-skill-registry	666	1 repos	~2k	Automated safety check: Pass	MIT	today
RailwayAnil-matcha/awesome-muse-connectors	1.3k	—	~661	Automated safety check: Pass	MIT	2 days ago
Monstermq Broker Configvogler75/monster-mq	143	—	~2.2k	Automated safety check: Pass	GPL-3.0	yesterday
Memstack Deployment Railway Deploycwinvestments/memstack	423	—	~2.1k	Automated safety check: Pass	Proprietary	11 days ago
Ar Io Gateway Operatorar-io/ar-io-node	127	—	~8.2k	Automated safety check: Notes	AGPL-3.0	today
Deployclacky-ai/openclacky	1.2k	—	~1.9k	Automated safety check: Pass	MIT	today

Similar skills

Railway
Anil-matcha/awesome-muse-connectors
Read and write Railway: list projects and deployments, set environment variables, redeploy.
1.3k GitHub stars~661 tokensUpdated 2 days ago
DevOps & CloudAuto-check passed
Monstermq Broker Config
vogler75/monster-mq
Guide for configuring, deploying, and operating the MonsterMQ broker.
143 GitHub stars~2.2k tokensUpdated yesterday
DevOps & CloudAuto-check passed
Memstack Deployment Railway Deploy
cwinvestments/memstack
A skill your agent uses when the user says 'deploy to Railway', 'Railway setup', 'railway-deploy', or needs to deploy a Node.js, Python, or Docker application to Railway with environment variables…
423 GitHub stars~2.1k tokensUpdated 11 days ago
DevOps & CloudAuto-check passed
Ar Io Gateway Operator
ar-io/ar-io-node
Operate any AR.IO node deployment — architecture, daily ops, diagnostics, and recurring pitfalls that apply to every operator.
127 GitHub stars~8.2k tokensUpdated today
Backend & APIsAuto-check: notes
Deploy
clacky-ai/openclacky
Deploy Rails applications to Railway. An agent skill from clacky-ai/openclacky.
1.2k GitHub stars~1.9k tokensUpdated today
DevOps & CloudAuto-check passed
Shopsys Commands
shopsys/shopsys
The command catalog for this Shopsys project — how to build, run, test, check code, access the database, and sync the GraphQL schema, including the macOS Mutagen workflow.
350 GitHub stars~1.3k tokensUpdated today
DevOps & CloudAuto-check: notes

Questions about Railway API

What does Railway API do?

Railway.com GraphQL API automation for projects, services, deployments, and environment variables. Railway API is an agent skill from majiayu000/claude-skill-registry.com GraphQL API automation for projects, services, deployments, and environment variables.

When should I use Railway API?

Railway API fits situations like: automating Railway operations; querying project data; managing deployments; setting variables via API.

How do I install Railway API in Claude Code?

Run `npx skills add majiayu000/claude-skill-registry --skill railway-api -a claude-code`. Or copy the skill folder (skills/api/railway-api in majiayu000/claude-skill-registry) into .claude/skills/railway-api in your project. Claude Code loads it when a task matches its description.

How do I install Railway API in Codex?

Run `npx skills add majiayu000/claude-skill-registry --skill railway-api -a codex`. Or copy the skill folder (skills/api/railway-api in majiayu000/claude-skill-registry) into .agents/skills/railway-api in your project. Codex loads it when a task matches its description.

Can I use Railway API in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add majiayu000/claude-skill-registry --skill railway-api -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/railway-api, .gemini/skills/railway-api, .github/skills/railway-api and .opencode/skills/railway-api in your project.

What does Railway API need to run?

Going by SKILL.md and its folder, Railway API needs the command-line tools its instructions call (curl and railway) and credentials named API_KEY. Our summary lists: Python 3; A credential in API_KEY.

Does Railway API access the network?

SKILL.md names 2 domains. In commands or code: backboard.railway.com; the agent is likely to contact it when it follows the instructions. As links in the text: docs.railway.com. This is read from the text; nothing was executed.

Is Railway API safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Railway API use?

Railway API is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Railway API use?

About 2k tokens (SKILL.md is roughly 8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Railway API?

Skills that share tags, products or a category with Railway API: Railway (Anil-matcha/awesome-muse-connectors, 1.3k stars), Monstermq Broker Config (vogler75/monster-mq, 143 stars), Memstack Deployment Railway Deploy (cwinvestments/memstack, 423 stars) and Ar Io Gateway Operator (ar-io/ar-io-node, 127 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Railway API?

majiayu000 (a GitHub user) maintains it in majiayu000/claude-skill-registry, which has 666 GitHub stars. The repository holds 1,273 skills in this directory. The repository was last updated on October 7, 2026.

Source: majiayu000/claude-skill-registry on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Railway API

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Railway API

Overview

Quick Start

1. Authentication Setup

2. Basic Query Example

3. Basic Mutation Example

Common Operations

User & Account Information

List Projects

Get Project Details with Services

Get Environment Variables

Set/Update Variable

Trigger Deployment

Architecture

Progressive Disclosure Structure

Error Handling

Integration Patterns

CI/CD Pipeline

Infrastructure as Code

Monitoring & Alerts

Cross-References

Learning Path

Quick Reference

Essential Queries

Essential Mutations

Rate Limits

Notes

Known API Limitations

References

Resources

Files

Used in 1 other repository

Compare with similar skills

Similar skills

More from majiayu000/claude-skill-registry

Related

Questions about Railway API