Agent skill

Release Notes

by zhaojh329 in zhaojh329/rttys

为本项目 rttys 编写或重写中英文 release notes,根据版本标签之间的实际变更生成英文在前、中文在后、按修复/改进/新功能分类及 GitHub 完整变更链接的 Markdown 发布说明,并默认写入文件。在本项目中用户说“写 release note”或类似请求时使用,无需用户另行要求保存。

MITAuto-check passedDevelopment

Install Release Notes

skills CLI
$ npx skills add zhaojh329/rttys --skill release-notes -a claude-code

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

GitHub CLI
$ gh skill install zhaojh329/rttys release-notes --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/zhaojh329/rttys.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/release-notes .claude/skills/release-notes && 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-notes
GitHub stars
114
Token cost
~609 tokens
SKILL.md length
76 words
Files
2
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

为本项目 rttys 编写或重写中英文 release notes,根据版本标签之间的实际变更生成英文在前、中文在后、按修复/改进/新功能分类及 GitHub 完整变更链接的 Markdown 发布说明,并默认写入文件。在本项目中用户说“写 release note”或类似请求时使用,无需用户另行要求保存。

  • Tasks that involve Changelog and release notes
  • SKILL.md covers 确认发布内容, 输出格式 and 写入文件与交付
  • Calls git

What it does

Release Notes is an agent skill from zhaojh329/rttys. 为本项目 rttys 编写或重写中英文 release notes,根据版本标签之间的实际变更生成英文在前、中文在后、按修复/改进/新功能分类及 GitHub 完整变更链接的 Markdown 发布说明,并默认写入文件。在本项目中用户说“写 release note”或类似请求时使用,无需用户另行要求保存。

Its SKILL.md is about 610 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. It works with GitHub and Git. The repository describes itself as: Access your device's terminal from anywhere via the web. The licence is MIT.

When your agent uses it

  • Tasks that involve Changelog and release notes

Example prompts

  • “写 release note”
  • “/release-notes”

What it can do on your machine

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

    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 Notes loads about 609 tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 76 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
~609

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 zhaojh329/rttys at commit bc1ac60, republished under its MIT licence (© zhaojh329). 76 words, ~609 tokens.

Download SKILL.mdSave it as .claude/skills/release-notes/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
release-notes
description
为本项目 rttys 编写或重写中英文 release notes,根据版本标签之间的实际变更生成英文在前、中文在后、按修复/改进/新功能分类及 GitHub 完整变更链接的 Markdown 发布说明,并默认写入文件。在本项目中用户说“写 release note”或类似请求时使用,无需用户另行要求保存。

rttys 发布说明

本技能仅用于当前 rttys 项目。公开项目地址为 https://github.com/zhaojh329/rttys;本地 origin 可能指向私有镜像,发布说明仍使用公开 GitHub 比较链接。

采用本项目发布说明格式:英文在前,中文在后;每项使用加粗标题和缩进说明,两种语言之间用水平线分隔。用户明确指定其他结构、语言或参考文件时,优先遵循本次要求。

确认发布内容

  • 用户只说“写 release note”而未指定版本时,优先采用当前分支最近可达的发布标签;如存在多条发布线等歧义且无法从上下文确定,再询问目标版本。
  • 根据用户指定的目标版本和基准版本确定范围。未指定基准时,从仓库标签和发布历史确定同一发布线的上一版本,不直接将 HEAD 或标签排序中的相邻项视为正确范围。
  • 阅读 git log <base>..<target> 和相关 git diff,以目标版本实际包含的行为为准。工作区改动、后续提交和讨论中尚未实现的方案不属于已发布内容。
  • 参考文件用于确认结构和措辞,不能直接沿用其中的旧版本号、变更条目和链接;文件名也不保证与内容中的版本一致。
  • 聚合同一功能的相关提交,以用户可感知的变化组织条目,不机械翻译提交列表。通常省略纯版本号更新、赞助配置和无实质内容的文档维护。
  • 明确性能优化影响的方向和范围,例如浏览器到设备的上传与设备到浏览器的下载。没有测试依据时不承诺具体倍数或测量结果;兼容性、是否需要升级客户端等结论需有依据。
  • 本仓库是 rttys 服务端与 Web UI;区分服务端变化、浏览器行为和设备端 rtty/rtty-go 行为,不把设备端尚未发布或未包含的修改写入本版本。

输出格式

按以下顺序分开列出类别,不使用合并标题 Bug Fixes & Improvements:

  • ### Bug Fixes / ### 问题修复:纠正错误行为、资源泄漏或数据丢失等问题。
  • ### Improvements / ### 改进优化:已有功能的性能、易用性及行为改善。
  • ### New Features / ### 新功能:新增的用户能力或功能。

每项按主要用户价值归入一个类别,不重复列出。没有内容的类别省略,不为凑齐类别将优化包装成新功能。英文全部类别写完后,再写中文对应类别。默认不添加总标题或开场总结;模板中的尖括号内容须替换。

markdown
### Bug Fixes

- **<English fix title>**
  - <Describe the corrected behavior and its benefit.>

### Improvements

- **<English improvement title>**
  - <Describe how an existing capability is improved.>

### New Features

- **<English feature title>**
  - <Describe the newly available capability.>

**Full Changelog**: https://github.com/zhaojh329/rttys/compare/<base>...<target>

---

### 问题修复

