Agent skill

Release

by TypedDevs in TypedDevs/bashunit

Run pre-release validation and execute the release process. An agent skill from TypedDevs/bashunit.

MITAuto-check: notesDevelopment

Install Release

skills CLI
$ npx skills add TypedDevs/bashunit --skill release -a claude-code

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

GitHub CLI
$ gh skill install TypedDevs/bashunit release --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/TypedDevs/bashunit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/release .claude/skills/release && 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
GitHub stars
434
Token cost
~618 tokens
SKILL.md length
221 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Run pre-release validation and execute the release process. An agent skill from TypedDevs/bashunit.

  • Works in 4 steps: Pre-flight → Pick the version → Preview, then publish → …
  • Tasks that involve Deployment
  • SKILL.md covers Current State, Steps, Recovery and Example Usage
  • Calls gh, git and make

What it does

Release is an agent skill from TypedDevs/bashunit. Run pre-release validation and execute the release process

Its SKILL.md is about 620 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 Deployment. It works with Bash and npm. The repository describes itself as: A simple yet powerfull testing library for bash scripts. The licence is MIT.

When your agent uses it

  • Tasks that involve Deployment

Example prompts

  • “/release”

Requirements

  • Pre-approved tools (allowed-tools): Bash, Read, Grep, Glob

Workflow steps

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

  1. Pre-flight
  2. Pick the version
  3. Preview, then publish
  4. Verify the published artifacts

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Grep
    • Glob

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • gh
    • git
    • make

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

  • Network

    No URLs in SKILL.md. Its commands use gh and git, which can reach the network depending on how they are called.

    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 loads about 618 tokens when it runs. Until then it costs about 17 tokens; SKILL.md has 221 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Grep, Glob

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 TypedDevs/bashunit at commit 8f297fb, republished under its MIT licence (© TypedDevs). 221 words, ~618 tokens.

