# rivet-deploy-image

rivet-deploy-image — a skill for Claude Code deploys Docker images to Rivet Cloud clusters via MCP or rolls back builds. It triggers when asking the agent to deploy, ship, release, or revert an app.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 146 installs · ★ 53 repo stars
- Author: rivet-dev
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/rivet-dev/skills/tree/HEAD/skills/rivet-deploy-image/SKILL.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/rivet-deploy-image

## What it does

The skill compiles an application into a `linux/amd64` container, measures file size alongside the MD5 checksum, and registers the release using `rivet.deploy.prepare`. It uploads the resulting archive through a presigned curl URL and steps through rollout checks until completion.

Docker and an active shell are mandatory. Rivet CLI credentials are not required. The tarball cannot exceed 5 GiB, and any size mismatch halts verification. The connection must expose `rivet.deploy.prepare` or operations fail immediately.

Rollouts take 5 to 10 minutes while earlier builds remain active. If a rollout stalls, the agent repeats `rivet.deploy.rollout` with the existing `build_id` rather than rebuilding the container.

## Requirements
- Works with: Docker

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add rivet-dev/skills --skill rivet-deploy-image -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add rivet-dev/skills --skill rivet-deploy-image -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add rivet-dev/skills --skill rivet-deploy-image -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install rivet-dev/skills skills/rivet-deploy-image
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add rivet-dev/skills --skill rivet-deploy-image -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/rivet-dev/skills --path skills/rivet-deploy-image
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add rivet-dev/skills --skill rivet-deploy-image -a opencode
```

### 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/rivet-dev/skills/tree/HEAD/skills/rivet-deploy-image/SKILL.md

## When to use it
- build an image for `linux/amd64` architecture
- register builds in a Rivet Cloud cluster
- upload container tar archives using presigned URLs
- step through cluster rollout progress
- roll back a cluster to an earlier `build_id`

## Example prompts
- Build the application image and deploy it to my-cluster
- Ship the latest project version to Rivet Cloud
- Roll back cluster my-cluster to the previous build_id

## Similar
- [render-deploy](https://affpapa.org/en/nevibecode/skills/render-deploy.md) — skill · 640 installs
- [aws-cloudformation-task-ecs-deploy-gh](https://affpapa.org/en/nevibecode/skills/aws-cloudformation-task-ecs-deploy-gh.md) — skill · ★ 372 repo stars
- [runpod-templates](https://affpapa.org/en/nevibecode/skills/runpod-templates.md) — skill · 12100 installs
- [rivet-sdk](https://affpapa.org/en/nevibecode/skills/anthropics-rivet-sdk.md) — skill · 2200 installs
- [aspire-deployment](https://affpapa.org/en/nevibecode/skills/aspire-deployment.md) — skill · 1200 installs
- [catalyst-appsail](https://affpapa.org/en/nevibecode/skills/catalyst-appsail.md) — skill · 1200 installs

From the same set: [rivet-dev/skills](https://affpapa.org/en/nevibecode/by/rivet-dev/skills.md) — 5 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
