Agent skill

Railway Service

by davila7 in davila7/claude-code-templates

Check service status, rename services, change service icons, link services, or create services with Docker images.

MITAuto-check passedDevOps & Cloud

Install Railway Service

skills CLI
$ npx skills add davila7/claude-code-templates --skill railway-service -a claude-code

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

GitHub CLI
$ gh skill install davila7/claude-code-templates railway-service --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/davila7/claude-code-templates.git skills-src && mkdir -p .claude/skills && cp -r skills-src/cli-tool/components/skills/railway/service .claude/skills/railway-service && 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/

Facts

Skill name
railway-service
GitHub stars
33k
Token cost
~1.7k tokens
SKILL.md length
515 words
Files
1
Skills in repo
479
Repo updated
First seen
Licence
MIT

At a glance

Check service status, rename services, change service icons, link services, or create services with Docker images.

  • Works in 3 steps: Create empty service:… → Use railway-environment skill to… → Apply to trigger deployment
  • Tasks that involve Deployment
  • SKILL.md covers When to Use, Create Service, Check Service Status and Update Service, plus 3 more sections
  • Calls railway and bash; reaches devicons.railway.app

What it does

Railway Service is an agent skill from davila7/claude-code-templates. Check service status, rename services, change service icons, link services, or create services with Docker images. For creating services with local code, prefer railway-new skill. For GitHub repo sources, use railway-new skill to create empty service then railway-environment skill to configure source.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in DevOps & Cloud, covering Deployment and Containers. It works with GitHub and Docker. The repository describes itself as: CLI tool for configuring and monitoring Claude Code. The licence is MIT.

When your agent uses it

  • Tasks that involve Deployment
  • Tasks that involve Containers

Example prompts

  • “/railway-service”