Download SKILL.mdSave it as .claude/skills/release/SKILL.md (or your agent's skills folder).
name
release
description
Run pre-release validation and execute the release process
allowed-tools
Bash, Read, Grep, Glob
user-invocable
true
argument-hint
[version]

Release

Thin reminder around ./release.sh. The release script owns the whole end-to-end flow (version bumps, build, checksum, CHANGELOG, commit, signed tags, push, GitHub release, latest branch). Don't reimplement those steps here — fix release.sh if something is missing.

Current State

  • Current version: !grep -o 'BASHUNIT_VERSION="[^"]*"' bashunit | cut -d'"' -f2
  • Branch: !git branch --show-current
  • Working tree: !git status --short
  • Unreleased changes: !awk '/^## Unreleased$/,/^## \[/' CHANGELOG.md | head -30

Steps

1. Pre-flight
bash
./bashunit tests/                 # all green
make sa && make lint              # static analysis + editorconfig
gh run list --limit 3 --branch main

Stop and report if anything fails. Don't release on a red main.

2. Pick the version

$ARGUMENTS overrides; otherwise the script auto-increments the minor. Bump by the Unreleased section: a ### Added/feat → minor, only ### Fixed → patch. Confirm the version with the user before publishing.

3. Preview, then publish
bash
./release.sh <version> --dry-run   # preview; changes nothing
./release.sh <version> --force     # publish (non-interactive)

Notes:

  • --dry-run release notes look "off" (they show the previous version's section) because the CHANGELOG isn't actually rewritten in a dry run. The real run converts ## Unreleased → ## [<version>] first, so the published notes are correct. Not a bug.
  • Tagging is gpgsign-safe: release::create_tags makes annotated, -m tags (signed when tag.gpgsign=true) and pins v0 to the release commit (^{}). No manual tagging needed.
  • npm publishes automatically via .github/workflows/npm-publish.yml on the GitHub release: published event.
4. Verify the published artifacts
bash
gh release view <version>                       # assets: bin/bashunit + bin/checksum
gh run list --workflow npm-publish.yml --limit 1
git log --oneline -1 origin/latest             # latest branch advanced (docs deploy)

Confirm the npm version and the install.sh checksum match, then report the release URL.

Recovery

./release.sh --rollback restores files from the most recent backup if a run fails mid-way.

Example Usage

/release
/release 0.40.0

© TypedDevs, 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 of TypedDevs/bashunit.

Open the folder on GitHubat commit 8f297fb

Compare with similar skills

Release 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Release this skillTypedDevs/bashunit434—~618Automated safety check: NotesMIT
Remotion Bits Releaseav/remotion-bits486—~1.2kAutomated safety check: PassNone
Cline CLI Release Publishercline/cline70k—~3.4kAutomated safety check: WarnApache-2.0
ClawRouter Release ChecklistBlockRunAI/ClawRouter6.6k—~1.4kAutomated safety check: PassMIT
Verify New Sample PRpnp/sp-dev-fx-aces139—~2kAutomated safety check: PassMIT
Uui Release Workflowepam/UUI248—~867Automated safety check: PassMIT

Similar skills

  • Remotion Bits Release

    av/remotion-bits

    Runs the full release of the remotion-bits package: version bump, changelog, registry build, release commit, GitHub release, docs deploy and npm publish.

    486 GitHub stars~1.2k tokensUpdated 22 days ago
    DevelopmentAuto-check passed
  • Walks through releasing the Cline CLI package to npm: release notes, version bump, matching git tag, and either the GitHub workflow or a local publish.

    70k GitHub stars~3.4k tokensUpdated today
    DevelopmentAuto-check: warnings
  • ClawRouter Release Checklist

    BlockRunAI/ClawRouter

    Walks the agent through every ClawRouter release step in order, from the version bump and changelog entry to build, tests, npm publish, git tag and GitHub release.

    6.6k GitHub stars~1.4k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Verify New Sample PR

    pnp/sp-dev-fx-aces

    Verify a "new sample" PR in pnp/sp-dev-fx-aces builds successfully, then produce a deployment + testing checklist from the sample README so it can be manually deployed and tested before merging.

    139 GitHub stars~2k tokensUpdated 9 days ago
    DevelopmentAuto-check passed
  • Guides the UUI package release process including stable and beta releases, changelog updates, and handling failed releases.

    248 GitHub stars~867 tokensUpdated 8 days ago
    DevelopmentAuto-check passed
  • Release Maintainer

    Undertone0809/rudder

    A skill your agent uses when inspecting, preparing, executing, recovering, or verifying Rudder releases across npm, GitHub Releases, Desktop assets, tags, dist-tags, changelogs, Discord…

    292 GitHub stars~2.1k tokensUpdated today
    DevelopmentAuto-check passed

More from TypedDevs/bashunit

All 11 skills in this repo
  • Commit

    TypedDevs/bashunit

    Stage and commit changes using conventional commits format. An agent skill from TypedDevs/bashunit.

    434 GitHub stars~781 tokensUpdated yesterday
    Auto-check: notes
  • Gh Issue

    TypedDevs/bashunit

    Fetch GitHub issue, create branch, plan and implement with TDD, then open PR

    434 GitHub stars~721 tokensUpdated yesterday
    Auto-check: notes
  • Gh Issues

    TypedDevs/bashunit

    Walk over all open GitHub issues that are unassigned or assigned to the current user, and process each one via the /gh-issue skill, sequentially.

    434 GitHub stars~1.7k tokensUpdated yesterday
    Auto-check: notes
  • PR

    TypedDevs/bashunit

    Push branch and create a GitHub PR with concise, issue-linked description

    434 GitHub stars~1k tokensUpdated yesterday
    Auto-check: notes
  • Pre Release

    TypedDevs/bashunit

    Run comprehensive pre-release validation checklist. An agent skill from TypedDevs/bashunit.

    434 GitHub stars~488 tokensUpdated yesterday
    Auto-check: notes
  • Review

    TypedDevs/bashunit

    Review a GitHub pull request; defaults to the current branch's PR when no number is given

    434 GitHub stars~449 tokensUpdated yesterday
    Auto-check: notes

Works with

Questions about Release

What does Release do?

Run pre-release validation and execute the release process. An agent skill from TypedDevs/bashunit. Release is an agent skill from TypedDevs/bashunit.

When should I use Release?

Release fits situations like: tasks that involve Deployment.

How do I install Release in Claude Code?

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

How do I install Release in Codex?

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

Can I use Release 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 TypedDevs/bashunit --skill release -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, .gemini/skills/release, .github/skills/release and .opencode/skills/release in your project.

What does Release need to run?

Going by SKILL.md and its folder, Release needs the command-line tools its instructions call (gh, git and make). Its frontmatter pre-approves these tools: Bash, Read, Grep, Glob.

Does Release access the network?

SKILL.md contains no URLs. Its commands use gh and git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Release safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Release use?

Release 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 use?

About 618 tokens (SKILL.md is roughly 2.5k 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?

Skills that share tags, products or a category with Release: Remotion Bits Release (av/remotion-bits, 486 stars), Cline CLI Release Publisher (cline/cline, 70k stars), ClawRouter Release Checklist (BlockRunAI/ClawRouter, 6.6k stars) and Verify New Sample PR (pnp/sp-dev-fx-aces, 139 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Release?

TypedDevs (a GitHub organization) maintains it in TypedDevs/bashunit, which has 434 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 6, 2026.

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