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.
Herald beta release workflow for requests to cut, tag, publish, or repair a Herald release.
Install Release
$ npx skills add herald-email/herald-mail-app --skill release -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install herald-email/herald-mail-app release --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/herald-email/herald-mail-app.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/release .claude/skills/release && rm -rf skills-srcUse ~/.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/
Install the "release" agent skill from https://github.com/herald-email/herald-mail-app/tree/main/.agents/skills/release into .claude/skills/release/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "release", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/herald-email/herald-mail-app/tree/main/.agents/skills/releaseType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add herald-email/herald-mail-app --skill release -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install herald-email/herald-mail-app release --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/herald-email/herald-mail-app.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/release .agents/skills/release && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "release" agent skill from https://github.com/herald-email/herald-mail-app/tree/main/.agents/skills/release into .agents/skills/release/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "release", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add herald-email/herald-mail-app --skill release -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install herald-email/herald-mail-app release --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/herald-email/herald-mail-app.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/release .cursor/skills/release && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "release" agent skill from https://github.com/herald-email/herald-mail-app/tree/main/.agents/skills/release into .cursor/skills/release/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "release", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/herald-email/herald-mail-app.git --path .agents/skills/release--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add herald-email/herald-mail-app --skill release -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install herald-email/herald-mail-app release --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/herald-email/herald-mail-app.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/release .gemini/skills/release && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "release" agent skill from https://github.com/herald-email/herald-mail-app/tree/main/.agents/skills/release into .gemini/skills/release/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "release", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install herald-email/herald-mail-app releaseInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add herald-email/herald-mail-app --skill release -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/herald-email/herald-mail-app.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/release .github/skills/release && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "release" agent skill from https://github.com/herald-email/herald-mail-app/tree/main/.agents/skills/release into .github/skills/release/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "release", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add herald-email/herald-mail-app --skill release -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install herald-email/herald-mail-app release --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/herald-email/herald-mail-app.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/release .opencode/skills/release && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "release" agent skill from https://github.com/herald-email/herald-mail-app/tree/main/.agents/skills/release into .opencode/skills/release/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "release", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
release- GitHub stars
- 145
- Token cost
- ~2.2k tokens
- SKILL.md length
- 1,047 words
- Files
- 2
- Skills in repo
- 7
- Repo updated
- First seen
- Licence
- Custom licence
At a glance
Herald beta release workflow for requests to cut, tag, publish, or repair a Herald release.
- Works in 8 steps: Release only from a clean main checkout… → Fetch tags before deciding the next… → Review every meaningful change between… → …
- Codex should read RELEASE.md
- SKILL.md covers Required Reads, Release Contract, Review Changes and Recommend Version, plus 8 more sections
- Calls git, gh and make
What it does
Release is an agent skill from herald-email/herald-mail-app. Herald beta release workflow for requests to cut, tag, publish, or repair a Herald release. Use when Codex should read RELEASE.md, review changes since the last tag, recommend the next v0.X.Y-beta.Z version, update What's New docs pages, create and push an annotated tag, monitor CI/CD, fix release blockers, move or supersede the tag when appropriate, and write release notes.
Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).
It sits in Development, covering Changelog and release notes and CI/CD. The repository describes itself as: Herald is a terminal email client and inbox cleanup tool with IMAP, AI-assisted triage, MCP tools, and SSH/browser-friendly app modes.
When your agent uses it
- Codex should read RELEASE.md
- Review changes since the last tag
- Recommend the next v0.X.Y-beta.Z version
- Update Whats New docs pages
Example prompts
- “/release”
Workflow steps
8 steps, taken from the first numbered list in SKILL.md.
- Release only from a clean main checkout unless the user explicitly gives a different tag source.
- Fetch tags before deciding the next version.
- Review every meaningful change between the last version tag and HEAD before recommending a version.
- Present the recommended version and rationale before creating or pushing a tag, unless the user has already supplied an exact tag and…
- Use annotated tags in the exact shape v0.X.Y-beta.Z with message Herald v0.X.Y-beta.Z.
- Treat immutable beta tags as public once release assets are published or testers may have downloaded them. In that case, publish a new…
- Do not manually create, edit, or push beta-latest; the GitHub Actions release workflow owns it.
- Treat local beta-latest tag drift during fetch as expected workflow-owned state. Do not call it a release hiccup, do not manually touch…
What it can do on your machine
Read from SKILL.md and the folder at commit b097c04. 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:
gitghmakenpm
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use git, gh and npm, 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 2.2k tokens when it runs. Until then it costs about 96 tokens; SKILL.md has 1,047 words of instructions outside code blocks.
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
Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,047 words (~2,208 tokens).
“Use this skill to publish Herald beta releases. The authoritative runbook is RELEASE.md; read it at the start of every release and let it override stale instructions here.”
- name
- release
Files
SKILL.md and 1 other file in .agents/skills/release of herald-email/herald-mail-app.
- SKILL.md
- agents/openai.yaml
Open the folder on GitHubat commit b097c04
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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Release this skillherald-email/herald-mail-app | 145 | — | ~2.2k | Automated safety check: Pass | Custom licence | |
| Mole CLI Release Flowtw93/Mole | 70k | — | ~2.5k | Automated safety check: Pass | GPL-3.0 | |
| Worktrunk Release Workflowmax-sixty/worktrunk | 9k | — | ~6.9k | Automated safety check: Pass | Custom licence | |
| Cline Desktop App Releasecline/cline | 70k | — | ~4.5k | Automated safety check: Pass | Apache-2.0 | |
| EverOS Release WorkflowEverMind-AI/EverOS | 13k | — | ~1.3k | Automated safety check: Pass | Apache-2.0 | |
| ReleaseXGHeaven/homebox | 817 | — | ~1.4k | Automated safety check: Pass | None |
Similar skills
Worktrunk Release Workflow
max-sixty/worktrunk
Walks a maintainer through cutting a Worktrunk release: sync the release branch, pass two test gates, review the changes, then publish.
Cline Desktop App Release
cline/cline
Covers preparing, tagging and publishing a Cline desktop app release on the stable, beta or nightly channel through the desktop-publish GitHub workflow.
EverOS Release Workflow
EverMind-AI/EverOS
Walks through cutting a versioned everos release: bump the version, update the changelog, tag it, and review the drafted GitHub Release page before publishing.
Release
XGHeaven/homebox
Prepare, verify, and publish Homebox releases through the repository's tag-driven GitHub Actions workflow.
Coffee GB Release
trekawek/coffee-gb
Releases the current Coffee GB Maven snapshot through the GitHub Maven release workflow, then verifies and curates the tag and GitHub release.
More from herald-email/herald-mail-app
Herald Autopilot
herald-email/herald-mail-app
A skill your agent uses when you want one repo-local Herald workflow to take a single bug, feature, or workflow improvement from intake through planning, isolated worktree setup, implementation…
Pre Release Test
herald-email/herald-mail-app
A skill your agent uses when preparing a Herald beta release, checking release readiness, or running broad deterministic integration gates across TUI themes, inline images, SSH, and MCP before…
Approve Gepa Changes
herald-email/herald-mail-app
A skill your agent uses when approving, rejecting, or marking implemented Herald GEPA pending approval items, including requests like "approve GEPA changes", "approve all pending GEPA", or approval…
Finish Development
herald-email/herald-mail-app
Herald-specific completion workflow for requests such as "finish-development", "nice" as a repo completion command, "wrap this branch", "fast merge", "fastpass", "quick merge", "fast mode", or…
Tui Test
herald-email/herald-mail-app
Battle-test terminal UIs such as Herald via tmux and ttyd: reset states, compare visible hotkeys with actual behavior, capture ANSI/PNG evidence, run resize soaks, and verify terminal raster image…
Tui Test
herald-email/herald-mail-app
Battle-test the Herald TUI — automated exploratory testing that captures screens, detects visual defects programmatically, and digs into anything suspicious.
Related
Categories
Questions about Release
What does Release do?
Herald beta release workflow for requests to cut, tag, publish, or repair a Herald release. Release is an agent skill from herald-email/herald-mail-app. Herald beta release workflow for requests to cut, tag, publish, or repair a Herald release.
When should I use Release?
Release fits situations like: Codex should read RELEASE.md; review changes since the last tag; recommend the next v0.X.Y-beta.Z version; update Whats New docs pages.
How do I install Release in Claude Code?
Run `npx skills add herald-email/herald-mail-app --skill release -a claude-code`. Or copy the skill folder (.agents/skills/release in herald-email/herald-mail-app) 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 herald-email/herald-mail-app --skill release -a codex`. Or copy the skill folder (.agents/skills/release in herald-email/herald-mail-app) 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 herald-email/herald-mail-app --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 (git, gh, make and npm).
Does Release access the network?
SKILL.md contains no URLs. Its commands use git, gh and npm, 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 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 use?
Release has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.
How many tokens does Release use?
About 2.2k tokens (SKILL.md is roughly 8.8k 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: Mole CLI Release Flow (tw93/Mole, 70k stars), Worktrunk Release Workflow (max-sixty/worktrunk, 9k stars), Cline Desktop App Release (cline/cline, 70k stars) and EverOS Release Workflow (EverMind-AI/EverOS, 13k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Release?
herald-email (a GitHub organization) maintains it in herald-email/herald-mail-app, which has 145 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on July 13, 2026.
Source: herald-email/herald-mail-app on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.