release-notes

Generate clear, skimmable GitHub release notes with **⚠️ Breaking Changes prominently displayed FIRST** (if any exist), followed by Highlights and detailed categorized sections. **Every listed change must include a link** to the originating issue or pull request. Can optionally upload the generated notes directly to a GitHub release using the gh CLI.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026⬇️1downloads

When & Why to Use This Skill

This Claude skill automates the generation of professional, skimmable GitHub release notes directly from git commit history. It intelligently categorizes updates—such as features, bug fixes, and documentation—while prioritizing breaking changes to ensure critical information is never missed. By integrating with the GitHub CLI (gh), it streamlines the entire release documentation workflow, ensuring every change is linked to its originating issue or pull request for maximum traceability.

Use Cases

  • Automated Changelog Generation: Quickly transform raw git logs into structured, readable release notes for stakeholders and users.
  • Breaking Changes Highlighting: Automatically detect and prominently display breaking changes at the top of the release to prevent downstream integration issues.
  • GitHub Release Management: Generate and upload release notes directly to a GitHub repository using the gh CLI, reducing manual copy-pasting.
  • Project Traceability: Maintain a clear audit trail by ensuring every listed change includes a direct link to the relevant pull request or issue.
namerelease-notes
descriptionリリースノートの生成。「リリースノートを作成」「CHANGELOGを更新」「変更履歴をまとめて」などのリクエスト時に使用。

Release Notes

コミット履歴からリリースノートを生成するスキル。

出力形式

日本語でリリースノートを生成する。

カテゴリ分類

コミットメッセージのプレフィックスに基づいて分類:

プレフィックス カテゴリ 説明
feat: 新機能 新しい機能の追加
fix: バグ修正 バグの修正
docs: ドキュメント ドキュメントの変更
style: スタイル コードスタイルの変更
refactor: リファクタ リファクタリング
perf: パフォーマンス パフォーマンス改善
test: テスト テストの追加・修正
chore: その他 ビルド・設定等の変更
ci: CI CI/CD の変更
deps: 依存関係 依存パッケージの更新

リリースノート テンプレート

# v{VERSION} リリースノート

リリース日: YYYY-MM-DD

## 新機能

- 機能説明 (#PR番号)

## バグ修正

- 修正内容 (#PR番号)

## その他の変更

- 変更内容

## 依存関係の更新

- パッケージ名: バージョン → バージョン

手順

  1. 対象範囲を確認(タグ間、日付範囲、コミット数)

  2. git log でコミット履歴を取得

    git log --oneline --no-merges {range}
    
  3. コミットをカテゴリ別に分類

  4. 各カテゴリの変更をリスト化

  5. PR 番号があれば付記

  6. テンプレートに沿って出力

git コマンド例

# 最新タグから現在までの変更
git log $(git describe --tags --abbrev=0)..HEAD --oneline --no-merges

# 特定のタグ間
git log v1.0.0..v1.1.0 --oneline --no-merges

# 直近N件のコミット
git log -n 20 --oneline --no-merges

# 日付範囲
git log --since="2025-01-01" --until="2025-01-31" --oneline --no-merges

注意事項

  • Renovate/Dependabot のコミットは「依存関係の更新」にまとめる
  • マージコミットは除外(--no-merges)
  • 重複する変更は統合
  • 破壊的変更がある場合は明記