release-version

release-version is a skill for Claude Code, Codex from Byte-n/larkDocx2md. It costs 59 tokens per session (707 once invoked), scanned A, original, ISC.

A guided workflow for releasing a new version of a software project. It covers checking changes, updating the changelog, changing the version, committing the release, and building the project.

In plain words
What is it for?
For preparing a project release: reviewing Git changes, choosing a version, creating a release branch, updating CHANGELOG.md and package.json, committing, and running the build.
Why use it?
It gives release work a fixed sequence and pauses for decisions such as the version number and whether to commit changes. It also applies a special rule for skipping version numbers that contain the digit 4.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/byte-n/larkdocx2md/release-version
Any agent
npx skills add Byte-n/larkDocx2md --skill release-version
Clone the repo
git clone --depth 1 https://github.com/Byte-n/larkDocx2md

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for release-version

README.md
[![agentmods](https://agentmods.dev/badge/skills/byte-n/larkdocx2md/release-version.svg)](https://agentmods.dev/skills/byte-n/larkdocx2md/release-version)
Your own site
<a href="https://agentmods.dev/skills/byte-n/larkdocx2md/release-version"><img src="https://agentmods.dev/badge/skills/byte-n/larkdocx2md/release-version.svg" alt="Measured on agentmods" height="20"></a>
Per session 59 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 707 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00059 $0.00707
Opus 5 $0.00030 $0.00353
Sonnet 5 $0.00012 $0.00141
Haiku 4.5 $0.00006 $0.00071

Measured 4d ago against content hash da15370b3f18, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

release-version scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/release-version/SKILL.md · 60 lines

What it actually says

Release Version Workflow

严格按序执行,每步执行完简短反馈;需用户决策的节点(提交改动、确认版本号、同名分支复用)必须等待确认。

版本号规则

任何版本段(major/minor/patch)的十进制字符串含字符 4 即跳过。例:

  • 0.3.3 → 0.3.50.3.9 → 0.5.00.13 → 0.150.39 → 0.503 → 5

等级判定:feat/新 API → minor;fix/文档/测试 → patch;破坏性变更 → major。

流程

1. 检查工作区git status --porcelain。有改动则建议 commit 命令(feat/fix/docs/test/chore + 中文简短描述)并询问是否提交。

2. 汇总变更

git describe --tags --abbrev=0
git log <last-tag>..HEAD --oneline --no-decorate

按 Features / Changed / Fixed / Removed 分组,面向用户可见行为。

3. 确定新版本号:按上述规则计算,与用户确认。

4. 切版本分支git checkout -b release/v<版本>。同名分支存在先确认;用 git branch --show-current 验证。

5. 更新 CHANGELOG.md:在 # Changelog 下方插入新段落,风格对齐已有版本:

## <版本>

### Features
- **要点**:...

无该类变更则省略小节;中文描述;不写时间戳。

6. 评估 README.md:从本次 Features/Changed 中提取面向用户可见的功能点与新特性,对照 README.md 现有内容判断是否需要更新(如新增功能介绍、用法示例、配置项、CLI 参数、兼容性说明等)。

  • 需更新:列出具体改动点并与用户确认后再修改。
  • 无需更新(仅内部重构/测试/文档微调):简短说明理由后跳过。

7. 更新 package.json:仅改 "version" 字段。

8. 提交

git add CHANGELOG.md package.json README.md
git commit -m "release: <版本>"

(若 README.md 未改动则从 git add 中省略。)

9. 构建pnpm run build。失败立即停止。

10. 输出发布命令(不自动执行):

git push -u origin release/v<版本>
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 60 lines · 59 tokens per session scan A da15370b3f18

Subscribe to this mod's changes

release-version is a skill published in the GitHub repository Byte-n/larkDocx2md (31 stars, last pushed 20d ago), licensed ISC. It adds 59 tokens to every session and 707 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

release

Cut a Symphony release by bumping the committed version, landing it, tagging the merged commit, and verifying the Burrito release workflow. Use when asked to release, tag, or retag Symphony.

openai/symphony · 42 tokens

changelog-entry

Add a new entry to CHANGELOG.yml under the current unreleased version (or create the version block if needed), then regenerate documentation. Use when the user says things like "add a changelog entry", "log this fix in the changelog", or "/changelog-entry".

telepresenceio/telepresence · 60 tokens

release-notes

Generate user-facing release notes from tickets, PRDs, or changelogs. Creates clear, engaging summaries organized by category (new features, improvements, fixes). Use when writing release notes, creating changelogs, announcing product updates, or summarizing what shipped.

phuryn/pm-skills · 57 tokens

mate-oss-gate

在准备把 MateCloud(或其子集)开源 / 发布到公开仓前使用。按 open-core 边界把关:剥离企业代码、清竞品名与内部路径、查密钥、确认 LICENSE。当用户说"要开源了""发布公开版""开源前检查""oss release"时触发。.

mateaix/matecloud · 81 tokens

snapshot-release

Drives the snapshot-release flow for the current branch's PR. Posts a /snapshot comment on the PR if one isn't already there (with confirmation), waits for the Continuous Releases workflow to finish, and reports the tarball URLs from the resulting 📦 Snapshot Release comment. Use for both triggering and waiting …

daangn/seed-design · 142 tokens

devops/changelog-generation

自动生成 CHANGELOG,基于 git 提交历史和 pipeline 产物信息,遵循 Conventional Commits 和 Keep a Changelog 规范.

echoVic/boss-skill · 36 tokens