New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Release Rome Image

by rome-os in rome-os/rome

Release a new Rome runtime image by pushing a vX.Y.Z tag — pick the version, verify main is releasable, push the tag, and confirm the image published to Docker Hub.

MITAuto-check passedDevOps & Cloud

Install Release Rome Image

skills CLI
$ npx skills add rome-os/rome --skill release-rome-image -a claude-code

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

GitHub CLI
$ gh skill install rome-os/rome release-rome-image --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/rome-os/rome.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/release-rome-image .claude/skills/release-rome-image && 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
release-rome-image
GitHub stars
743
Token cost
~910 tokens
SKILL.md length
404 words
Files
1
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

Release a new Rome runtime image by pushing a vX.Y.Z tag — pick the version, verify main is releasable, push the tag, and confirm the image published to Docker Hub.

  • Works in 4 steps: Preflight → Pick the version → Cut the tag → …
  • Tasks that involve Containers
  • SKILL.md covers Out of scope, 1. Preflight, 2. Pick the version and 3. Cut the tag, plus 1 more section
  • Calls git, gh and curl; reaches hub.docker.com

What it does

Release Rome Image is an agent skill from rome-os/rome. Release a new Rome runtime image by pushing a vX.Y.Z tag — pick the version, verify main is releasable, push the tag, and confirm the image published to Docker Hub. Covers the v runtime-image tag only, not the desktop app (desktop-v) and not npm packages (ui-v, app-runtime-v).

Its SKILL.md is about 910 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 Containers. It works with Docker and npm. The repository describes itself as: A compounding agent OS for recursive agents. Also an open source alternative to Grok Bot and Meta's Muse. The licence is MIT.

When your agent uses it

  • Tasks that involve Containers

Example prompts

  • “/release-rome-image”

Requirements

  • Docker

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Preflight
  2. Pick the version
  3. Cut the tag
  4. Verify the publish

What it can do on your machine

Read from SKILL.md and the folder at commit ccf62e7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • gh
    • curl
    • jq

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • hub.docker.com

    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

Release Rome Image loads about 910 tokens when it runs. Until then it costs about 78 tokens; SKILL.md has 404 words of instructions outside code blocks.

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

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 rome-os/rome at commit ccf62e7, republished under its MIT licence (© rome-os). 404 words, ~910 tokens.

