Agent skill

Version Bump and Release

Bumps a project version, updates both changelogs, builds the frontend, then commits, tags and pushes the release.

MITAuto-check passedDevelopment

Install Version Bump and Release

skills CLI

$ npx skills add escapeWu/perplexity-ai --skill bump-version -a claude-code

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

GitHub CLI

$ gh skill install escapeWu/perplexity-ai 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/escapeWu/perplexity-ai.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/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/

Paste into Claude Code

Install the "bump-version" agent skill from https://github.com/escapeWu/perplexity-ai/tree/main/.claude/skills/bump-version into .claude/skills/bump-version/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bump-version", 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

$skill-installer install https://github.com/escapeWu/perplexity-ai/tree/main/.claude/skills/bump-version

Type 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.

skills CLI

$ npx skills add escapeWu/perplexity-ai --skill bump-version -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install escapeWu/perplexity-ai bump-version --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/escapeWu/perplexity-ai.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/bump-version .agents/skills/bump-version && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "bump-version" agent skill from https://github.com/escapeWu/perplexity-ai/tree/main/.claude/skills/bump-version into .agents/skills/bump-version/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bump-version", 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.

skills CLI

$ npx skills add escapeWu/perplexity-ai --skill bump-version -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install escapeWu/perplexity-ai bump-version --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/escapeWu/perplexity-ai.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/bump-version .cursor/skills/bump-version && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "bump-version" agent skill from https://github.com/escapeWu/perplexity-ai/tree/main/.claude/skills/bump-version into .cursor/skills/bump-version/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bump-version", 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

$ gemini skills install https://github.com/escapeWu/perplexity-ai.git --path .claude/skills/bump-version

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add escapeWu/perplexity-ai --skill bump-version -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install escapeWu/perplexity-ai bump-version --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/escapeWu/perplexity-ai.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/bump-version .gemini/skills/bump-version && rm -rf skills-src

Use ~/.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/

Paste into Gemini CLI

Install the "bump-version" agent skill from https://github.com/escapeWu/perplexity-ai/tree/main/.claude/skills/bump-version into .gemini/skills/bump-version/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bump-version", 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.

GitHub CLI

$ gh skill install escapeWu/perplexity-ai bump-version

Installs 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).

skills CLI

$ npx skills add escapeWu/perplexity-ai --skill bump-version -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/escapeWu/perplexity-ai.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/bump-version .github/skills/bump-version && rm -rf skills-src

Use ~/.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/

Paste into GitHub Copilot

Install the "bump-version" agent skill from https://github.com/escapeWu/perplexity-ai/tree/main/.claude/skills/bump-version into .github/skills/bump-version/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bump-version", 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.

skills CLI

$ npx skills add escapeWu/perplexity-ai --skill bump-version -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install escapeWu/perplexity-ai bump-version --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/escapeWu/perplexity-ai.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/bump-version .opencode/skills/bump-version && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "bump-version" agent skill from https://github.com/escapeWu/perplexity-ai/tree/main/.claude/skills/bump-version into .opencode/skills/bump-version/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bump-version", 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: bump-version
GitHub stars: 169
Token cost: ~528 tokens
SKILL.md length: 197 words
Files: 1
Skills in repo: 3
Repo updated: Sep 27, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Bumps a project version, updates both changelogs, builds the frontend, then commits, tags and pushes the release.

Works in 6 steps: Determine new version → Update version files → Update changelogs → …
Releasing a new version of the project from the main branch
SKILL.md covers Steps and Notes
Calls git and npm

What it does

Given a target version such as v1.9.0, it strips the v prefix and edits the version in pyproject.toml and in the web package's package.json, which Vite reads to show the version in the admin interface. A new entry is then added at the top of the changelog in README.md and in the Chinese README, using today's date and a summary of changes since the last release.

Next it runs npm run build in the web folder and fixes any TypeScript or lint errors until the build passes, never committing on a failed build. It stages only source files, leaving the gitignored dist folder out, and commits with a feat message that carries the version and a short summary followed by bullet points of key changes.

Finally it tags the commit and pushes main and the tag to origin. The changelog summary is confirmed with you when the changes are not obvious, and previous commits are never amended. The file paths and README names are those of one particular repository, so adapt them elsewhere.

