Agent skill

Version Bump

by Kindness-Kismet in Kindness-Kismet/only_player

更新 Only Player 版本号、整理更新日志并创建版本提交。用户说「更新版本号」「提高版本号」「版本号提升」或「version bump」时使用。

GPL-3.0Auto-check passedMobile

Install Version Bump

skills CLI
$ npx skills add Kindness-Kismet/only_player --skill version-bump -a claude-code

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

GitHub CLI
$ gh skill install Kindness-Kismet/only_player version-bump --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/Kindness-Kismet/only_player.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/version-bump .claude/skills/version-bump && 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
version-bump
GitHub stars
455
Token cost
~707 tokens
SKILL.md length
208 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
GPL-3.0

At a glance

更新 Only Player 版本号、整理更新日志并创建版本提交。用户说「更新版本号」「提高版本号」「版本号提升」或「version bump」时使用。

  • Works in 2 steps: CHANGELOG.md 默认整体重写,不是追加。… → 每条日志写的是功能现在的最终样子,不是这次做了哪些操作。 同一功能/bug…
  • Mobile work in your project
  • SKILL.md covers ⚠️ 两条最容易被忘记的规则, 流程, 更新日志格式 and 两端同步
  • Calls gh and git

What it does

Version Bump is an agent skill from Kindness-Kismet/only_player. 更新 Only Player 版本号、整理更新日志并创建版本提交。用户说「更新版本号」「提高版本号」「版本号提升」或「version bump」时使用。

Its SKILL.md is about 710 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 Mobile. It works with Gradle and Android. The licence is GPL-3.0.

When your agent uses it

  • Mobile work in your project

Example prompts

  • “/version-bump”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. CHANGELOG.md 默认整体重写,不是追加。 它是“这次发布”的说明书,不是历史累积日志——默认清空旧内容,只写本次区间的变更。仅当用户在本次对话中明确要求“这次用追加”时才允许追加,且只对本次生效,下次执行不参考上次的选择,仍然默认重写。
  2. 每条日志写的是功能现在的最终样子,不是这次做了哪些操作。 同一功能/bug 在区间内被改了不止一次,只写一条,描述改完之后的最终效果,不按 commit 顺序拆开写。

What it can do on your machine

Read from SKILL.md and the folder at commit 89e0de6. 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:

    • gh
    • git

    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

Version Bump loads about 707 tokens when it runs. Until then it costs about 22 tokens; SKILL.md has 208 words of instructions outside code blocks.

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

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 Kindness-Kismet/only_player at commit 89e0de6, republished under its GPL-3.0 licence (© Kindness-Kismet). 208 words, ~707 tokens.

