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

Bump Version

by termio-sh in termio-sh/termio

Cut a new termio macOS release by tagging main with the next version.

MITAuto-check passedDevelopment

Install Bump Version

skills CLI
$ npx skills add termio-sh/termio --skill bump-version -a claude-code

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

GitHub CLI
$ gh skill install termio-sh/termio bump-version --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/termio-sh/termio.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/bump-version .claude/skills/bump-version && 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
bump-version
GitHub stars
540
Token cost
~1.1k tokens
SKILL.md length
469 words
Files
1
Skills in repo
19
Repo updated
First seen
Licence
MIT

At a glance

Cut a new termio macOS release by tagging main with the next version.

  • Works in 6 steps: Preconditions → Pick the next version → Write the changelog entry → …
  • Says bump version
  • SKILL.md covers 1. Preconditions, 2. Pick the next version, 3. Write the changelog entry and 4. Tag and push, plus 4 more sections
  • Calls git, gh and curl; reaches downloads.termio.sh

What it does

Bump Version is an agent skill from termio-sh/termio. Cut a new termio macOS release by tagging main with the next version. Invoke when the user says 'bump version', 'bump the version', 'cut a release', 'ship a new version', 'release', '发版', '发布新版本', or '出个新版本'.

Its SKILL.md is about 1.1k 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 Development, covering Changelog and release notes. It works with macOS. The repository describes itself as: A terminal-first agentic development environment for agentic coding. Build for CLI/TUI agent. Runtime for Coding Agent, Tmux alternative. The licence is MIT.

When your agent uses it

  • Says bump version
  • Bump the version
  • Ship a new version

Example prompts

  • “bump version”
  • “bump the version”
  • “cut a release”
  • “/bump-version”

Workflow steps

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

  1. Preconditions
  2. Pick the next version
  3. Write the changelog entry
  4. Tag and push
  5. Watch the Release workflow
  6. Verify (when green)

What it can do on your machine

Read from SKILL.md and the folder at commit af3b35b. 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
    • pnpm

    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:

    • downloads.termio.sh

    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

Bump Version loads about 1.1k tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 469 words of instructions outside code blocks.

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

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 termio-sh/termio at commit af3b35b, republished under its MIT licence (© termio-sh). 469 words, ~1,079 tokens.

