Agent skill

Railway Deployment

by davila7 in davila7/claude-code-templates

Manage Railway deployments - view logs, redeploy, restart, or remove deployments.

MITAuto-check passedDevOps & Cloud

Install Railway Deployment

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

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

GitHub CLI
$ gh skill install davila7/claude-code-templates railway-deployment --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/deployment .claude/skills/railway-deployment && 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-deployment
GitHub stars
33k
Token cost
~1.5k tokens
SKILL.md length
545 words
Files
1
Skills in repo
479
Repo updated
First seen
Licence
MIT

At a glance

Manage Railway deployments - view logs, redeploy, restart, or remove deployments.

  • Deployment lifecycle (remove
  • SKILL.md covers When to Use, List Deployments, View Logs and Redeploy, plus 5 more sections
  • Calls railway
  • Deployment visibility (list

What it does

Railway Deployment is an agent skill from davila7/claude-code-templates. Manage Railway deployments - view logs, redeploy, restart, or remove deployments. Use for deployment lifecycle (remove, stop, redeploy, restart), deployment visibility (list, status, history), and troubleshooting (logs, errors, failures, crashes). NOT for deleting services - use railway-environment skill with isDeleted for that.

Its SKILL.md is about 1.5k 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. The repository describes itself as: CLI tool for configuring and monitoring Claude Code. The licence is MIT.

When your agent uses it

  • Deployment lifecycle (remove
  • Deployment visibility (list
  • Troubleshooting (logs

Example prompts

  • “/railway-deployment”

Requirements

  • Pre-approved tools (allowed-tools): Bash(railway:*)

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

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    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 Deployment loads about 1.5k tokens when it runs. Until then it costs about 87 tokens; SKILL.md has 545 words of instructions outside code blocks.

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

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). 545 words, ~1,541 tokens.

Download SKILL.mdSave it as .claude/skills/railway-deployment/SKILL.md (or your agent's skills folder).
name
railway-deployment
description
Manage Railway deployments - view logs, redeploy, restart, or remove deployments. Use for deployment lifecycle (remove, stop, redeploy, restart), deployment visibility (list, status, history), and troubleshooting (logs, errors, failures, crashes). NOT for deleting services - use railway-environment skill with isDeleted for that.
allowed-tools
Bash(railway:*)
version
1.0.0
author
Railway
license
MIT
tags
Railway, Deployment, Logs, Debug, Troubleshooting, Redeploy, Infrastructure
dependencies
railway-cli

Railway Deployment Management

Manage existing Railway deployments: list, view logs, redeploy, or remove.

Important: "Remove deployment" (railway down) stops the current deployment but keeps the service. To delete a service entirely, use the railway-environment skill with isDeleted: true.

When to Use

  • User says "remove deploy", "take down service", "stop deployment", "railway down"
  • User wants to "redeploy", "restart the service", "restart deployment"
  • User asks to "list deployments", "show deployment history", "deployment status"
  • User asks to "see logs", "show logs", "check errors", "debug issues"

List Deployments

bash
railway deployment list --limit 10 --json

Shows deployment IDs, statuses, and metadata. Use to find specific deployment IDs for logs or debugging.

Specify Service
bash
railway deployment list --service backend --limit 10 --json

View Logs

Deploy Logs
bash
railway logs --lines 100 --json

In non-interactive mode, streaming is auto-disabled and CLI fetches logs then exits.

Build Logs
bash
railway logs --build --lines 100 --json

For debugging build failures or viewing build output.

Logs for Failed/In-Progress Deployments

By default railway logs shows the last successful deployment. Use --latest for current:

bash
railway logs --latest --lines 100 --json
Filter Logs
bash
# Errors only
railway logs --lines 50 --filter "@level:error" --json

# Text search
railway logs --lines 50 --filter "connection refused" --json

# Combined
railway logs --lines 50 --filter "@level:error AND timeout" --json
Time-Based Filtering
bash
# Logs from last hour
railway logs --since 1h --lines 100 --json

# Logs between 30 and 10 minutes ago
railway logs --since 30m --until 10m --lines 100 --json

# Logs from specific timestamp
railway logs --since 2024-01-15T10:00:00Z --lines 100 --json

Formats: relative (30s, 5m, 2h, 1d, 1w) or ISO 8601 timestamps.

Logs from Specific Deployment

Deploy logs:

bash
railway logs <deployment-id> --lines 100 --json

Build logs:

bash
railway logs --build <deployment-id> --lines 100 --json

Get deployment ID from railway deployment list.

Note: The deployment ID is a positional argument, NOT --deployment <id>. The --deployment flag is a boolean that selects deploy logs (vs --build for build logs).

Redeploy

Redeploy the most recent deployment:

bash
railway redeploy --service <name> -y

The -y flag skips confirmation. Useful when:

  • Config changed via railway-environment skill
  • Need to restart without new code
  • Previous deploy succeeded but service misbehaving
Restart Container Only

Restart without rebuilding (picks up external resource changes):

bash
railway restart --service <name> -y

Use when external resources (S3 files, config maps) changed but code didn't.

Remove Deployment

Takes down the current deployment. The service remains but has no running deployment.

bash
# Remove deployment for linked service
railway down -y

# Remove deployment for specific service
railway down --service web -y
railway down --service api -y

This is what users mean when they say "remove deploy", "take down", or "stop the deployment".

Note: This does NOT delete the service. To delete a service entirely, use the railway-environment skill with isDeleted: true.

CLI Options

deployment list
FlagDescription
-s, --service <NAME>Service name or ID
-e, --environment <NAME>Environment name or ID
--limit <N>Max deployments (default 20, max 1000)
--jsonJSON output
Show full SKILL.md (210 more words)Show less
logs
FlagDescription
-s, --service <NAME>Service name or ID
-e, --environment <NAME>Environment name or ID
-d, --deploymentShow deploy logs (default, boolean flag)
-b, --buildShow build logs (boolean flag)
-n, --lines <N>Number of lines (required)
-f, --filter <QUERY>Filter using query syntax
--since <TIME>Start time (relative or ISO 8601)
--until <TIME>End time (relative or ISO 8601)
--latestMost recent deployment (even if failed)
--jsonJSON output
[DEPLOYMENT_ID]Specific deployment (optional)
redeploy
FlagDescription
-s, --service <NAME>Service name or ID
-y, --yesSkip confirmation
restart
FlagDescription
-s, --service <NAME>Service name or ID
-y, --yesSkip confirmation
down
FlagDescription
-s, --service <NAME>Service name or ID
-e, --environment <NAME>Environment name or ID
-y, --yesSkip confirmation

Presenting Logs

When showing logs:

  • Include timestamps
  • Highlight errors and warnings
  • For build failures: show error and suggest fixes
  • For runtime crashes: show stack trace context
  • Summarize patterns (e.g., "15 timeout errors in last 100 logs")

Composability

  • Push new code: Use railway-deploy skill
  • Check service status: Use railway-status skill
  • Fix config issues: Use railway-environment skill
  • Create new service: Use railway-new skill

Error Handling

No Service Linked
No service linked. Run `railway service` to select one.
No Deployments Found
No deployments found. Deploy first with `railway up`.
No Logs Found

Deployment may be too old (log retention limits) or service hasn't produced output.

© 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/deployment of davila7/claude-code-templates.

Open the folder on GitHubat commit c0ca7da

Compare with similar skills

Railway Deployment 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 Deployment compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Railway Deployment this skilldavila7/claude-code-templates33k—~1.5kAutomated safety check: PassMIT
Kubeshark Installerkubeshark/kubeshark12k—~3.6kAutomated safety check: NotesApache-2.0
GreptimeDB Dev Docker ImageGreptimeTeam/greptimedb6.7k—~4kAutomated safety check: NotesApache-2.0
KubeSphere ServiceMesh Managerkubesphere/kubesphere17k—~2.4kAutomated safety check: PassCustom licence
Vercelremotion-dev/remotion63k—~1.2kAutomated safety check: PassCustom licence
AWS Cdk Developmentzxkane/aws-skills3672 repos~2.5kAutomated safety check: PassMIT

Similar skills

  • Kubeshark Installer

    kubeshark/kubeshark

    Installs and configures Kubeshark on a Kubernetes cluster, choosing between the quick CLI path and a Helm install with custom values.

    12k GitHub stars~3.6k tokensUpdated today
    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
  • KubeSphere ServiceMesh Manager

    kubesphere/kubesphere

    Installs, checks and troubleshoots the KubeSphere ServiceMesh extension (Istio, Kiali, Jaeger), including grayscale release, sidecar injection, topology and tracing issues.

    17k GitHub stars~2.4k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed
  • Vercel

    remotion-dev/remotion

    Official

    Set up a Codex monitor for Vercel deployments and preview URLs.

    63k GitHub stars~1.2k tokensUpdated today
    DevOps & CloudAuto-check passed
  • AWS Cdk Development

    zxkane/aws-skills

    AWS Cloud Development Kit (CDK) expert for building cloud infrastructure with TypeScript/Python.

    367 GitHub starsUsed in 2 repos~2.5k tokens
    DevOps & CloudAuto-check passed
  • 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

Categories

Questions about Railway Deployment

What does Railway Deployment do?

Manage Railway deployments - view logs, redeploy, restart, or remove deployments. Railway Deployment is an agent skill from davila7/claude-code-templates. Manage Railway deployments - view logs, redeploy, restart, or remove deployments.

When should I use Railway Deployment?

Railway Deployment fits situations like: deployment lifecycle (remove; deployment visibility (list; troubleshooting (logs.

How do I install Railway Deployment in Claude Code?

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

How do I install Railway Deployment in Codex?

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

Can I use Railway Deployment 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-deployment -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-deployment, .gemini/skills/railway-deployment, .github/skills/railway-deployment and .opencode/skills/railway-deployment in your project.

What does Railway Deployment need to run?

Going by SKILL.md and its folder, Railway Deployment needs the command-line tools its instructions call (railway). Its frontmatter pre-approves these tools: Bash(railway:*).

Does Railway Deployment access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

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

Railway Deployment 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 Deployment use?

About 1.5k tokens (SKILL.md is roughly 6.2k 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 Deployment?

Skills that share tags, products or a category with Railway Deployment: Kubeshark Installer (kubeshark/kubeshark, 12k stars), GreptimeDB Dev Docker Image (GreptimeTeam/greptimedb, 6.7k stars), KubeSphere ServiceMesh Manager (kubesphere/kubesphere, 17k stars) and Vercel (remotion-dev/remotion, 63k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Railway Deployment?

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.