Publish this repo

Publish this repo via gh skill publish

When to Use

• ユーザーが「公開して」「デプロイして」「リリースして」「publish」「release」等を発話したとき
• リポジトリ 1natsu-vacation/agent-skills を Consumer に届ける Release を新規作成するとき
• git push だけでは公開にならないことを思い出す必要があるとき

Why this skill exists

このリポジトリは過去 npx skills add 1natsu-vacation/agent-skills -g が main ブランチを直接取得する仕組みだったため、main への push が事実上の公開になっていた。版管理ができず、意図しないコミットが即座に Consumer に届くリスクがあった。

gh skill publish (gh CLI v2.90.0+) によって GitHub Release＋semver タグが正式な公開ゲートとなったため、本 skill は Release 作成プロセス全体をガイドする。

Runbook

Step 1. 前提条件チェック

以下を順に実行し、不備があれば中断してユーザーに修正を促す。

gh --version       # 2.90.0 以上であること
gh auth status     # 認証済みであること
git status         # working tree がクリーンであること
git rev-parse --abbrev-ref HEAD   # 現在ブランチが main であること
git fetch origin && git status -uno   # origin/main と同期していること
gh api repos/1natsu-vacation/agent-skills/immutable-releases --jq '.enabled'   # true であること

最後の immutability チェックが false を返した場合、本フローを中断してユーザーに以下を案内する:

1. ブラウザで https://github.com/1natsu-vacation/agent-skills/settings を開く
2. ページ下部の "Releases" セクションへスクロール
3. "Enable release immutability" のチェックボックスを ON にして保存
4. 再度 gh api .../immutable-releases --jq '.enabled' が true を返すことを確認してから本フローを再開

immutability はリポジトリレベル設定で、有効化以降の future releases にのみ自動付与される（既存リリースには遡及しない）。gh skill publish の CLI フラグや対話プロンプトでは制御できないため、Step 1 のここで確認しておくことが必須。

Step 2. dry-run 検証

リポジトリルートで以下を実行し、配布対象の全スキル（skills/1natsu-*/SKILL.md）が Agent Skills 仕様に合格することを確認する。

gh skill publish --dry-run .

検証項目:

• スキル名が agentskills.io の命名規則に準拠（小文字英数字+ハイフン、3文字以上）
• スキル名がディレクトリ名と一致
• 必須 frontmatter フィールド（name, description）が存在
• allowed-tools が文字列（配列ではない）

失敗があれば本フローを中断し、該当スキルの修正をユーザーに依頼する。gh skill publish --fix . で自動修正可能なケースもある。

注意: .claude/skills/publish-this-repo/SKILL.md は metadata.internal: true かつ gh skill publish のスキャン対象外（.claude/ 配下）なので検証対象に含まれない（含まれるべきでもない）。

また dry-run / 本番公開の実行時に .claude/skills/ contains installed skills and should be added to .gitignore to avoid publishing other authors' content という警告が出るが、当リポジトリでは想定内で無視してよい。この警告は汎用ヒューリスティックで、.claude/skills/ 配下の spec-drift-watch 等（自リポジトリの Internal skill・意図的にバージョン管理下）を「他者のインストール済みスキル」と誤認したもの。.claude/ は publish のスキャン対象外のため公開内容には影響せず、gitignore すべきものでもない（gitignore すると spec-watch 機構がリポジトリから失われる）。

Step 3. semver 決定

直近のリリースタグを確認し、main までの差分から semver を決定する。

LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
if [ -z "$LAST_TAG" ]; then
  git log --oneline   # 初回リリース
else
  git log "$LAST_TAG"..HEAD --oneline   # 前回タグ以降
fi

分類基準:

• major (vX.0.0): 既存スキルの破壊的変更（削除、name 変更、互換性のない description 変更）
• minor (vX.Y.0): 新規スキル追加、既存スキルの後方互換な機能追加
• patch (vX.Y.Z): バグ修正、ドキュメント・タイポ修正、内部リファクタ

候補バージョンをユーザーに提示して確認を取る。

Step 4. 本番公開

gh skill publish . を対話モードで実行し、プロンプトに以下のように応答する。

gh skill publish .

プロンプト	推奨応答
Add agent-skills topic to the repository?	Yes
Tag strategy	Semver
Version tag	Step 3 で決めた値（例: v0.2.0）
Generate release notes automatically?	Yes

immutability は Step 1 で検証済みのリポジトリ設定（immutable-releases.enabled: true）により、本コマンドで作成される release に自動付与される。CLI 側でのプロンプト/フラグ制御は存在しない。

非対話で済ませたい場合は gh skill publish --tag vX.Y.Z . も可（immutability 挙動はリポジトリ設定が支配するため、対話モードと差はない）。

Step 5. 公開後確認

gh release view vX.Y.Z                                              # Release が作成されたか
gh release view vX.Y.Z --json isImmutable --jq '.isImmutable'       # immutable=true であること

isImmutable が false の場合は Step 1 の immutability 設定確認を見直す（リポジトリ設定が release 作成より後に有効化された等）。Step 7 の手順で再 publish が必要。

Step 6. 緊急ロールバック

公開後に不具合が判明した場合:

gh release delete vX.Y.Z --cleanup-tag --yes

タグも一緒に削除される。immutable release は削除自体は可能だが、削除後に同バージョンを再公開すると新しい immutable インスタンスとして扱われる（タグが指す commit が変わる場合は consumer 側のキャッシュ整合に注意）。安全策としては別バージョン（patch bump）を切るのが望ましい。

Step 7. 既存リリースを immutable 化する

リポジトリ設定で immutability を有効化する 前 に作成された release は遡及で immutable にならない。immutable 化したい場合:

1. Step 1 と同様にリポジトリ設定の immutability が ON か確認（OFF なら有効化）
2. 該当 release を削除: gh release delete vX.Y.Z --cleanup-tag --yes
3. 同バージョンで再 publish: gh skill publish --tag vX.Y.Z .
4. Step 5 と同様に gh release view vX.Y.Z --json isImmutable --jq '.isImmutable' が true を返すことを確認

Step 8. トラブルシュート

エラー	対処
skill name does not match directory name	skills/<dir>/SKILL.md の name: フィールドと <dir> を一致させる
description is required	frontmatter に description: を追加（発動条件を具体的に書く）
allowed-tools must be a string	配列で書いていたら "Read, Write, Bash" 等の文字列に変換
gh: command not found または old version	brew upgrade gh で 2.90.0 以上に更新
not authenticated	gh auth login を実行
immutable-releases API が 404	gh CLI / GitHub 側の機能未到達。brew upgrade gh 後に再試行、それでも駄目なら GitHub Web UI から状態確認
公開後 release が isImmutable: false	リポジトリ設定 immutability が release 作成より後に有効化されたケース。Step 7 で再 publish
Consumer から「最新が反映されない」報告	(a) 最新の Release を作成済みか確認（gh skill install は Release タグ取得）。(b) Consumer が npx skills add / apm install の main 取得経路なら Release 不要で、main への反映タイミングの問題

References

• gh skill publish reference: https://cli.github.com/manual/gh_skill_publish
• Vercel skills README (Internal flag spec): https://github.com/vercel-labs/skills/blob/main/README.md
• Immutable releases (GitHub Docs): https://docs.github.com/en/code-security/concepts/supply-chain-security/immutable-releases
• Preventing changes to your releases (GitHub Docs): https://docs.github.com/en/code-security/how-tos/secure-your-supply-chain/establish-provenance-and-integrity/preventing-changes-to-your-releases