# deployment

A Claude skill that lets the agent run Railway deployment tasks: read logs, restart, redeploy, take a deploy down. Handy when a service crashes or you need deploy history.

- skill · `type=skill` · Claude Code · 69 installs
- Author: Railway
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/railway/deployment
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/deployment

## What it does

The skill covers the lifecycle of a deployment that already exists on Railway. The agent can list deploys with their IDs and statuses, pull build or runtime logs, restart a container, redeploy the latest build, and take the current deploy down with `railway down`. What sits inside is guidance for Railway CLI calls, and the allowed tool is limited to `Bash(railway:*)`, so everything goes through that binary.

Log filtering works by level and text: `railway logs --lines 50 --filter "@level:error" --json`. Time windows come from `--since` and `--until`, either relative (`30s`, `5m`, `2h`, `1d`, `1w`) or ISO 8601. Plain `railway logs` returns the last successful deploy; add `--latest` to see the current one. A deployment ID goes in as a positional argument — `--deployment` is a boolean that switches to deploy logs instead of `--build`.

Railway CLI has to be there first: the skill lists `railway-cli` as a dependency, and without it the commands go nowhere. One boundary matters. `railway down` stops a deploy while the service stays in place, so reaching for it to kill a service leaves you with a service that has nothing running. Full service deletion belongs to the `railway-environment` skill with `isDeleted: true`.

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --skill railway/deployment
```

2. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill deployment -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/deployment/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/deployment/

### Codex

**Manually: put the files in place**
- File: `.agents/skills/deployment/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

**Manually: put the files in place**
- File: `.cursor/skills/deployment/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davila7/claude-code-templates deployment
```

2. **Manually: put the files in place**
- File: `.github/skills/deployment/SKILL.md`

### Gemini CLI

**Platform CLI**
```bash
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/railway/deployment
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/deployment/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/railway/deployment

## When to use it
- read logs from a failed deploy and trace the cause
- restart a container without rebuilding after external resources change
- pull deploy history with IDs and statuses
- redeploy the latest build after a config change
- take a deploy down while keeping the service

## Example prompts
- Show the last 100 log lines for the `backend` service and flag the errors
- Restart the `api` service deploy without rebuilding
- Take down the current deploy for the `web` service

## Similar
- [troubleshooting-astro-deployments](https://affpapa.org/en/nevibecode/skills/troubleshooting-astro-deployments.md) — skill · 622 installs
- [access-protected-vercel-deployment](https://affpapa.org/en/nevibecode/skills/access-protected-vercel-deployment.md) — skill · 2600 installs
- [railway](https://affpapa.org/en/nevibecode/plugins/railway.md) — plugin · ★ 336
- [troubleshooting-application-failures](https://affpapa.org/en/nevibecode/skills/troubleshooting-application-failures.md) — skill · 6400 installs
- [rag-blueprint](https://affpapa.org/en/nevibecode/skills/rag-blueprint.md) — skill · 3300 installs
- [convex-insights](https://affpapa.org/en/nevibecode/skills/convex-insights.md) — skill · 36200 installs

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 495 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md