rivet-deploy-image — Claude Code skill: what it does, how to install
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.
no license 146 installs ★ 53 updated 2026-10-25
npx skills add rivet-dev/skills --skill rivet-deploy-image -a claude-codeWhat rivet-deploy-image 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.
What it helps with
- build an image for
linux/amd64architecture - 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 for the agent
- 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
How to install rivet-deploy-image
1Skills CLI (Vercel)
npx skills add rivet-dev/skills --skill rivet-deploy-image -a claude-code2Manually: put the files in place
~/.claude/skills/rivet-deploy-image/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/rivet-deploy-image/
1Skills CLI (Vercel)
npx skills add rivet-dev/skills --skill rivet-deploy-image -a codex2Manually: put the files in place
.agents/skills/rivet-deploy-image/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add rivet-dev/skills --skill rivet-deploy-image -a cursor2Manually: put the files in place
.cursor/skills/rivet-deploy-image/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install rivet-dev/skills skills/rivet-deploy-image2Manually: put the files in place
.github/skills/rivet-deploy-image/SKILL.md1Skills CLI (Vercel)
npx skills add rivet-dev/skills --skill rivet-deploy-image -a gemini-cli2Platform CLI
gemini skills install https://github.com/rivet-dev/skills --path skills/rivet-deploy-imageManually: put the files in place
.devin/skills/rivet-deploy-image/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add rivet-dev/skills --skill rivet-deploy-image -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about rivet-deploy-image
How to install rivet-deploy-image in Claude Code?
Run npx skills add rivet-dev/skills --skill rivet-deploy-image -a claude-code in your terminal.
What does rivet-deploy-image do?
It orchestrates building a local container, uploading the tarball via a presigned URL, and switching cluster builds in Rivet Cloud without the CLI.
What are the requirements for rivet-deploy-image?
You need Docker, a working shell, and a Rivet MCP connection that grants access to rivet.deploy.prepare.