Agent skill

Release Notes

by Aivis-Project in Aivis-Project/AivisSpeech

AivisSpeech の新バージョンリリース時に updateInfos のリリースノートドラフトを作成・更新するスキル。「リリースノート」「updateInfos」「アップデート情報」「リリース準備」などのキーワードが出たら使う。updateInfos.draft.json の作成・更新、エンジン側リリースノートとの統合、漏れチェックまでを包括的にサポートする。

LGPL-3.0Auto-check passedDevelopment

Install Release Notes

skills CLI
$ npx skills add Aivis-Project/AivisSpeech --skill release-notes -a claude-code

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

GitHub CLI
$ gh skill install Aivis-Project/AivisSpeech 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/Aivis-Project/AivisSpeech.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/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
483
Token cost
~745 tokens
SKILL.md length
137 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
LGPL-3.0

At a glance

AivisSpeech の新バージョンリリース時に updateInfos のリリースノートドラフトを作成・更新するスキル。「リリースノート」「updateInfos」「アップデート情報」「リリース準備」などのキーワードが出たら使う。updateInfos.draft.json の作成・更新、エンジン側リリースノートとの統合、漏れチェックまでを包括的にサポートする。

  • Works in 4 steps: タグ日付の確認(最優先) → コミットメッセージだけでなく実際の差分を確認する → エンジン側リリースノートの統合 → …
  • Tasks that involve Changelog and release notes
  • SKILL.md covers 運用ルール, 調査の進め方, 記述フォーマット and チェックリスト
  • Calls git

What it does

Release Notes is an agent skill from Aivis-Project/AivisSpeech. AivisSpeech の新バージョンリリース時に updateInfos のリリースノートドラフトを作成・更新するスキル。「リリースノート」「updateInfos」「アップデート情報」「リリース準備」などのキーワードが出たら使う。updateInfos.draft.json の作成・更新、エンジン側リリースノートとの統合、漏れチェックまでを包括的にサポートする。

Its SKILL.md is about 750 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 Development, covering Changelog and release notes and Text to speech and voice. It works with Vue.js, TypeScript and Git. The repository describes itself as: AivisSpeech: AI Voice Imitation System - Text to Speech Software. The licence is LGPL-3.0.

When your agent uses it

  • Tasks that involve Changelog and release notes
  • Tasks that involve Text to speech and voice

Example prompts

  • “/release-notes”

Workflow steps

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

  1. タグ日付の確認(最優先)
  2. コミットメッセージだけでなく実際の差分を確認する
  3. エンジン側リリースノートの統合
  4. Opus サブエージェントによる漏れチェック

What it can do on your machine

Read from SKILL.md and the folder at commit 77a3675. 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 745 tokens when it runs. Until then it costs about 50 tokens; SKILL.md has 137 words of instructions outside code blocks.

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

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 Aivis-Project/AivisSpeech at commit 77a3675, republished under its LGPL-3.0 licence (© Aivis-Project). 137 words, ~745 tokens.

