GitHub Skyline：3D貢献Skylineの作成、出力、比較

早わかり: Skyline はモデル向け、GitHub City はブラウザ探索向け

GitHub Skyline はモデル出力を意識した GitHub 貢献可視化です。カレンダーやブラウザ都市ではなく、活動を3D skyline として表現します。

違いは出力形式です。Skyline はファイル、模型、3Dプリントが目的の時に向きます。GitHub City はユーザー名を入力してすぐ3D都市を見たい時に向きます。

生成前に公式の貢献グラフを確認してください。commit email、branch、fork、private 表示、更新待ちが欠落の原因になります。

基本手順は、データ確認、出力形式での選択、モデルファイルが必要な場合だけ Skyline を使うことです。

公式のgh-skylineプロジェクトは、GitHubの貢献データからバイナリSTLファイルを生成するGitHub CLI拡張として説明されています。現在の導入コマンドはgh extension install github/gh-skylineです。オプションや前提条件はリポジトリで確認し、出力形式の比較にはGitHub City・GitCity・GitHub Skyline比較を使います。

GitHub Skylineのワークフロー

Skylineはブラウザーだけで使う可視化ツールより準備が必要ですが、データ確認とモデル生成を分ければ手順は整理できます。

GitHub Skyline・GitHub City・公式コントリビューショングラフ

出力形式で選びます。Skylineはモデル、GitHub Cityはブラウザー、公式グラフはデータ確認の基準です。

トラブル対処：GitHub Skylineが空または不正に見える理由

Skylineの問題の多くはモデル生成前に起きます。公式グラフでGitHubが活動を数えていなければ、出力にも含まれない可能性があります。未関連付けのコミットメール、対象外のブランチ、未マージのフォーク、非公開貢献の表示設定、リポジトリ条件、更新待ち時間を確認してください。

次の問題はローカル環境です。CLI拡張が未導入、認証不足、アカウントの権限不一致、指定年の活動不足などでコマンドラインの可視化が失敗することがあります。これは設定の問題であり、SEOや可視化データの問題とは分けて考えます。

Skylineは視覚的な比喩でもあります。ツールによって週、日、貢献数を高さへ変換する方法が異なります。街より低いSkylineでも、データが間違っているとは限らず、表示スケールが違う場合があります。

GitHub Skylineが向いている場面

最終成果物が重要ならGitHub Skylineを使います。3Dプリント、机に置く模型、イベント、チームの振り返り、開発者向けの記念品に向いています。ローカル設定を行う分、生成モデルを管理できます。

速さと手軽さが重要ならGitHub Cityを使います。採用担当者、チームメンバー、訪問者はページを開いて公開ユーザー名を入力するだけで、インストールなしに貢献の街を確認できます。

ポートフォリオでは両方を使えます。Skylineは書き出しや印刷用、GitHub Cityは操作できる探索用、公式コントリビューショングラフは事実確認用です。3つは競合する測定値ではなく、貢献履歴の異なる見せ方だと説明してください。