Prepare Release

What it does

When your agent uses it

• Tasks that involve iOS development
• Tasks that involve Changelog and release notes
• Tasks that involve Markdown

Example prompts

• “/prepare-release”

Requirements

• Python 3
• Node.js
• Docker
• Pre-approved tools (allowed-tools): Bash(cat *), Bash(grep *), Bash(jq *), Bash(rg *), Bash(awk *), Bash(curl -s *), Bash(npm view *), Bash(git diff *), Bash(git log *), Bash(git status *), Bash(swift package compute-checksum *), Read, Edit, Grep

Workflow steps

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

1. 1First: wasm-g2p-v (npm @piper-plus/g2p) — g2p に変更が無く既公開なら skip
2. 2Second: npm-v (npm piper-plus、 g2p に依存)
3. 3Third: dev-create-release.yml を workflow_dispatch (version 入力) で実行
4. 4Fourth: kotlin-g2p-v (Maven Central、 独立) — 既公開なら skip
5. 5Fifth: Package.swift の checksum を pre-tag 更新 (フェーズ 5 の workflow_dispatch artifact から compute-checksum → dev に commit)
6. 6Last: その checksum commit に v tag を push → release-shared-lib.yml (libpiper_plus + iOS/Android xcframework)

What it can do on your machine

Read from SKILL.md and the folder at commit 9c6946e. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Bash(cat *)
  • Bash(grep *)
  • Bash(jq *)
  • Bash(rg *)
  • Bash(awk *)
  • Bash(curl -s *)
  • Bash(npm view *)
  • Bash(git diff *)
  • Bash(git log *)
  • Bash(git status *)

  …and 4 more on the same allowed-tools line.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • uv
  • npm
  • gh
  • curl
  • jq
  • swift
  • git
  • cargo

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

• Network

  Hosts in commands or code, which the agent is likely to contact:

  • pypi.org
  • crates.io
  • api.nuget.org
  • search.maven.org

  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

Prepare Release loads about 2k tokens when it runs. Until then it costs about 58 tokens; SKILL.md has 575 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~58

When it runs · the whole SKILL.md, loaded when a task matches

~2k

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

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 ayutaz/piper-plus at commit 9c6946e, republished under its MIT licence (© ayutaz). 575 words, ~1,966 tokens.

name

prepare-release

description

9 パッケージ × 5 レジストリの version bump と関連ファイル更新 (Cargo.lock / package-lock.json / Swift checksum / CHANGELOG 昇格) を 1 コマンドで適用案にする read-mostly skill。`release-prep` (確認用) の続きに呼び、 実 bump 差分の markdown 提案 + 順序付き publish ガイドを生成する。

allowed-tools

Bash(cat *), Bash(grep *), Bash(jq *), Bash(rg *), Bash(awk *), Bash(curl -s *), Bash(npm view *), Bash(git diff *), Bash(git log *), Bash(git status *), Bash(swift package compute-checksum *), Read, Edit, Grep

argument-hint

<runtime|all> --target-version X.Y.Z [--dry-run]

disable-model-invocation

true

uv run python scripts/check_voice_catalog_parity.py 2>&1 | tail -3
uv run python scripts/check_ort_versions.py 2>&1 | tail -3
uv run python scripts/check_openjtalk_version_sync.py 2>&1 | tail -3
uv run python scripts/check_ruff_version_sync.py 2>&1 | tail -3
uv run python scripts/check_migration_changelog_parity.py 2>&1 | tail -3

# Python
uv lock --upgrade-package piper-plus
# Rust
(cd src/rust && cargo update -p piper-plus)
# npm synth
(cd src/wasm/openjtalk-web && npm install --package-lock-only)
# npm g2p
(cd src/wasm/g2p && npm install --package-lock-only)

# 1. release-shared-lib.yml を tag 無しで workflow_dispatch 実行し artifact を生成
gh workflow run release-shared-lib.yml --ref dev
# 完了後、run の workflow artifact を取得 (release ではない)
gh run download <run-id> --name libpiper_plus-ios-xcframework
# g2pChecksum は g2pVersion が今回 tag と一致する時のみ取得・更新
gh run download <run-id> --name libpiper_plus_g2p-apple-xcframework

# 2. swift package compute-checksum (workflow artifact のファイル名は version 無し)
swift package compute-checksum libpiper_plus-ios.xcframework.zip
swift package compute-checksum libpiper_plus_g2p-apple.xcframework.zip   # g2pVersion == TARGET のみ

# 3. Package.swift の `let checksum` (synthesis) を更新。
#    `let g2pChecksum` は g2pVersion が今回 tag と一致する時のみ更新
#    (異なる場合 release-shared-lib.yml が g2p checksum 検証を自動 skip する)。

# 4. dev に commit し、その commit に v<TARGET_VERSION> tag を push (フェーズ 7 の順序)

awk '/^## \[Unreleased\]/{flag=1; next} /^## /{flag=0} flag' CHANGELOG.md

## [<TARGET_VERSION>] - <YYYY-MM-DD>

(Unreleased から移動した内容)

## [Unreleased]

(空 or next-version 着手項目)

# 各 registry で publish 完了を確認
curl -s https://pypi.org/pypi/piper-plus/json | jq -r '.info.version'
curl -s https://crates.io/api/v1/crates/piper-plus | jq -r '.crate.max_version'
npm view piper-plus version
npm view @piper-plus/g2p version
curl -s "https://api.nuget.org/v3-flatcontainer/piperplus.core/index.json" | jq -r '.versions[-1]'
curl -s "https://search.maven.org/solrsearch/select?q=g:io.github.ayutaz+AND+a:piper-plus-g2p-android&rows=1&wt=json" | jq -r '.response.docs[0].latestVersion'

# 全 runtime の v2.0.0 リリース bump 案を生成 (dry-run)
/prepare-release all --target-version 2.0.0

# Python だけ確定、 適用
/prepare-release python --target-version 2.0.0 --apply

# Rust 0.5.0 リリース、 lockfile 再生成手順のみ表示
/prepare-release rust --target-version 0.5.0

© ayutaz, MIT. 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/prepare-release of ayutaz/piper-plus.

Open the folder on GitHubat commit 9c6946e