bump-skill-version について
bump-skill-version は、CLAUDE.md のバージョニング規則に従ってスキルの `version:` フィールドを更新するスクリプトです。バージョン更新を独立した編集として扱い、フックによるパッケージ再構築にも対応します。
主な機能
- 01変更を patch、minor、major に分類
- 02YAML frontmatter を直接更新
- 03ほかの frontmatter フィールドを保持
- 04対象ファイルに未コミット変更がある場合は停止
- 05強制実行オプションに対応
活用シーン
- 01公開前にスキルのバージョンを更新
- 02ドキュメント修正を patch 更新として記録
- 03新機能や破壊的変更に合わせてバージョン更新
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/bump-skill-versionを入力して読み込まれたか確認します。
同梱ファイルscripts/bump.sh
詳細
bump-skill-version
CLAUDE.md → Versioning のルールに従って、skills/<name>/SKILL.md の version: フィールドを更新します。
- patch — バグ修正、誤字修正、ドキュメントの明確化
- minor — 新機能、新しいコマンド、新しいセクション
- major — スクリプトの CLI、マニフェスト形式、またはスキル構造に関する破壊的変更
使い方
bash "$CLAUDE_PROJECT_DIR/.claude/skills/bump-skill-version/scripts/bump.sh" <skill-name> <patch|minor|major>
更新前と更新後のバージョンを報告します。作業ツリーに対象の SKILL.md の未コミットの変更がある場合は実行を拒否します（バージョン更新を独立したアトミックな編集にするためです）。上書きするには --force を渡してください。
使用するタイミング
- 空白の軽微な変更を除き、
skills/<skill-name>/内のファイルを編集した後。 - エージェント（または人間のレビュアー）が公開する変更をコミットする前。
注記
- YAML フロントマターを読み込み、その場で書き換えます。他のフィールドはすべて保持されます。
package-skill.shの PostToolUse フックにより、SKILL.md の編集後にdist/<skill-name>.skillが自動的に再ビルドされます。
コメント
Markdown 対応