Agent skill

Railway Metrics

by davila7 in davila7/claude-code-templates

Query resource usage metrics for Railway services. An agent skill from davila7/claude-code-templates.

Install Railway Metrics

skills CLI

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

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

GitHub CLI

$ gh skill install davila7/claude-code-templates railway-metrics --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/metrics .claude/skills/railway-metrics && 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-metrics" agent skill from https://github.com/davila7/claude-code-templates/tree/main/cli-tool/components/skills/railway/metrics into .claude/skills/railway-metrics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "railway-metrics", 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/davila7/claude-code-templates/tree/main/cli-tool/components/skills/railway/metrics

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 davila7/claude-code-templates --skill railway-metrics -a codex

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

GitHub CLI

$ gh skill install davila7/claude-code-templates railway-metrics --agent codex

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

Manual copy

$ git clone --depth 1 https://github.com/davila7/claude-code-templates.git skills-src && mkdir -p .agents/skills && cp -r skills-src/cli-tool/components/skills/railway/metrics .agents/skills/railway-metrics && 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-metrics" agent skill from https://github.com/davila7/claude-code-templates/tree/main/cli-tool/components/skills/railway/metrics into .agents/skills/railway-metrics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "railway-metrics", 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 davila7/claude-code-templates --skill railway-metrics -a cursor

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

GitHub CLI

$ gh skill install davila7/claude-code-templates railway-metrics --agent cursor

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

Manual copy

$ git clone --depth 1 https://github.com/davila7/claude-code-templates.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/cli-tool/components/skills/railway/metrics .cursor/skills/railway-metrics && 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-metrics" agent skill from https://github.com/davila7/claude-code-templates/tree/main/cli-tool/components/skills/railway/metrics into .cursor/skills/railway-metrics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "railway-metrics", 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/davila7/claude-code-templates.git --path cli-tool/components/skills/railway/metrics

--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 davila7/claude-code-templates --skill railway-metrics -a gemini-cli

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

GitHub CLI

$ gh skill install davila7/claude-code-templates railway-metrics --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/davila7/claude-code-templates.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/cli-tool/components/skills/railway/metrics .gemini/skills/railway-metrics && 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-metrics" agent skill from https://github.com/davila7/claude-code-templates/tree/main/cli-tool/components/skills/railway/metrics into .gemini/skills/railway-metrics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "railway-metrics", 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 davila7/claude-code-templates railway-metrics

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 davila7/claude-code-templates --skill railway-metrics -a github-copilot

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

Manual copy

$ git clone --depth 1 https://github.com/davila7/claude-code-templates.git skills-src && mkdir -p .github/skills && cp -r skills-src/cli-tool/components/skills/railway/metrics .github/skills/railway-metrics && 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-metrics" agent skill from https://github.com/davila7/claude-code-templates/tree/main/cli-tool/components/skills/railway/metrics into .github/skills/railway-metrics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "railway-metrics", 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 davila7/claude-code-templates --skill railway-metrics -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 davila7/claude-code-templates railway-metrics --agent opencode

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

Manual copy

$ git clone --depth 1 https://github.com/davila7/claude-code-templates.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/cli-tool/components/skills/railway/metrics .opencode/skills/railway-metrics && 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-metrics" agent skill from https://github.com/davila7/claude-code-templates/tree/main/cli-tool/components/skills/railway/metrics into .opencode/skills/railway-metrics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "railway-metrics", 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-metrics
GitHub stars: 33k
Token cost: ~1.5k tokens
SKILL.md length: 324 words
Files: 1
Skills in repo: 479
Repo updated: Oct 10, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Query resource usage metrics for Railway services. An agent skill from davila7/claude-code-templates.

User asks about resource usage
SKILL.md covers When to Use, Prerequisites, MetricMeasurement Values and MetricTag Values (for groupBy), plus 7 more sections
Calls jq, railway and bash
Service performance like how much memory is my service using

What it does

Railway Metrics is an agent skill from davila7/claude-code-templates. Query resource usage metrics for Railway services. Use when user asks about resource usage, CPU, memory, network, disk, or service performance like "how much memory is my service using" or "is my service slow".

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

When your agent uses it

User asks about resource usage
Service performance like how much memory is my service using
Is my service slow

Example prompts

“how much memory is my service using”
“is my service slow”
“/railway-metrics”

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:
- jq
- railway
- bash
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 Metrics loads about 1.5k tokens when it runs. Until then it costs about 57 tokens; SKILL.md has 324 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~57
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). 324 words, ~1,505 tokens.

