Agent skill

Release

by JustLookAtNow in JustLookAtNow/pt_mate

自动化项目的版本发布流程,包括版本号自增、ChangeLog 提取与汇总、代码提交、打标签以及推送到远程仓库. An agent skill from JustLookAtNow/pt_mate.

MITAuto-check passedDevelopment

Install Release

skills CLI
$ npx skills add JustLookAtNow/pt_mate --skill release -a claude-code

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

GitHub CLI
$ gh skill install JustLookAtNow/pt_mate 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/JustLookAtNow/pt_mate.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agent/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
503
Token cost
~332 tokens
SKILL.md length
86 words
Files
4 (incl. scripts)
Skills in repo
4
Repo updated
First seen
Licence
MIT

At a glance

自动化项目的版本发布流程,包括版本号自增、ChangeLog 提取与汇总、代码提交、打标签以及推送到远程仓库. An agent skill from JustLookAtNow/pt_mate.

  • Works in 5 steps: 准备阶段 → 版本号更新 → 生成发布日志 → …
  • Tasks that involve Changelog and release notes
  • SKILL.md covers 目录结构, 使用流程 and 注意事项
  • Runs Python scripts from its folder; calls python3 and git

What it does

Release is an agent skill from JustLookAtNow/pt_mate. 自动化项目的版本发布流程,包括版本号自增、ChangeLog 提取与汇总、代码提交、打标签以及推送到远程仓库。

Its SKILL.md is about 330 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `scripts/bump_version.py`, `scripts/format_release.py` and `scripts/get_commits.py`).

It sits in Development, covering Changelog and release notes. It works with Git and Python. The repository describes itself as: 基于 Flutter(Material Design 3)开发的私有种子站点客户端,支持多种PT站点的种子浏览、搜索和下载管理。目前支持M-Team和NexusPHP类型的站点。 The licence is MIT.

When your agent uses it

  • Tasks that involve Changelog and release notes

Example prompts

  • “/release”

Requirements

  • Python 3

Workflow steps

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

  1. 准备阶段
  2. 版本号更新
  3. 生成发布日志
  4. 提交与标注
  5. 推送

What it can do on your machine

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

    Ships 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • git

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

  • Network

    No URLs in SKILL.md. Its commands use 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 332 tokens when it runs. Until then it costs about 16 tokens; SKILL.md has 86 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from JustLookAtNow/pt_mate at commit db24c99, republished under its MIT licence (© JustLookAtNow). 86 words, ~332 tokens.

Download SKILL.mdSave it as .claude/skills/release/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
release
description
自动化项目的版本发布流程,包括版本号自增、ChangeLog 提取与汇总、代码提交、打标签以及推送到远程仓库。

Release Skill

此 Skill 旨在提供一个标准化的发布流程。它通过脚本自动处理繁琐的操作,并利用 AI 总结用户可感知的改动。

目录结构

  • scripts/bump_version.py: 自动更新 pubspec.yaml 版本号。
  • scripts/get_commits.py: 提取自上次发布以来的 Git 提交记录。
  • scripts/format_release.py: 格式化发布日志模板。

使用流程

  1. 准备阶段

    • 检查当前分支是否为发布分支(通常是 master/main)。
    • 确认工作区是干净的(没有未提交的改动)。
  2. 版本号更新

    • 运行 python3 scripts/bump_version.py 或者带上目标版本 python3 scripts/bump_version.py 2.20.2-beta。
    • 如果用户提供了版本号,则使用用户指定的版本号,并且自动保留并增加构建号(例如从 +513 变为 +514)。
    • 如果未提供版本号,脚本会自动在当前版本号的基础上增加一个小版本号(patch),并同样增加构建号,且保留原有的 -beta 等预发布后缀。
  3. 生成发布日志

    • 运行 python3 scripts/get_commits.py 获取原始提交记录。
    • 将记录提供给 AI,根据 scripts/format_release.py 的定义,总结出用户可感知的改动。
    • 改动分类应包括:🎉Highlights、✨新增功能、🐛修复问题、🔧性能优化、📋其它。架构优化和技术细节无需列入用户日志。
    • **非常重要:**如果某个分类下没有相关改动,必须直接省略该分类,绝对不要写“暂无”或“无”。
    • **非常重要:**生成的发布日志必须经过用户确认后,再进行 Commit 操作。
  4. 提交与标注

    • 注意:在 Git 提交信息和打标签时,版本号必须省略 + 及其后面的构建号(例如:版本号 2.19.4+510 对应 2.19.4,版本号 2.20.2-beta+514 对应 2.20.2-beta)。pubspec.yaml 中则保留完整版本号。
    • 提交改动:# release: {基础版本号}\n\n{发布日志内容}。
    • 打标签:v{基础版本号}。
  5. 推送

    • 将代码和标签推送到远程仓库:git push origin {branch} --tags。

注意事项

  • 提交消息必须使用真实的换行,而不是 \n 字符串。
  • 确认发布日志内容后,再进行 Commit 操作。