Requirements

  • Node.js
  • Docker
  • Pre-approved tools (allowed-tools): Bash(railway:*)

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Create empty service: serviceCreate(input: {projectId: "...", name: "my-service"})
  2. Use railway-environment skill to configure source via staged changes API
  3. Apply to trigger deployment

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(railway:*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • railway
    • bash

    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:

    • devicons.railway.app

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Railway Service loads about 1.7k tokens when it runs. Until then it costs about 80 tokens; SKILL.md has 515 words of instructions outside code blocks.

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

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 davila7/claude-code-templates at commit c0ca7da, republished under its MIT licence (© davila7). 515 words, ~1,694 tokens.

Download SKILL.mdSave it as .claude/skills/railway-service/SKILL.md (or your agent's skills folder).
name
railway-service
description
Check service status, rename services, change service icons, link services, or create services with Docker images. For creating services with local code, prefer railway-new skill. For GitHub repo sources, use railway-new skill to create empty service then railway-environment skill to configure source.
allowed-tools
Bash(railway:*)
version
1.0.0
author
Railway
license
MIT
tags
Railway, Service, Status, Docker, Container, Infrastructure, Management
dependencies
railway-cli

Railway Service Management

Check status, update properties, and advanced service creation.

When to Use

  • User asks about service status, health, or deployments
  • User asks "is my service deployed?"
  • User wants to rename a service or change service icon
  • User wants to link a different service
  • User wants to deploy a Docker image as a new service (advanced)

Note: For creating services with local code (the common case), prefer the railway-new skill which handles project setup, scaffolding, and service creation together.

For GitHub repo sources: Use railway-new skill to create empty service, then railway-environment skill to configure source.repo via staged changes API.

Create Service

Create a new service via GraphQL API. There is no CLI command for this.

Get Context
bash
railway status --json

Extract:

  • project.id - for creating the service
  • environment.id - for staging the instance config
Create Service Mutation
graphql
mutation serviceCreate($input: ServiceCreateInput!) {
  serviceCreate(input: $input) {
    id
    name
  }
}
ServiceCreateInput Fields
FieldTypeDescription
projectIdString!Project ID (required)
nameStringService name (auto-generated if omitted)
source.imageStringDocker image (e.g., nginx:latest)
source.repoStringGitHub repo (e.g., user/repo)
branchStringGit branch for repo source
environmentIdStringIf set and is a fork, only creates in that env
Example: Create empty service
bash
bash <<'SCRIPT'
${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh \
  'mutation createService($input: ServiceCreateInput!) {
    serviceCreate(input: $input) { id name }
  }' \
  '{"input": {"projectId": "PROJECT_ID"}}'
SCRIPT
Example: Create service with image
bash
bash <<'SCRIPT'
${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh \
  'mutation createService($input: ServiceCreateInput!) {
    serviceCreate(input: $input) { id name }
  }' \
  '{"input": {"projectId": "PROJECT_ID", "name": "my-service", "source": {"image": "nginx:latest"}}}'
SCRIPT
Connecting a GitHub Repo

Do NOT use serviceCreate with source.repo - use staged changes API instead.

Flow:

  1. Create empty service: serviceCreate(input: {projectId: "...", name: "my-service"})
  2. Use railway-environment skill to configure source via staged changes API
  3. Apply to trigger deployment
After Creating: Configure Instance

Use railway-environment skill to configure the service instance:

json
{
  "services": {
    "<serviceId>": {
      "isCreated": true,
      "source": { "image": "nginx:latest" },
      "variables": {
        "PORT": { "value": "8080" }
      }
    }
  }
}

Critical: Always include isCreated: true for new service instances.

Then use railway-environment skill to apply and deploy.

Check Service Status

bash
railway service status --json

Returns current deployment status for the linked service.

Deployment History
bash
railway deployment list --json --limit 5
Present Status

Show:

  • Service: name and current status
  • Latest Deployment: status (SUCCESS, FAILED, DEPLOYING, CRASHED, etc.)
  • Deployed At: when the current deployment went live
  • Recent Deployments: last 3-5 with status and timestamps
Show full SKILL.md (209 more words)Show less
Deployment Statuses
StatusMeaning
SUCCESSDeployed and running
FAILEDBuild or deploy failed
DEPLOYINGCurrently deploying
BUILDINGBuild in progress
CRASHEDRuntime crash
REMOVEDDeployment removed

Update Service

Update service name or icon via GraphQL API.

Get Service ID
bash
railway status --json

Extract service.id from the response.

Update Name
bash
bash <<'SCRIPT'
${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh \
  'mutation updateService($id: String!, $input: ServiceUpdateInput!) {
    serviceUpdate(id: $id, input: $input) { id name }
  }' \
  '{"id": "SERVICE_ID", "input": {"name": "new-name"}}'
SCRIPT
Update Icon

Icons can be image URLs or animated GIFs.

TypeExample
Image URL"icon": "https://example.com/logo.png"
Animated GIF"icon": "https://example.com/animated.gif"
Devicons"icon": "https://devicons.railway.app/github"

Railway Devicons: Query https://devicons.railway.app/{query} for common developer icons (e.g., github, postgres, redis, nodejs). Browse all at https://devicons.railway.app

bash
bash <<'SCRIPT'
${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh \
  'mutation updateService($id: String!, $input: ServiceUpdateInput!) {
    serviceUpdate(id: $id, input: $input) { id icon }
  }' \
  '{"id": "SERVICE_ID", "input": {"icon": "https://devicons.railway.app/github"}}'
SCRIPT
ServiceUpdateInput Fields
FieldTypeDescription
nameStringService name
iconStringEmoji or image URL (including animated GIFs)

Switch the linked service for the current directory:

bash
railway service link

Or specify directly:

bash
railway service link <service-name>

Composability

  • Create service with local code: Use railway-new skill (handles scaffolding + creation)
  • Configure service: Use railway-environment skill (variables, commands, image, etc.)
  • Delete service: Use railway-environment skill with isDeleted: true
  • Apply changes: Use railway-environment skill
  • View logs: Use railway-deployment skill
  • Deploy local code: Use railway-deploy skill

Error Handling

No Service Linked
No service linked. Run `railway service link` to link a service.
No Deployments
Service exists but has no deployments yet. Deploy with `railway up`.
Service Not Found
Service "foo" not found. Check available services with `railway status`.
Project Not Found

User may not be in a linked project. Check railway status.

Permission Denied

User needs at least DEVELOPER role to create services.

Invalid Image

Docker image must be accessible (public or with registry credentials).

© davila7, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in cli-tool/components/skills/railway/service of davila7/claude-code-templates.

Open the folder on GitHubat commit c0ca7da

Compare with similar skills

Railway Service 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 Service compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Railway Service this skilldavila7/claude-code-templates33k—~1.7kAutomated safety check: PassMIT
Reflexo ReleaseMyriad-Dreamin/typst.ts1.2k—~1.5kAutomated safety check: PassApache-2.0
1panel App Builderarch3rPro/1Panel-Appstore214—~1.3kAutomated safety check: PassMIT
Releasebmeares/Meerschaum154—~1.1kAutomated safety check: NotesApache-2.0
Perplexity Server DeployescapeWu/perplexity-ai171—~662Automated safety check: NotesMIT
GreptimeDB Dev Docker ImageGreptimeTeam/greptimedb6.7k—~4kAutomated safety check: NotesApache-2.0

Similar skills

  • Reflexo Release

    Myriad-Dreamin/typst.ts

    Guide Reflexo/typst.ts release preparation and operator handoffs.

    1.2k GitHub stars~1.5k tokensUpdated 3 days ago
    DevOps & CloudAuto-check passed
  • 1panel App Builder

    arch3rPro/1Panel-Appstore

    A skill your agent uses when packaging Docker deployments as 1Panel local app store apps, including GitHub projects, docker-compose.yml files, docker run commands, app metadata, version directories…

    214 GitHub stars~1.3k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Release

    bmeares/Meerschaum

    Meerschaum release process — bump version, update changelog, stage dev→main PR, run CI, publish to PyPI, tag, GitHub release, build/push Docker images, rebuild docs on prod VPS.

    154 GitHub stars~1.1k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Perplexity Server Deploy

    escapeWu/perplexity-ai

    Deploys the perplexity-ai project to its production server by pushing main, fast-forwarding the server checkout, rebuilding the image there and verifying health.

    171 GitHub stars~662 tokensUpdated 13 days ago
    DevOps & CloudAuto-check: notes
  • GreptimeDB Dev Docker Image

    GreptimeTeam/greptimedb

    Packages a locally built GreptimeDB debug binary into a development-only Docker image for local-cluster testing, with an optional push to a dev registry.

    6.7k GitHub stars~4k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Senior DevOps Toolkit

    maslennikov-ig/claude-code-orchestrator-kit

    Comprehensive DevOps skill for CI/CD, infrastructure automation, containerization, and cloud platforms (AWS, GCP, Azure). Includes pipeline setup…

    260 GitHub starsUsed in 6 repos~1.1k tokens
    DevOps & CloudAuto-check: notes

More from davila7/claude-code-templates

All 479 skills in this repo
  • Perplexity Web Search

    davila7/claude-code-templates

    Runs web-grounded searches through Perplexity's Sonar models over OpenRouter for current events, recent literature and cited facts beyond the model's training cutoff.

    33k GitHub starsUsed in 11 repos~3.5k tokens
    Auto-check: notes
  • Neuropixels Data Analysis

    davila7/claude-code-templates

    Analyzes Neuropixels recordings from SpikeGLX or Open Ephys through preprocessing, drift correction, Kilosort4 spike sorting, quality metrics and curation.

    33k GitHub starsUsed in 9 repos~2.8k tokens
    Auto-check passed
  • Scientific Venue Templates

    davila7/claude-code-templates

    Supplies LaTeX templates and formatting rules for journals, conferences, posters, and grant proposals, then can check a draft against them.

    33k GitHub starsUsed in 9 repos~5.1k tokens
    Auto-check: notes
  • Brand Voice Content Creator

    davila7/claude-code-templates

    Analyzes a brand's existing writing to lock in a consistent voice, then builds SEO blog posts and platform-specific social content around it.

    33k GitHub starsUsed in 3 repos~1.9k tokens
    Auto-check passed
  • CAPA Officer

    davila7/claude-code-templates

    Guides corrective and preventive action (CAPA) work in a quality management system, from initiation and root cause analysis through effectiveness verification.

    33k GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Fda Consultant Specialist

    davila7/claude-code-templates

    Senior FDA consultant and specialist for medical device companies including HIPAA compliance and requirement management.

    33k GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check passed

Works with

Categories

Questions about Railway Service

What does Railway Service do?

Check service status, rename services, change service icons, link services, or create services with Docker images. Railway Service is an agent skill from davila7/claude-code-templates. Check service status, rename services, change service icons, link services, or create services with Docker images.

When should I use Railway Service?

Railway Service fits situations like: tasks that involve Deployment; tasks that involve Containers.

How do I install Railway Service in Claude Code?

Run `npx skills add davila7/claude-code-templates --skill railway-service -a claude-code`. Or copy the skill folder (cli-tool/components/skills/railway/service in davila7/claude-code-templates) into .claude/skills/railway-service in your project. Claude Code loads it when a task matches its description.

How do I install Railway Service in Codex?

Run `npx skills add davila7/claude-code-templates --skill railway-service -a codex`. Or copy the skill folder (cli-tool/components/skills/railway/service in davila7/claude-code-templates) into .agents/skills/railway-service in your project. Codex loads it when a task matches its description.

Can I use Railway Service 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 davila7/claude-code-templates --skill railway-service -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-service, .gemini/skills/railway-service, .github/skills/railway-service and .opencode/skills/railway-service in your project.

What does Railway Service need to run?

Going by SKILL.md and its folder, Railway Service needs the command-line tools its instructions call (railway and bash). Our summary lists: Node.js; Docker. Its frontmatter pre-approves these tools: Bash(railway:*).

Does Railway Service access the network?

SKILL.md names 1 domain. In commands or code: devicons.railway.app; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Railway Service 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 Service use?

Railway Service is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Railway Service use?

About 1.7k tokens (SKILL.md is roughly 6.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 Service?

Skills that share tags, products or a category with Railway Service: Reflexo Release (Myriad-Dreamin/typst.ts, 1.2k stars), 1panel App Builder (arch3rPro/1Panel-Appstore, 214 stars), Release (bmeares/Meerschaum, 154 stars) and Perplexity Server Deploy (escapeWu/perplexity-ai, 171 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Railway Service?

davila7 (a GitHub user) maintains it in davila7/claude-code-templates, which has 32,512 GitHub stars. The repository holds 479 skills in this directory. The repository was last updated on October 10, 2026.

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