Download SKILL.mdSave it as .claude/skills/railway-metrics/SKILL.md (or your agent's skills folder).

name: railway-metrics
description: Query resource usage metrics for Railway services. Use when user asks about resource usage, CPU, memory, network, disk, or service performance like "how much memory is my service using" or "is my service slow".
allowed-tools: Bash(railway:*)
version: 1.0.0
author: Railway
license: MIT
tags: Railway, Metrics, Monitoring, Performance, CPU, Memory, Resources, Analytics
dependencies: railway-cli

Railway Service Metrics

Query resource usage metrics for Railway services.

When to Use

User asks "how much memory is my service using?"
User asks about CPU usage, network traffic, disk usage
User wants to debug performance issues
User asks "is my service healthy?" (combine with railway-service skill)

Prerequisites

Get environmentId and serviceId from linked project:

bash

railway status --json

Extract:

environment.id → environmentId
service.id → serviceId (optional - omit to get all services)

MetricMeasurement Values

Measurement	Description
CPU_USAGE	CPU usage (cores)
CPU_LIMIT	CPU limit (cores)
MEMORY_USAGE_GB	Memory usage in GB
MEMORY_LIMIT_GB	Memory limit in GB
NETWORK_RX_GB	Network received in GB
NETWORK_TX_GB	Network transmitted in GB
DISK_USAGE_GB	Disk usage in GB
EPHEMERAL_DISK_USAGE_GB	Ephemeral disk usage in GB
BACKUP_USAGE_GB	Backup usage in GB

MetricTag Values (for groupBy)

Tag	Description
DEPLOYMENT_ID	Group by deployment
DEPLOYMENT_INSTANCE_ID	Group by instance
REGION	Group by region
SERVICE_ID	Group by service

Query

graphql

query metrics(
  $environmentId: String!
  $serviceId: String
  $startDate: DateTime!
  $endDate: DateTime
  $sampleRateSeconds: Int
  $averagingWindowSeconds: Int
  $groupBy: [MetricTag!]
  $measurements: [MetricMeasurement!]!
) {
  metrics(
    environmentId: $environmentId
    serviceId: $serviceId
    startDate: $startDate
    endDate: $endDate
    sampleRateSeconds: $sampleRateSeconds
    averagingWindowSeconds: $averagingWindowSeconds
    groupBy: $groupBy
    measurements: $measurements
  ) {
    measurement
    tags {
      deploymentInstanceId
      deploymentId
      serviceId
      region
    }
    values {
      ts
      value
    }
  }
}

Example: Last Hour CPU and Memory

Use heredoc to avoid shell escaping issues:

bash

bash <<'SCRIPT'
START_DATE=$(date -u -v-1H +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || date -u -d "1 hour ago" +"%Y-%m-%dT%H:%M:%SZ")
ENV_ID="your-environment-id"
SERVICE_ID="your-service-id"

VARS=$(jq -n \
  --arg env "$ENV_ID" \
  --arg svc "$SERVICE_ID" \
  --arg start "$START_DATE" \
  '{environmentId: $env, serviceId: $svc, startDate: $start, measurements: ["CPU_USAGE", "MEMORY_USAGE_GB"]}')

${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh \
  'query metrics($environmentId: String!, $serviceId: String, $startDate: DateTime!, $measurements: [MetricMeasurement!]!) {
    metrics(environmentId: $environmentId, serviceId: $serviceId, startDate: $startDate, measurements: $measurements) {
      measurement
      tags { deploymentId region serviceId }
      values { ts value }
    }
  }' \
  "$VARS"
SCRIPT

Example: All Services in Environment

Omit serviceId and use groupBy to get metrics for all services:

bash

bash <<'SCRIPT'
START_DATE=$(date -u -v-1H +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || date -u -d "1 hour ago" +"%Y-%m-%dT%H:%M:%SZ")
ENV_ID="your-environment-id"

VARS=$(jq -n \
  --arg env "$ENV_ID" \
  --arg start "$START_DATE" \
  '{environmentId: $env, startDate: $start, measurements: ["CPU_USAGE", "MEMORY_USAGE_GB"], groupBy: ["SERVICE_ID"]}')

${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh \
  'query metrics($environmentId: String!, $startDate: DateTime!, $measurements: [MetricMeasurement!]!, $groupBy: [MetricTag!]) {
    metrics(environmentId: $environmentId, startDate: $startDate, measurements: $measurements, groupBy: $groupBy) {
      measurement
      tags { serviceId region }
      values { ts value }
    }
  }' \
  "$VARS"
SCRIPT

Time Parameters

Parameter	Description
startDate	Required. ISO 8601 format (e.g., `2024-01-01T00:00:00Z`)
endDate	Optional. Defaults to now
sampleRateSeconds	Sample interval (e.g., 60 for 1-minute samples)
averagingWindowSeconds	Averaging window for smoothing

Tip: For last hour, calculate startDate as now - 1 hour in ISO format.

Output Interpretation

json

{
  "data": {
    "metrics": [
      {
        "measurement": "CPU_USAGE",
        "tags": { "deploymentId": "...", "serviceId": "...", "region": "us-west1" },
        "values": [
          { "ts": "2024-01-01T00:00:00Z", "value": 0.25 },
          { "ts": "2024-01-01T00:01:00Z", "value": 0.30 }
        ]
      }
    ]
  }
}

ts - timestamp in ISO format
value - metric value (cores for CPU, GB for memory/disk/network)

Composability

Get IDs: Use railway-status skill or railway status --json
Check service health: Use railway-service skill for deployment status
View logs: Use railway-deployment skill if metrics show issues
Scale service: Use railway-environment skill to adjust resources

Error Handling

Empty/Null Metrics

Services without active deployments return empty metrics arrays. When processing with jq, handle nulls:

bash

# Safe iteration - skip nulls
jq -r '.data.metrics[]? | select(.values != null and (.values | length) > 0) | ...'

# Check if metrics exist before processing
jq -e '.data.metrics | length > 0' response.json && echo "has metrics"

No Metrics Data

Service may be new or have no traffic. Check:

Service has active deployment (stopped services have no metrics)
Time range includes deployment period

Invalid Service/Environment ID

Verify IDs with railway status --json.

Permission Denied

User needs access to the project to query metrics.

Files

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

Open the folder on GitHubat commit c0ca7da

Compare with similar skills

Railway Metrics 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 Metrics compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Railway Metrics this skilldavila7/claude-code-templates	33k	—	~1.5k	Automated safety check: Pass	MIT	yesterday
Monitor CInrwl/nx	29k	6 repos	~4.7k	Automated safety check: Pass	MIT	yesterday
Terraform and OpenTofu Guideagentscope-ai/QwenPaw	36k	6 repos	~4.2k	Automated safety check: Pass	Apache-2.0	yesterday
Vercel Optimize Auditvercel-labs/agent-skills	32k	8 repos	~4.3k	Automated safety check: Pass	None	1 mo ago
Analyze GitHub Action Logswithastro/astro	63k	1 repos	~1.3k	Automated safety check: Pass	Custom licence	yesterday
Openclaw Live Updateropenclaw/openclaw	392k	—	~3.7k	Automated safety check: Pass	MIT	today

Similar skills

Monitor CI
nrwl/nx
Monitor Nx Cloud CI pipeline and handle self-healing fixes. An agent skill from nrwl/nx.
29k GitHub starsUsed in 6 repos~4.7k tokens
DevOps & CloudAuto-check passed
Terraform and OpenTofu Guide
agentscope-ai/QwenPaw
Guidance for writing and testing Terraform and OpenTofu code: module structure, naming, test approaches, CI/CD workflows, state handling and security scanning.
36k GitHub starsUsed in 6 repos~4.2k tokens
DevOps & CloudAuto-check passed
Vercel Optimize Audit
vercel-labs/agent-skills
Official
Runs a metrics-first audit of a deployed Vercel project, gating investigations on real signals to produce ranked, citation-backed cost and performance recommendations.
32k GitHub starsUsed in 8 repos~4.3k tokens
DevOps & CloudAuto-check passed
Analyze GitHub Action Logs
withastro/astro
Official
Analyze recent GitHub Actions workflow runs to identify patterns, mistakes, and improvements.
63k GitHub starsUsed in 1 repo~1.3k tokens
DevOps & CloudAuto-check passed
Openclaw Live Updater
openclaw/openclaw
Maintain the canonical live OpenClaw main checkout, macOS LaunchAgent-managed Gateway, local macOS app, exact-head main CI, and recurring full release validation.
392k GitHub stars~3.7k tokensUpdated today
DevOps & CloudAuto-check passed
Docs Learn PR Preview
netdata/netdata
Use only when the user explicitly asks to build, run, preview, inspect, or validate learn.netdata.cloud locally using the contents of a PR or documentation branch before merge.
81k GitHub stars~2k tokensUpdated today
DevOps & CloudAuto-check passed

Questions about Railway Metrics

What does Railway Metrics do?

Query resource usage metrics for Railway services. An agent skill from davila7/claude-code-templates. Railway Metrics is an agent skill from davila7/claude-code-templates. Query resource usage metrics for Railway services.

When should I use Railway Metrics?

Railway Metrics fits situations like: user asks about resource usage; service performance like how much memory is my service using; is my service slow.

How do I install Railway Metrics in Claude Code?

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

How do I install Railway Metrics in Codex?

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

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

What does Railway Metrics need to run?

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

Does Railway Metrics 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 Metrics 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 Metrics use?

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

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

Skills that share tags, products or a category with Railway Metrics: Monitor CI (nrwl/nx, 29k stars), Terraform and OpenTofu Guide (agentscope-ai/QwenPaw, 36k stars), Vercel Optimize Audit (vercel-labs/agent-skills, 32k stars) and Analyze GitHub Action Logs (withastro/astro, 63k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Railway Metrics?

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.

Install Railway Metrics

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Railway Service Metrics

When to Use

Prerequisites

MetricMeasurement Values

MetricTag Values (for groupBy)

Query

Example: Last Hour CPU and Memory

Example: All Services in Environment

Time Parameters

Output Interpretation

Composability

Error Handling

Empty/Null Metrics

No Metrics Data

Invalid Service/Environment ID

Permission Denied

Files

Compare with similar skills

Similar skills

More from davila7/claude-code-templates

Related

Questions about Railway Metrics