© JustLookAtNow, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts) in .agent/skills/release of JustLookAtNow/pt_mate.

  • SKILL.md
  • scripts/bump_version.py
  • scripts/format_release.py
  • scripts/get_commits.py

Open the folder on GitHubat commit db24c99

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 skillJustLookAtNow/pt_mate503—~332Automated safety check: PassMIT
Commitizencommitizen-tools/commitizen3.5k—~839Automated safety check: PassMIT
pybind11 Release Preparationpybind/pybind1118k—~1.7kAutomated safety check: PassCustom licence
pybind11 Release Publicationpybind/pybind1118k—~2.5kAutomated safety check: PassCustom licence
Draft ReleaseDASDAE/dascore168—~1.1kAutomated safety check: PassCustom licence
WebRTC Changelog Generatorwebrtc-sdk/webrtc4461 repos~485Automated safety check: PassBSD-3-Clause

Similar skills

  • Commitizen

    commitizen-tools/commitizen

    A skill your agent uses for tasks involving Conventional Commits, commit message validation, Commitizen configuration, semantic version bumps, changelog generation, or CI/release automation with the…

    3.5k GitHub stars~839 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Opens the pybind11 release-preparation pull request: picking the release base, bumping the version in common.h and integrating the changelog, following docs/release.rst.

    18k GitHub stars~1.7k tokensUpdated today
    DevelopmentAuto-check passed
  • Walks a maintainer through publishing a pybind11 release after the preparation PR merges, with preflight checks, confirmations before each push and a GitHub release.

    18k GitHub stars~2.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Draft Release

    DASDAE/dascore

    Draft the next release version and changelog by fetching tags, computing the next semantic v tag, collecting merged PRs into master since last release via gh, and printing the proposed version and…

    168 GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Builds a categorized HTML changelog for a WebRTC release from the git log between two branch heads, with a summary and commit and review links.

    446 GitHub starsUsed in 1 repo~485 tokens
    DevelopmentAuto-check passed
  • Release Ops

    oce-ai/oce

    OpenContextEngine (oce) 仓库的版本发布运营技能。使用 scripts/ 下的 bumpversion.py 更新版本号(pyproject.toml 与 src/oce/init.py 同步)、generatechangelog.py 从 git 提交生成 CHANGELOG、release.py 执行 bump→changelog→build→commit→tag…

    121 GitHub stars~627 tokensUpdated yesterday
    DevelopmentAuto-check passed

More from JustLookAtNow/pt_mate

  • Flutter Screenshot

    JustLookAtNow/pt_mate

    Capture and show two Flutter UI screenshots for this project: one landscape/large-screen preview and one portrait/mobile preview, without using Flutter Web.

    503 GitHub stars~511 tokensUpdated 3 days ago
    Auto-check passed
  • Deploy Server

    JustLookAtNow/pt_mate

    将 server 后端新版本构建并部署到服务器;当用户要求更新测试环境或正式环境时使用。测试环境部署到 golakers:~/ptmate-beta 并直接运行;正式环境先停止 ptmate 服务,部署到 golakers:~/ptmate 后再启动 ptmate 服务。

    503 GitHub stars~678 tokensUpdated 3 days ago
    Auto-check passed
  • Nexusphpweb Site Config

    JustLookAtNow/pt_mate

    适配 NexusPHPWeb 类型站点的站点配置与 infoFinder 字段编写。需要检查 assets/sitesmanifest.json 中站点 id 是否存在,缺失时先调用 Add Site 技能创建配置文件,然后依据 docs/SITECONFIGURATIONGUIDE.md 与 assets/siteconfigs.json 的 NexusPHPWeb 模板生成或更新…

    503 GitHub stars~366 tokensUpdated 3 days ago
    Auto-check passed

Works with

Categories

Questions about Release

What does Release do?

自动化项目的版本发布流程,包括版本号自增、ChangeLog 提取与汇总、代码提交、打标签以及推送到远程仓库. An agent skill from JustLookAtNow/pt_mate. Release is an agent skill from JustLookAtNow/pt_mate.

When should I use Release?

Release fits situations like: tasks that involve Changelog and release notes.

How do I install Release in Claude Code?

Run `npx skills add JustLookAtNow/pt_mate --skill release -a claude-code`. Or copy the skill folder (.agent/skills/release in JustLookAtNow/pt_mate) 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 JustLookAtNow/pt_mate --skill release -a codex`. Or copy the skill folder (.agent/skills/release in JustLookAtNow/pt_mate) 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 JustLookAtNow/pt_mate --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 Python for the scripts in its folder and the command-line tools its instructions call (python3 and git). Our summary lists: Python 3.

Does Release access the network?

SKILL.md contains no URLs. Its commands use 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 no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

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 332 tokens (SKILL.md is roughly 1.3k 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: Commitizen (commitizen-tools/commitizen, 3.5k stars), pybind11 Release Preparation (pybind/pybind11, 18k stars), pybind11 Release Publication (pybind/pybind11, 18k stars) and Draft Release (DASDAE/dascore, 168 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Release?

JustLookAtNow (a GitHub user) maintains it in JustLookAtNow/pt_mate, which has 503 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 5, 2026.

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