Download SKILL.mdSave it as .claude/skills/release-rome-image/SKILL.md (or your agent's skills folder).
name
release-rome-image
description
Release a new Rome runtime image by pushing a `vX.Y.Z` tag — pick the version, verify main is releasable, push the tag, and confirm the image published to Docker Hub. Covers the `v*` runtime-image tag only, not the desktop app (`desktop-v*`) and not npm packages (`ui-v*`, `app-runtime-v*`).
disable-model-invocation
true

Release a new Rome image

A pushed vX.Y.Z tag is the release. .github/workflows/docker-publish.yml builds the multi-arch image and publishes it to yunfanye/rome, with no approval gate between the push and Docker Hub. Get explicit confirmation before the push. Verify the published image after it.

The tagging contract covering the semver gate, tag immutability, and latest movement lives in docs/releases.md.

Out of scope

  • Desktop releases use the desktop-v* tag and a separate pipeline.
  • npm package releases belong to release-please. Never create those tags by hand.

1. Preflight

The tag lands on origin/main, and docker-publish.yml runs no CI gate of its own.

  1. Read the commit that the tag will point at.

    bash
    git fetch origin --tags && git rev-parse origin/main

  2. List the recent CI runs.

    bash
    gh run list --branch main --workflow CI --limit 5

  3. Find the run for the exact commit from step 1 and confirm the status is success. CI cancels superseded runs, so a rapid series of merges leaves cancelled runs on real commits. If the run failed, was cancelled, or is still running, stop and report it.

  4. Confirm no release is already in flight.

    bash
    gh run list --workflow "Docker Hub Publish" --limit 3

2. Pick the version

  1. Read the current stable tags.

    bash
    git tag --list 'v[0-9]*' | sort -V | tail -5

  2. For a patch release, use the helper in step 3. The helper computes the next patch version.

  3. For a minor or major release, take the version from the user.

  4. For a prerelease, use vX.Y.Z-rc.N. A prerelease publishes its own docker tag and never moves latest.

Two constraints decide the number. A published version is immutable, so re-pushing a released version fails and the fix for a bad release is the next version up. latest moves only when the new version is the highest stable version in the registry.

Show full SKILL.md (161 more words)Show less

3. Cut the tag

For a patch release:

  1. Print the planned tag and target commit.

    bash
    scripts/dev/create-patch-release-tag.sh --dry-run

  2. Show that output to the user and wait for an explicit yes.

  3. Create and push the tag, which starts the publish.

    bash
    scripts/dev/create-patch-release-tag.sh

The user can also click Run workflow on main in the Actions tab instead. That run allocates the same next patch version and checks CI itself.

For a minor, major, or prerelease version, the helper does not apply, because it bumps the patch version only. Confirm the version with the user, then tag origin/main directly.

bash
git tag -a v1.1.0 origin/main -m "Release v1.1.0" && git push origin refs/tags/v1.1.0

4. Verify the publish

  1. Watch the run to completion.

    bash
    gh run watch "$(gh run list --workflow "Docker Hub Publish" --limit 1 --json databaseId --jq '.[0].databaseId')"

  2. Confirm the version reached the registry.

    bash
    curl -fsSL "https://hub.docker.com/v2/repositories/yunfanye/rome/tags?page_size=20" | jq -r '.results[].name'

  3. Report the published version, whether latest moved, and the build SHA. A running instance reports the baked version at /api/build-info.

© rome-os, 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 .claude/skills/release-rome-image of rome-os/rome.

Open the folder on GitHubat commit ccf62e7

Compare with similar skills

Release Rome Image 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.

Release Rome Image compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Release Rome Image this skillrome-os/rome743—~910Automated safety check: PassMIT
Reflexo ReleaseMyriad-Dreamin/typst.ts1.2k—~1.5kAutomated safety check: PassApache-2.0
Os Eco Dep Syncjayminwest/warren481—~1.9kAutomated safety check: PassMIT
Ddevhaxtheweb/haxcms-php130—~1.6kAutomated safety check: PassApache-2.0
Data Processingaiskillstore/marketplace4331 repos~720Automated safety check: NotesMIT
Tokf Runmpecan/tokf199—~571Automated safety check: PassMIT

Similar skills

  • Reflexo Release

    Myriad-Dreamin/typst.ts

    Guide Reflexo/typst.ts release preparation and operator handoffs.

    1.2k GitHub stars~1.5k tokensUpdated 3 days ago
    DevOps & CloudAuto-check passed

  • Os Eco Dep Sync

    jayminwest/warren

    Bump warren onto the latest published @os-eco/ versions across package.json + bun.lock and the Dockerfile CLI pins, then run the gates and open a PR.

    481 GitHub stars~1.9k tokensUpdated yesterday
    DevOps & CloudAuto-check passed

  • Ddev

    haxtheweb/haxcms-php

    DDEV local development environment guidance for Docker-based PHP/Node projects.

    130 GitHub stars~1.6k tokensUpdated yesterday
    DevOps & CloudAuto-check passed

  • Data Processing

    aiskillstore/marketplace

    Process JSON with jq and YAML/TOML with yq. An agent skill from aiskillstore/marketplace.

    433 GitHub starsUsed in 1 repo~720 tokens
    DevOps & CloudAuto-check: notes

  • Tokf Run

    mpecan/tokf

    Compress verbose CLI output with tokf before returning results.

    199 GitHub stars~571 tokensUpdated yesterday
    DevOps & CloudAuto-check passed

  • Docker Build Strategies

    docker/skills

    Official

    A skill your agent uses when writing, reviewing, or optimizing Dockerfiles, even if the user just says their image is too large, their build is slow, or they need to harden a container for production.

    552 GitHub stars~3k tokensUpdated 6 days ago
    DevOps & CloudAuto-check: warnings

More from rome-os/rome

All 18 skills in this repo

  • Color Audit

    rome-os/rome

    Audit a design system's color palette against measurable color-science disciplines — WCAG/APCA contrast of declared token pairs, perceptual (OKLCH) ramp uniformity, color-blindness safety of…

    748 GitHub stars~2.7k tokensUpdated today
    Auto-check passed

  • Secondary Text Audit

    rome-os/rome

    Audit the subordinate copy in a UI — section descriptions, field helper text, hints, card subtitles, empty-state body copy, tooltip bodies — against the secondary-text ruleset, and emit a per-string…

    748 GitHub stars~2.8k tokensUpdated today
    Auto-check passed

  • UX Semantics Audit

    rome-os/rome

    Audit an existing UI/UX design (React/JSX/TSX components, HTML, or generated app code) against a tiered ruleset of verifiable UX principles, and produce structured, evidence-cited findings that a…

    748 GitHub stars~2.1k tokensUpdated today
    Auto-check passed

  • Add OAuth Integration

    rome-os/rome

    Add a new Rome-managed OAuth integration for a third-party service so a user can delegate access by clicking Connect, and Rome can act on the service with the delegated token (the GitHub/Slack model…

    748 GitHub stars~3.6k tokensUpdated today
    Auto-check passed

  • Composio CLI

    rome-os/rome

    Help users operate the published Composio CLI to find the right tool, connect accounts, inspect schemas, execute tools, subscribe to trigger events with composio listen, script workflows with…

    748 GitHub stars~2.7k tokensUpdated today
    Auto-check passed

  • File Issue

    rome-os/rome

    File one GitHub issue from a description the user gives — classify it as a bug report, feature request, or task spec, gather what the body needs from the tracker and the code, ask the user only for…

    748 GitHub stars~1.7k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Release Rome Image

What does Release Rome Image do?

Release a new Rome runtime image by pushing a vX.Y.Z tag — pick the version, verify main is releasable, push the tag, and confirm the image published to Docker Hub. Release Rome Image is an agent skill from rome-os/rome.Z tag — pick the version, verify main is releasable, push the tag, and confirm the image published to Docker Hub.

When should I use Release Rome Image?

Release Rome Image fits situations like: tasks that involve Containers.

How do I install Release Rome Image in Claude Code?

Run `npx skills add rome-os/rome --skill release-rome-image -a claude-code`. Or copy the skill folder (.claude/skills/release-rome-image in rome-os/rome) into .claude/skills/release-rome-image in your project. Claude Code loads it when a task matches its description.

How do I install Release Rome Image in Codex?

Run `npx skills add rome-os/rome --skill release-rome-image -a codex`. Or copy the skill folder (.claude/skills/release-rome-image in rome-os/rome) into .agents/skills/release-rome-image in your project. Codex loads it when a task matches its description.

Can I use Release Rome Image 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 rome-os/rome --skill release-rome-image -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/release-rome-image, .gemini/skills/release-rome-image, .github/skills/release-rome-image and .opencode/skills/release-rome-image in your project.

What does Release Rome Image need to run?

Going by SKILL.md and its folder, Release Rome Image needs the command-line tools its instructions call (git, gh, curl and jq). Our summary lists: Docker.

Does Release Rome Image access the network?

SKILL.md names 1 domain. In commands or code: hub.docker.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Release Rome Image 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 Release Rome Image use?

Release Rome Image is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Release Rome Image use?

About 910 tokens (SKILL.md is roughly 3.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 Release Rome Image?

Skills that share tags, products or a category with Release Rome Image: Reflexo Release (Myriad-Dreamin/typst.ts, 1.2k stars), Os Eco Dep Sync (jayminwest/warren, 481 stars), Ddev (haxtheweb/haxcms-php, 130 stars) and Data Processing (aiskillstore/marketplace, 433 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Release Rome Image?

rome-os (a GitHub organization) maintains it in rome-os/rome, which has 743 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on October 10, 2026.

Source: rome-os/rome on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.