Download SKILL.mdSave it as .claude/skills/bump-version/SKILL.md (or your agent's skills folder).
name
bump-version
description
Cut a new termio macOS release by tagging main with the next version. Invoke when the user says 'bump version', 'bump the version', 'cut a release', 'ship a new version', 'release', '发版', '发布新版本', or '出个新版本'.

Bump version — cut a termio release

termio is trunk-based: a release is nothing but a vX.Y.Z tag on main. Pushing the tag fires .github/workflows/release.yml (the Release workflow), which signs, notarizes, packages the DMG, updates the Sparkle appcast, and uploads to Cloudflare R2. There is no merge and no release branch.

Follow these steps in order. Stop and report if any precondition fails — never force past a failed check.

1. Preconditions

sh
git switch main
git pull --ff-only
git status --short          # release-relevant work must be committed
git rev-parse --abbrev-ref HEAD    # must print: main
  • Must be on main and even with origin/main (the tag ships whatever main points at right now).
  • The working tree may have unrelated untracked scratch files, but anything meant for this release must already be committed and pushed.

2. Pick the next version

Read the current version and compute the next one:

sh
git tag --list 'v*' --sort=-v:refname | head -1     # e.g. v0.13.1

Decide X.Y.Z (semver, no v when talking, v in the tag):

  • Explicit version from the user (e.g. "0.14.0") → use it verbatim.
  • A bump keyword → apply it to the latest tag: patch (0.13.1→0.13.2), minor (0.13.1→0.14.0), major (0.13.1→1.0.0).
  • Nothing specified → propose the bump you believe fits (termio has used minor for features, patch for fixes) and confirm the number with the user before tagging.

The version must only ever go up — the build number is git rev-list --count HEAD, and Sparkle treats a lower CFBundleVersion as older, which breaks auto-update. Never reuse or lower a version.

3. Write the changelog entry

The site's changelog is web/landing/src/data/changelog.ts, newest entry first. Add the entry for the version you are about to tag before tagging — the Docs workflow fails once a tag exists without one, and a changelog that trails the releases makes the site read as abandoned.

sh
gh release view "v$PREVIOUS" --json body -q .body     # what shipped since

Write it in the file's voice: a title naming what the release is remembered for, then short user-facing new / improved / fixed lines — what changed, not how. Skip a release whose only changes were docs, deps, or the landing page.

sh
cd web/landing && pnpm docs:check     # must pass before you tag
Show full SKILL.md (165 more words)Show less

4. Tag and push

sh
V=0.14.0                       # the version you settled on
git tag "v$V"
git push origin "v$V"

That push is what triggers the release. Nothing else in the repo needs editing — the tag is the version.

5. Watch the Release workflow

sh
gh run watch --repo termio-sh/termio \
  "$(gh run list --repo termio-sh/termio -w Release -L1 --json databaseId -q '.[0].databaseId')"

Report green/red to the user. If it fails, diagnose from the run log; the troubleshooting table is in docs/runbook/macos-release-runbook.md.

6. Verify (when green)

sh
V=0.14.0
curl -sI https://downloads.termio.sh/termio.dmg     | head -1   # 200
curl -sI https://downloads.termio.sh/v$V/termio.dmg | head -1   # 200
curl -s  https://downloads.termio.sh/appcast.xml | grep -i shortVersionString | head -1

The newest appcast item should advertise the new version. Full verification (staple check, Gatekeeper, Sparkle end-to-end) lives in the runbook.

Re-running a failed release

If the build failed for an infrastructure reason (a secret, a flaky runner) and main is unchanged, delete and re-push the same tag — the version must not go backwards:

sh
git push --delete origin "v$V" && git tag -d "v$V"
git tag "v$V" && git push origin "v$V"

If code had to change to fix it, that's a new commit on main, so cut the next version instead of reusing the tag.

Notes

  • iOS releases are separate (.github/workflows/ios.yml + TestFlight); this skill is the macOS tag flow only.
  • This skill does not commit anything. Land the release's code on main first (directly or via a merged PR), then run this.

© termio-sh, 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 skills/bump-version of termio-sh/termio.

Open the folder on GitHubat commit af3b35b

Compare with similar skills

Bump Version 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.

Bump Version compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bump Version this skilltermio-sh/termio540—~1.1kAutomated safety check: PassMIT
Mole CLI Release Flowtw93/Mole70k—~2.5kAutomated safety check: PassGPL-3.0
Releaseeugene1g/agent-safehouse2.1k—~3.5kAutomated safety check: PassApache-2.0
Sc Skilljazzyalex/agent-sessions893—~884Automated safety check: PassMIT
Pulse Releasequnqin24/Pulse516—~1.3kAutomated safety check: PassApache-2.0
Releaseddalcu/mlx-serve1.8k—~1.8kAutomated safety check: PassCustom licence

Similar skills

  • Mole CLI Release Flow

    tw93/Mole

    Runbook for assessing and executing a Mole CLI release: distribution channels, pre-flight checks, capital-V tags, build artifacts and the handoff to curated release notes.

    70k GitHub stars~2.5k tokensUpdated today
    DevelopmentAuto-check passed

  • Release

    eugene1g/agent-safehouse

    Run the local Agent Safehouse release flow: inspect commits since the last published release, propose the next SemVer version and changelog, present a dry-run for confirmation, then update…

    2.1k GitHub stars~3.5k tokensUpdated 8 days ago
    DevelopmentAuto-check passed

  • Sc Skill

    jazzyalex/agent-sessions

    Capture deterministic macOS screenshots for testing, docs, release notes, and marketing assets.

    893 GitHub stars~884 tokensUpdated today
    DevelopmentAuto-check passed

  • Pulse Release

    qunqin24/Pulse

    Release a new Pulse version end to end — checks, bilingual CHANGELOG entry, VERSION, tag, the release workflow, syncing main, and the issue replies that go with it.

    516 GitHub stars~1.3k tokensUpdated yesterday
    DevelopmentAuto-check passed

  • Release

    ddalcu/mlx-serve

    mlx-serve pre-release validation checklist, CalVer versioning, release steps, and CHANGELOG style.

    1.8k GitHub stars~1.8k tokensUpdated today
    DevelopmentAuto-check passed

  • Megaphone Release

    Kuberwastaken/megaphone

    Prepare, validate, publish, and verify Megaphone releases. An agent skill from Kuberwastaken/megaphone.

    169 GitHub stars~1.3k tokensUpdated 2 mo ago
    DevelopmentAuto-check passed

More from termio-sh/termio

All 19 skills in this repo

  • Termio Bug Report

    termio-sh/termio

    Diagnose a termio hang, beachball, crash, or 'it froze again' from the evidence macOS and termio actually leave behind — live process samples, crash and CPU-burn reports, the unified log, the…

    540 GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed

  • App Screenshot Debug

    termio-sh/termio

    Drive the running termio app via AppleScript / System Events to reach a UI state (focus the window, click a sidebar project, a terminal pane, a control), capture a pixel-accurate screenshot of just…

    540 GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed

  • Dia Source Analysis

    termio-sh/termio

    Analyze / reverse-engineer the locally installed Dia Browser mac app (The Browser Company; bundle id company.thebrowser.dia; shares ArcCore with Arc).

    540 GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed

  • Asc

    termio-sh/termio

    Drive App Store Connect from the terminal with the asc CLI — TestFlight builds, groups, testers and What to Test notes; App Store versions, metadata, keywords, screenshots and release notes…

    540 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed

  • Issue Creator

    termio-sh/termio

    Turn vague customer or user feedback from pasted text, chat excerpts, or screenshots into a clear, evidence-backed GitHub issue without inventing requirements.

    540 GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed

  • Og Generation

    termio-sh/termio

    Regenerate the landing site's OG/social card (web/landing/public/og.webp) by rendering a temporary in-app route with the real hero WebGL aurora and screenshotting it with headless Chrome.

    540 GitHub stars~1k tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Bump Version

What does Bump Version do?

Cut a new termio macOS release by tagging main with the next version. Bump Version is an agent skill from termio-sh/termio. Cut a new termio macOS release by tagging main with the next version.

When should I use Bump Version?

Bump Version fits situations like: says bump version; bump the version; ship a new version.

How do I install Bump Version in Claude Code?

Run `npx skills add termio-sh/termio --skill bump-version -a claude-code`. Or copy the skill folder (skills/bump-version in termio-sh/termio) into .claude/skills/bump-version in your project. Claude Code loads it when a task matches its description.

How do I install Bump Version in Codex?

Run `npx skills add termio-sh/termio --skill bump-version -a codex`. Or copy the skill folder (skills/bump-version in termio-sh/termio) into .agents/skills/bump-version in your project. Codex loads it when a task matches its description.

Can I use Bump Version 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 termio-sh/termio --skill bump-version -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bump-version, .gemini/skills/bump-version, .github/skills/bump-version and .opencode/skills/bump-version in your project.

What does Bump Version need to run?

Going by SKILL.md and its folder, Bump Version needs the command-line tools its instructions call (git, gh, curl and pnpm).

Does Bump Version access the network?

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

Is Bump Version 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 Bump Version use?

Bump Version 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 Bump Version use?

About 1.1k tokens (SKILL.md is roughly 4.3k 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 Bump Version?

Skills that share tags, products or a category with Bump Version: Mole CLI Release Flow (tw93/Mole, 70k stars), Release (eugene1g/agent-safehouse, 2.1k stars), Sc Skill (jazzyalex/agent-sessions, 893 stars) and Pulse Release (qunqin24/Pulse, 516 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bump Version?

termio-sh (a GitHub organization) maintains it in termio-sh/termio, which has 540 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 7, 2026.

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