- **<中文修复标题>**
  - <说明修正后的行为及其价值。>

### 改进优化

- **<中文改进标题>**
  - <说明已有能力的改善。>

### 新功能

- **<中文功能标题>**
  - <说明新增的用户能力。>

**完整变更记录**: https://github.com/zhaojh329/rttys/compare/<base>...<target>
  • 中英文条目的顺序、范围和事实保持一致;自然翻译,不逐词硬译。UI 改动可以沿用 UI: ... / UI:... 的标题前缀。
  • 比较链接保留真实标签名(包括 v 前缀),例如 https://github.com/zhaojh329/rttys/compare/v5.5.2...v5.5.3;生成新版本说明时必须更新两端标签。
  • 标题和列表前保留空行,说明条目缩进两个空格,文件末尾保留换行。

写入文件与交付

  • 在本项目中,“写 release note”“写发布说明”等请求默认包含写入 Markdown 文件,不只在对话中输出,也不再询问是否保存。用户明确要求仅预览或只在对话中回答时除外。
  • 优先使用用户指定路径或当前目标版本正在编辑的发布说明文件;否则写入仓库根目录的 RELEASE_NOTES_<target>.md,例如 RELEASE_NOTES_v5.5.3.md。已有其他版本的文件不作为覆盖目标。
  • 用户要求“参考某文件重写”时,默认重写当前输出文件,保留参考文件。
  • 写完核对版本范围、中英文对应关系、比较链接及 Markdown 结构,简短返回文件链接。
  • 编写或保存发布说明本身不包含创建 Git 提交、修改标签或发布远端 Release;这些操作须有对应的用户指令。

© zhaojh329, 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 1 other file in .agents/skills/release-notes of zhaojh329/rttys.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit bc1ac60

Compare with similar skills

Release Notes 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 Notes compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Release Notes this skillzhaojh329/rttys114—~609Automated safety check: PassMIT
Draft Release Notesjamiepine/voicebox57k—~941Automated safety check: PassMIT
Mole Release Notes Publishertw93/Mole70k—~1.9kAutomated safety check: PassGPL-3.0
Release Bumpjamiepine/voicebox57k—~1.1kAutomated safety check: PassMIT
Verdaccio Pull Request Workflowverdaccio/verdaccio18k—~1.9kAutomated safety check: PassMIT
Go-Redis Release Preparationredis/go-redis22k—~1.1kAutomated safety check: PassBSD-2-Clause

Similar skills

  • Draft Release Notes

    jamiepine/voicebox

    Writes or refreshes the Unreleased section of CHANGELOG.md as a themed narrative built from the commits, PRs and diff since the last version tag.

    57k GitHub stars~941 tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Publishes curated, bilingual release notes for an existing Mole version tag with gh release edit, including contributor thanks and reactions, after the release workflow finishes.

    70k GitHub stars~1.9k tokensUpdated today
    DevelopmentAuto-check passed
  • Release Bump

    jamiepine/voicebox

    Ends a release cycle by moving the Unreleased changelog notes under a dated version heading, bumping version files with bumpversion and tagging the commit.

    57k GitHub stars~1.1k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • 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
  • Official

    Prepares a go-redis release locally: picks the next semver, gathers merged PRs, writes the RELEASE-NOTES entry and bumps versions, without publishing.

    22k GitHub stars~1.1k tokensUpdated yesterday
    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.6k GitHub stars~3.8k tokensUpdated 2 days ago
    DevelopmentAuto-check passed

Works with

Categories

Questions about Release Notes

What does Release Notes do?

为本项目 rttys 编写或重写中英文 release notes,根据版本标签之间的实际变更生成英文在前、中文在后、按修复/改进/新功能分类及 GitHub 完整变更链接的 Markdown 发布说明,并默认写入文件。在本项目中用户说“写 release note”或类似请求时使用,无需用户另行要求保存。. Release Notes is an agent skill from zhaojh329/rttys.

When should I use Release Notes?

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

How do I install Release Notes in Claude Code?

Run `npx skills add zhaojh329/rttys --skill release-notes -a claude-code`. Or copy the skill folder (.agents/skills/release-notes in zhaojh329/rttys) into .claude/skills/release-notes in your project. Claude Code loads it when a task matches its description.

How do I install Release Notes in Codex?

Run `npx skills add zhaojh329/rttys --skill release-notes -a codex`. Or copy the skill folder (.agents/skills/release-notes in zhaojh329/rttys) into .agents/skills/release-notes in your project. Codex loads it when a task matches its description.

Can I use Release Notes 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 zhaojh329/rttys --skill release-notes -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-notes, .gemini/skills/release-notes, .github/skills/release-notes and .opencode/skills/release-notes in your project.

What does Release Notes need to run?

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

Does Release Notes 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 Notes 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 Notes use?

Release Notes 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 Notes use?

About 609 tokens (SKILL.md is roughly 2.4k 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 Notes?

Skills that share tags, products or a category with Release Notes: Draft Release Notes (jamiepine/voicebox, 57k stars), Mole Release Notes Publisher (tw93/Mole, 70k stars), Release Bump (jamiepine/voicebox, 57k stars) and Verdaccio Pull Request Workflow (verdaccio/verdaccio, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Release Notes?

zhaojh329 (a GitHub user) maintains it in zhaojh329/rttys, which has 114 GitHub stars. The repository was last updated on October 2, 2026.

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