Download SKILL.mdSave it as .claude/skills/release-notes/SKILL.md (or your agent's skills folder).
name
release-notes
description
AivisSpeech の新バージョンリリース時に updateInfos のリリースノートドラフトを作成・更新するスキル。「リリースノート」「updateInfos」「アップデート情報」「リリース準備」などのキーワードが出たら使う。updateInfos.draft.json の作成・更新、エンジン側リリースノートとの統合、漏れチェックまでを包括的にサポートする。

AivisSpeech リリースノート作成

運用ルール

public/updateInfos.json は VITE_LATEST_UPDATE_INFOS_URL により master ブランチの内容が全ユーザーに配信される。リリース前に更新すると未リリースバージョンの通知が届いてしまうため、ドラフトは必ず public/updateInfos.draft.json に作成し、リリースコミット時に updateInfos.json へ反映する。

調査の進め方

1. タグ日付の確認(最優先)
bash
git tag -l --format='%(refname:short) %(creatordate:iso)' | sort -t' ' -k2

前バージョンタグの日付を確認し、git log <前バージョンタグ>..HEAD で対象コミットの範囲を確定する。前バージョン以前から存在していた機能を「追加」と記載するミスを防ぐために、これは絶対に最初にやること。

2. コミットメッセージだけでなく実際の差分を確認する

コミットメッセージには全ての変更が書かれているとは限らない。以下のサブエージェントを並行起動し、各領域の git diff <前バージョンタグ>..HEAD を調査する:

  • ヘルプドキュメント: public/howtouse.md, public/qAndA.md, public/contact.md 等
  • エディタ UI: ModelManageDialog, DictionaryManageDialog, PresetManageDialog, Talk/, SettingDialog, MenuBar 等
  • VOICEVOX 由来の変更: tsukumijima 以外のコミットでソング/シーケンサー/マルチトラック関連を除いたもの
  • 前プレビュー版以降の差分: 直近のプレビュー版タグ以降の変更
3. エンジン側リリースノートの統合

AivisSpeech は AivisSpeech Engine を包含する。エンジン側のリリースノート (../AivisSpeech-Engine/resources/engine_manifest_assets/update_infos.json) の内容を取り込む。

  • エンジン側の変更には Engine: プレフィックスを付ける
  • エンジン側の API 追加で対応する UI 機能がエディタ側にある場合は、UI 機能として記載する(プレフィックスなし)
4. Opus サブエージェントによる漏れチェック

ドラフト完成後、Opus モデルのサブエージェントに全コミットとドラフトを突き合わせてもらい、漏れ・誤りを検出する。

記述フォーマット

絵文字カテゴリ(この順序で並べる)
  • 🚀 : 主要な新機能
  • ✨ : 改善・UI/UX 向上
  • ⚡ : パフォーマンス改善
  • ✅ : 小規模な機能追加
  • 🛠️ : バグ修正(末尾に「🛠️ そのほか、様々な不具合を修正」を置く)
  • ⬆️ : 依存関係・ベースバージョンの更新
項目の並べ方(厳守)

各絵文字カテゴリの中で、エディタ側の項目を全て先に配置し、Engine: プレフィックス付きの項目を全て後に配置する。Engine: 項目の後にエディタ側の項目を挿入してはならない。新しいエディタ側の項目を追加する際は、そのカテゴリ内の最後のエディタ側項目の直後(最初の Engine: 項目の直前)に挿入すること。

カテゴリ内では重要度の高い項目を上に配置する。関連する小さな変更は1項目にまとめてよい(例: 括弧書きで列挙)。

リグレッション修正

プレビュー版ユーザーが多いため、リグレッション修正も全て含める。ただし「リグレッション」という表現は使わない。

contributors
  • tsukumijima 以外の直接 PR 貢献者がいれば個別に記載
  • VOICEVOX マージ由来は末尾に VOICEVOX Contributors としてまとめる
  • git log <前バージョンタグ>..HEAD --no-merges --format="%an" | sort | uniq -c | sort -rn で確認
JSON 構造
json
[
  {
    "version": "X.Y.Z",
    "descriptions": [
      "🚀 エディタ側の新機能...",
      "🚀 Engine: エンジン側の新機能...",
      "✨ エディタ側の改善...",
      "✨ Engine: エンジン側の改善...",
      "⚡ ...",
      "✅ ...",
      "🛠️ エディタ側のバグ修正...",
      "🛠️ Engine: エンジン側のバグ修正...",
      "🛠️ そのほか、様々な不具合を修正",
      "⬆️ ..."
    ],
    "contributors": ["tsukumijima", "VOICEVOX Contributors"]
  },
  ...既存バージョンのエントリ
]

チェックリスト

  • タグ日付を確認し、対象コミット範囲を正しく設定した
  • 前バージョンに既に存在していた機能を「追加」と誤記していない
  • コミットメッセージだけでなく、実際のファイル差分を確認した
  • ヘルプドキュメントの変更を確認・記載した
  • VOICEVOX 由来コミット(ソング関連除く)を漏れなく確認した
  • エンジン側リリースノートを統合した
  • 各カテゴリ内でエディタ側 → Engine: の並び順を守っている
  • Opus サブエージェントによる漏れチェックを実施した
  • contributors に漏れがない
  • JSON が valid である
  • ドラフトは updateInfos.draft.json に保存し updateInfos.json は未変更

© Aivis-Project, LGPL-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 .claude/skills/release-notes of Aivis-Project/AivisSpeech.

Open the folder on GitHubat commit 77a3675

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 skillAivis-Project/AivisSpeech483—~745Automated safety check: PassLGPL-3.0
Generate Release Notesteambit/bit18k—~2.2kAutomated safety check: PassCustom licence
Markbind Typescript MigrationMarkBind/markbind158—~2kAutomated safety check: PassMIT
Kanvibe Release Deployrookedsysc/kanvibe143—~12kAutomated safety check: NotesAGPL-3.0
Release TS SDKaptos-labs/aptos-ts-sdk116—~864Automated safety check: PassCustom licence
Releasecyanfish-x/tellux207—~1.3kAutomated safety check: PassMIT

Similar skills

  • Generate comprehensive release notes for Bit from git commits and pull requests.

    18k GitHub stars~2.2k tokensUpdated today
    DevelopmentAuto-check passed
  • Complete guide for migrating JavaScript files to TypeScript in the MarkBind project, including the two-commit strategy, import/export syntax conversion, and best practices.

    158 GitHub stars~2k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Kanvibe Release Deploy

    rookedsysc/kanvibe

    A skill your agent uses whenever releasing or deploying KanVibe desktop from a clean, up-to-date dev checkout: ask only for the target version and release-note approval, then let the AI update…

    143 GitHub stars~12k tokensUpdated today
    DevelopmentAuto-check: notes
  • Release TS SDK

    aptos-labs/aptos-ts-sdk

    A skill your agent uses when cutting a release of @aptos-labs/ts-sdk or @aptos-labs/confidential-asset.

    116 GitHub stars~864 tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Release

    cyanfish-x/tellux

    Cut and publish a new tellux release — bump version, curate a changelog summary from recent commits, pause for the user to manually pnpm publish (browser 2FA), then push the tag and create the…

    207 GitHub stars~1.3k tokensUpdated 17 days ago
    DevelopmentAuto-check passed
  • Add Tauri Command

    devlint/GitWand

    A skill your agent uses when the user wants to expose a Rust feature to the Vue frontend, add a Tauri IPC command, invoke something from a Vue component, or wire up any backend/frontend…

    180 GitHub stars~1.5k tokensUpdated today
    DevelopmentAuto-check passed

More from Aivis-Project/AivisSpeech

  • Aivisspeech Sentry Triage

    Aivis-Project/AivisSpeech

    AivisSpeech エディタの Sentry issue を調査し、修正すべき Electron / Vue 側の不具合と、ローカル環境・ブラウザ実装・外部通信由来のノイズを切り分けるためのスキルです。Sentry 側で既知ノイズを整理する作業や、src/domain/sentryEventFilter.ts と関連テストを更新して既知ノイズを送信前に破棄する作業で使用します。

    483 GitHub stars~636 tokensUpdated 2 mo ago
    Auto-check passed

Questions about Release Notes

What does Release Notes do?

AivisSpeech の新バージョンリリース時に updateInfos のリリースノートドラフトを作成・更新するスキル。「リリースノート」「updateInfos」「アップデート情報」「リリース準備」などのキーワードが出たら使う。updateInfos.draft.json の作成・更新、エンジン側リリースノートとの統合、漏れチェックまでを包括的にサポートする。. Release Notes is an agent skill from Aivis-Project/AivisSpeech.

When should I use Release Notes?

Release Notes fits situations like: tasks that involve Changelog and release notes; tasks that involve Text to speech and voice.

How do I install Release Notes in Claude Code?

Run `npx skills add Aivis-Project/AivisSpeech --skill release-notes -a claude-code`. Or copy the skill folder (.claude/skills/release-notes in Aivis-Project/AivisSpeech) 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 Aivis-Project/AivisSpeech --skill release-notes -a codex`. Or copy the skill folder (.claude/skills/release-notes in Aivis-Project/AivisSpeech) 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 Aivis-Project/AivisSpeech --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 LGPL-3.0 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 745 tokens (SKILL.md is roughly 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 Notes?

Skills that share tags, products or a category with Release Notes: Generate Release Notes (teambit/bit, 18k stars), Markbind Typescript Migration (MarkBind/markbind, 158 stars), Kanvibe Release Deploy (rookedsysc/kanvibe, 143 stars) and Release TS SDK (aptos-labs/aptos-ts-sdk, 116 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Release Notes?

Aivis-Project (a GitHub organization) maintains it in Aivis-Project/AivisSpeech, which has 483 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on July 12, 2026.

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