When your agent uses it

Releasing a new version of the project from the main branch
Adding matching English and Chinese changelog entries
Making sure the frontend build passes before a release commit

Example prompts

“Bump to v1.9.0 and release.”
“Release the next version with a changelog entry covering the MCP fixes since the last tag.”
“Cut a new release and make sure the web build is green before you commit.”

Requirements

A git repository laid out like the source project, with pyproject.toml and a web package
npm for the frontend build
Push access to origin

Workflow steps

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

Determine new version
Update version files
Update changelogs
Build frontend
Commit
Tag and push

What it can do on your machine

Read from SKILL.md and the folder at commit a39a13f. 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
- npm
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use git 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

Version Bump and Release loads about 528 tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 197 words of instructions outside code blocks.

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

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 escapeWu/perplexity-ai at commit a39a13f, republished under its MIT licence (© escapeWu). 197 words, ~528 tokens.

Download SKILL.mdSave it as .claude/skills/bump-version/SKILL.md (or your agent's skills folder).

name: bump-version
description: Bump project version, update changelogs, commit, tag, and push. Use when the user wants to release a new version (e.g. "bump v1.x.0", "release version x").

Bump Version Skill

Steps

1. Determine new version

User provides target version (e.g. v1.9.0)
Strip the v prefix for file edits

2. Update version files

pyproject.toml: update version = "x.x.x"
perplexity/server/web/package.json: update "version": "x.x.x" — Vite reads this via vite.config.ts to inject __APP_VERSION__ into the frontend build, which displays as MANAGER_vX.X.X in the admin UI

3. Update changelogs

Add a new entry at the top of the changelog section in both files:

README.md — under ## Changelog:

+ **<YYYY-MM-DD>**: v<VERSION> — <summary in English>

README-zh.md — under ## 更新记录:

+ **<YYYY-MM-DD>**：v<VERSION> — <summary in Chinese>

Use today's date. Summarize the changes since the last version based on recent commits or what the user describes.

4. Build frontend

bash

cd perplexity/server/web && npm run build

If build succeeds: proceed to commit.
If build fails: fix all TypeScript/lint errors in perplexity/server/web/src/, then re-run the build until it passes. Do not proceed to commit until the build is green.

The dist/ folder is gitignored — do not force-add it.

5. Commit

Stage only source files (never dist/):

bash

git add pyproject.toml README.md README-zh.md \
  perplexity/server/web/package.json \
  perplexity/server/web/src/

Also stage any other modified source files relevant to the release.

Commit message format:

feat: v<VERSION> - <short summary>

<bullet points of key changes>

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

6. Tag and push

bash

git tag v<VERSION>
git push origin main
git push origin v<VERSION>

Notes

Always confirm the changelog summary with the user if the changes aren't obvious
If the build fails, fix errors before committing
Do not amend previous commits — always create a new commit

Files

Just SKILL.md in .claude/skills/bump-version of escapeWu/perplexity-ai.

Open the folder on GitHubat commit a39a13f

Compare with similar skills

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

Version Bump and Release compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Version Bump and Release this skillescapeWu/perplexity-ai	169	—	~528	Automated safety check: Pass	MIT	10 days ago
Git Changes ReporterNo-Trade-No-Life/Yuan	352	—	~1.2k	Automated safety check: Pass	MIT	5 mo ago
Git Workflow and Versioningaddyosmani/agent-skills	102k	2 repos	~3.5k	Automated safety check: Notes	MIT	3 days ago
Verdaccio Pull Request Workflowverdaccio/verdaccio	18k	—	~1.9k	Automated safety check: Pass	MIT	today
Hunk Release Workflowmodem-dev/hunk	9.5k	—	~3.8k	Automated safety check: Pass	MIT	today
AionUi Version BumpiOfficeAI/AionUi	33k	—	~2.1k	Automated safety check: Pass	Apache-2.0	28 days ago

Similar skills

Git Changes Reporter
No-Trade-No-Life/Yuan
生成结构化 git 变更报告（JSON + Markdown）。使用此技能当用户提到"git 变更"、"commit 摘要"、"代码审查"、"release note"、"近期改动"、"每日摘要"，或需要分析指定 commit 区间的代码变更。包含三元组结构（设计意图、核心代码、影响范围）的语义化报告，适用于代码审查、发布说明、团队同步、CI/CD 等场景。
352 GitHub stars~1.2k tokensUpdated 5 mo ago
DevelopmentAuto-check passed
Git Workflow and Versioning
addyosmani/agent-skills
Sets git habits for every change: short-lived branches, atomic commits with descriptive messages, clean pull requests, plus versioning, tagging and changelogs for releases.
102k GitHub starsUsed in 2 repos~3.5k tokens
DevelopmentAuto-check: notes
Verdaccio Pull Request Workflow
verdaccio/verdaccio
Takes a change through a verdaccio pull request: branch, local checks, changeset, title and body, labels, CI and review rounds, and ports to other release lines.
18k GitHub stars~1.9k tokensUpdated today
DevelopmentAuto-check passed
Hunk Release Workflow
modem-dev/hunk
Maintainer workflow for preparing, publishing, verifying and curating Hunk releases, with confirmation gates before tags, publishes and public edits.
9.5k GitHub stars~3.8k tokensUpdated today
DevelopmentAuto-check passed
AionUi Version Bump
iOfficeAI/AionUi
Automates an AionUi release: checks the latest AionCore release and its artifacts, updates package.json, writes the changelog, opens a PR and tags the release.
33k GitHub stars~2.1k tokensUpdated 28 days ago
DevelopmentAuto-check passed
WooCommerce Git Commit
woocommerce/woocommerce
Commits pending changes with short, verb-first messages that follow WooCommerce repository conventions, splitting commits only when changes are clearly unrelated.
11k GitHub stars~1.2k tokensUpdated today
DevelopmentAuto-check passed

Questions about Version Bump and Release

What does Version Bump and Release do?

Bumps a project version, updates both changelogs, builds the frontend, then commits, tags and pushes the release. json, which Vite reads to show the version in the admin interface.md and in the Chinese README, using today's date and a summary of changes since the last release.

When should I use Version Bump and Release?

Version Bump and Release fits situations like: releasing a new version of the project from the main branch; adding matching English and Chinese changelog entries; making sure the frontend build passes before a release commit.

How do I install Version Bump and Release in Claude Code?

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

How do I install Version Bump and Release in Codex?

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

Can I use Version Bump and 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 escapeWu/perplexity-ai --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 Version Bump and Release need to run?

Going by SKILL.md and its folder, Version Bump and Release needs the command-line tools its instructions call (git and npm). Our summary lists: A git repository laid out like the source project, with pyproject.toml and a web package; npm for the frontend build; Push access to origin.

Does Version Bump and Release access the network?

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

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

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

About 528 tokens (SKILL.md is roughly 2.1k 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 and Release?

Skills that share tags, products or a category with Version Bump and Release: Git Changes Reporter (No-Trade-No-Life/Yuan, 352 stars), Git Workflow and Versioning (addyosmani/agent-skills, 102k stars), Verdaccio Pull Request Workflow (verdaccio/verdaccio, 18k stars) and Hunk Release Workflow (modem-dev/hunk, 9.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Version Bump and Release?

escapeWu (a GitHub user) maintains it in escapeWu/perplexity-ai, which has 169 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on September 27, 2026.

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

Version Bump and Release

Install Version Bump and Release

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Bump Version Skill

Steps

1. Determine new version

2. Update version files

3. Update changelogs

4. Build frontend

5. Commit

6. Tag and push

Notes

Files

Compare with similar skills

Similar skills

Git Changes Reporter

Git Workflow and Versioning

Verdaccio Pull Request Workflow

Hunk Release Workflow

AionUi Version Bump

WooCommerce Git Commit

More from escapeWu/perplexity-ai

Perplexity Search

Perplexity Server Deploy

Questions about Version Bump and Release

Install Version Bump and Release

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Bump Version Skill

Steps

1. Determine new version

2. Update version files

3. Update changelogs

4. Build frontend

5. Commit

6. Tag and push

Notes

Files

Compare with similar skills

Similar skills

More from escapeWu/perplexity-ai

Related

Questions about Version Bump and Release