Download SKILL.mdSave it as .claude/skills/version-bump/SKILL.md (or your agent's skills folder).
name
version-bump
description
更新 Only Player 版本号、整理更新日志并创建版本提交。用户说「更新版本号」「提高版本号」「版本号提升」或「version bump」时使用。

⚠️ 两条最容易被忘记的规则

  1. CHANGELOG.md 默认整体重写,不是追加。 它是“这次发布”的说明书,不是历史累积日志——默认清空旧内容,只写本次区间的变更。仅当用户在本次对话中明确要求“这次用追加”时才允许追加,且只对本次生效,下次执行不参考上次的选择,仍然默认重写。
  2. 每条日志写的是功能现在的最终样子,不是这次做了哪些操作。 同一功能/bug 在区间内被改了不止一次,只写一条,描述改完之后的最终效果,不按 commit 顺序拆开写。

流程

  1. 读取 app/build.gradle.kts 中的 versionCode 和 versionName
  2. 检查是否存在未提交内容;如果有,先根据其更改内容执行格式化、校验并提交,提交必须只包含这些业务改动,不得把版本号与 changelog 混入同一个提交
  3. 执行 ./gradlew versionCatalogUpdate,更新 gradle/libs.versions.toml 中可升级的版本与插件声明
  4. 检查 gradle/libs.versions.toml 是否仍保留构建脚本依赖的自定义版本别名;若 versionCatalogUpdate 删除了 android-compileSdk、android-targetSdk、android-minSdk、android-jvm 这类项目自定义键,必须立即补回,保证构建脚本访问器不失效
  5. 确定新版本号:
    • 默认:patch +1(如 1.0.3 → 1.0.4),versionCode +1
    • 用户指定了具体版本号时,使用用户指定的版本
  6. 通过 git log 查找上一次版本号提升的 commit,收集此后所有变更
  7. 归纳为面向用户的功能描述,忽略纯重构、CI 修复、GitHub Action、发布脚本、代码风格、调试指令等不影响普通用户体验的改动。同一功能被多次改动时合并为一条最终效果描述,不要按 commit 拆开写
  8. 识别本次版本涉及的 GitHub issue。不得只 grep commit 信息里的 #编号——开发时往往没写编号,只看 commit 会漏掉本次实际解决的 issue:
    • 先用 gh issue list --state open --limit 100 --json number,title 列出全部未关闭 issue
    • 拿第 7 步归纳出的每条用户可见改动,与每个 open issue 的标题逐一比对,挑出主题相关的候选
    • 对每个候选用 gh issue view <编号> --json title,body,state 读原文,再核对本次改动是否完整满足其要求
    • 只有在 issue 要求被本次改动完整满足时,提交信息才允许追加 close #xxxx
    • 若只是部分满足、实现方式与 issue 期望不一致,或无法证明已完整满足,则不要追加 close #xxxx
    • 得出「本次无关联 issue」这个结论前,必须已经列过 open issue 并逐条比对过,不能因为 commit 里没有编号就直接下结论
  9. 修改 app/build.gradle.kts 的 versionCode 和 versionName
  10. 更新 .github/CHANGELOG.md:
    • 默认整体重写:清空旧内容,只保留上一次版本号提升 commit 之后到当前版本的变更
    • 仅当用户本次明确要求追加时,保留旧内容并把本次变更追加进去;没有明确要求就一律重写,不要因为上次是追加就顺着延续
  11. 执行自动格式化与校验指令,至少运行 ./gradlew ktlintFormat ktlintCheck
  12. 版本号与 changelog 更新后必须及时提交,提交信息基础格式:chore: bump version to {version} and update changelog
    • 仅当第 8 步确认完整满足某个 issue 时,才在提交信息末尾追加 close #xxxx
  13. 提交前自检:
    • 本次是重写还是追加?没有用户明确要求追加的话必须是整体重写,文件里不能有本次区间之外的旧版本条目
    • 每条日志是否是最终效果,而不是按 commit 罗列的过程?重复/互相修正的条目合并成一条
    • 中英文条目一一对应、数量一致
    • close #xxxx 都基于 gh 读到的 issue 原文核实过,不是凭印象加的
    • 是否执行过 gh issue list 并把每条改动与 open issue 标题比对过?只 grep commit 编号不算做过第 8 步
    • 任一项不通过,回到对应步骤重做

更新日志格式

markdown
- English change 1
- English change 2

---

- 中文改动描述 1
- 中文改动描述 2

规则:

  • 英文在上,中文在下,中间用单独一行 --- 分隔
  • 不写版本号标题、日期和分类小节,发布标题已有体现
  • 条目平铺,不折叠,不用 emoji,条目末尾不加标点
  • 更新日志禁止黑话,要求用自然拟人的语气来写
  • 中英文一一对应
  • 每条以动词开头,简洁描述用户可感知的变化;同一改动只写最终效果,不写过程,净效果为零则不写
  • 禁止写入 GitHub Action、发布脚本、构建产物命名、CI 调整、调试指令变更等非用户可感知变化
  • 末尾无空行
  • issue 校验必须基于 gh 返回的原文,不允许凭印象追加 close #xxxx
  • issue 关联以功能主题匹配为准,不以 commit 是否写了编号为准
  • 版本号更新只处理本地改动与本地提交,push 阶段交给用户自己执行

两端同步

本技能同时保存在 .codex/skills/version-bump/ 和 .claude/skills/version-bump/。修改任一端时,必须同步更新另一端,保持所有同名文件内容一致。

© Kindness-Kismet, GPL-3.0. 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 .codex/skills/version-bump of Kindness-Kismet/only_player.

Open the folder on GitHubat commit 89e0de6

Compare with similar skills

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

Version Bump compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Version Bump this skillKindness-Kismet/only_player455—~707Automated safety check: PassGPL-3.0
Android API Diffgkd-kit/gkd43k—~796Automated safety check: PassGPL-3.0
Android Developmentdpconde/claude-android-skill337—~1.7kAutomated safety check: PassMIT
Run Jetpack Android Appwordpress-mobile/WordPress-Android3.2k—~886Automated safety check: PassGPL-2.0
Orca Android Emulator Controlstablyai/orca88k—~558Automated safety check: PassApache-2.0
Claude Android NinjaDrjacky/claude-android-ninja124—~5.2kAutomated safety check: PassApache-2.0

Similar skills

  • Android API Diff

    gkd-kit/gkd

    Looks up Android framework Java and AIDL APIs across versions with the android-api-diff CLI: signatures, availability, source files and hidden-API access code.

    43k GitHub stars~796 tokensUpdated yesterday
    MobileAuto-check passed
  • Android Development

    dpconde/claude-android-skill

    Create production-quality Android applications following Google's official architecture guidance and NowInAndroid best practices.

    337 GitHub stars~1.7k tokensUpdated 10 mo ago
    MobileAuto-check passed
  • Run Jetpack Android App

    wordpress-mobile/WordPress-Android

    Builds the Jetpack debug app with Gradle and installs it on a connected Android device or an emulator started from an available AVD.

    3.2k GitHub stars~886 tokensUpdated today
    MobileAuto-check passed
  • Android device and emulator control from inside Orca over adb, with the live device view in Orca's emulator pane. Use when driving an adb-connected emulator…

    88k GitHub stars~558 tokensUpdated today
    MobileAuto-check passed
  • Claude Android Ninja

    Drjacky/claude-android-ninja

    Build and migrate Android apps with Kotlin, Jetpack Compose, MVVM, Hilt, Room 3 (KSP, SQLiteDriver, Flow/suspend DAOs), Navigation3, and multi-module Gradle.

    124 GitHub stars~5.2k tokensUpdated 9 days ago
    MobileAuto-check passed
  • Expo Brownfield Integration

    mweinbach/agent-coworker

    Helps add Expo and React Native to an existing native iOS or Android app, and choose between a prebuilt AAR or XCFramework and a fully integrated build.

    156 GitHub starsUsed in 2 repos~900 tokens
    MobileAuto-check: notes

More from Kindness-Kismet/only_player

  • Debug App

    Kindness-Kismet/only_player

    调试、测试或验证 Only Player 应用功能、页面和代码改动时使用,支持调试指令和界面交互验证. An agent skill from Kindness-Kismet/only_player.

    455 GitHub stars~505 tokensUpdated 4 days ago
    Auto-check passed
  • PR

    Kindness-Kismet/only_player

    按 Only Player 分支与发布通道规范创建、说明和合并 Pull Request。用户说「开 PR」「提 PR」「创建 PR」「pull request」「晋升到 main」「合到正式版」时使用。

    455 GitHub stars~371 tokensUpdated 4 days ago
    Auto-check passed
  • Commit

    Kindness-Kismet/only_player

    按 Only Player 项目规范创建、修改和整理 Git 提交。创建提交、补充提交内容、修改提交信息或整理提交历史时使用。

    455 GitHub stars~324 tokensUpdated 4 days ago
    Auto-check passed

Works with

Categories

Questions about Version Bump

What does Version Bump do?

更新 Only Player 版本号、整理更新日志并创建版本提交。用户说「更新版本号」「提高版本号」「版本号提升」或「version bump」时使用。. Version Bump is an agent skill from Kindness-Kismet/only_player.

When should I use Version Bump?

Version Bump fits situations like: mobile work in your project.

How do I install Version Bump in Claude Code?

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

How do I install Version Bump in Codex?

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

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

What does Version Bump need to run?

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

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

Version Bump is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Version Bump use?

About 707 tokens (SKILL.md is roughly 2.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 Version Bump?

Skills that share tags, products or a category with Version Bump: Android API Diff (gkd-kit/gkd, 43k stars), Android Development (dpconde/claude-android-skill, 337 stars), Run Jetpack Android App (wordpress-mobile/WordPress-Android, 3.2k stars) and Orca Android Emulator Control (stablyai/orca, 88k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Version Bump?

Kindness-Kismet (a GitHub user) maintains it in Kindness-Kismet/only_player, which has 455 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 5, 2026.

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