早わかり: Skyline はモデル向け、GitHub City はブラウザ探索向け
GitHub Skyline はモデル出力を意識した GitHub 貢献可視化です。カレンダーやブラウザ都市ではなく、活動を3D skyline として表現します。
違いは出力形式です。Skyline はファイル、模型、3Dプリントが目的の時に向きます。GitHub City はユーザー名を入力してすぐ3D都市を見たい時に向きます。
生成前に公式の貢献グラフを確認してください。commit email、branch、fork、private 表示、更新待ちが欠落の原因になります。
基本手順は、データ確認、出力形式での選択、モデルファイルが必要な場合だけ Skyline を使うことです。
How a GitHub Skyline Workflow Usually Works
A Skyline workflow has more setup than a browser-only visualizer, but the steps are predictable once you separate data checks from model generation.
プロフィールとグラフを確認
公開 GitHub プロフィールから確認します。公式グラフが空または不完全なら、まずその原因を直します。
GitHub CLI を準備
GitHub Skyline は通常、Web フォームではなくコマンドラインの流れで扱います。
skyline モデルを生成
正しいアカウントと年を指定し、認証状態をそろえて生成します。
印刷や共有前に確認
活動が多い週が期待通りの高さになっているか確認します。空なら公式グラフに戻ります。
短時間なら GitHub City を使う
ポートフォリオ画像や素早い確認なら GitHub City の方が手軽です。
GitHub Skyline vs GitHub City vs the Official Contribution Graph
Choose by output format. Skyline is model-first, GitHub City is browser-first, and the official graph is the source-of-truth checkpoint.
| 選択肢 | 向いている用途 | 出力 | 手間 | 選ぶ場面 |
|---|---|---|---|---|
| GitHub Skyline | 出力または3Dプリント用の貢献履歴 | 3D skyline モデル | 中 | モデルファイル、STL系の流れ、ローカル生成が必要な時。 |
| GitHub City | 素早いオンライン3D可視化 | ブラウザ上のインタラクティブ3D都市 | 低 | ユーザー名を入力してすぐ探索したい時。 |
| GitCity / CodeCity | 別のプロフィール可視化 | 共有しやすい視覚シーン | 低から中 | 別の都市表現を使いたい時。 |
| 公式 GitHub 貢献グラフ | 活動が数えられたか確認 | カレンダー heatmap | なし | 3D可視化前の基準が必要な時。 |
Troubleshooting: Why a GitHub Skyline Can Look Empty or Wrong
Most Skyline problems start before the model is generated. If GitHub does not count an activity item in the official graph, a skyline export may not include it either. The usual causes are unmatched commit email, activity on a branch GitHub does not count, work left in an unmerged fork, private contribution visibility, repository eligibility, or a short delay before GitHub refreshes profile activity.
The second group of issues is local workflow friction. A command-line visualizer can fail because the CLI extension is not installed, authentication is missing, permissions do not match the target account, or the requested year has little visible activity. Treat those as setup problems rather than SEO or visualization problems.
Finally, remember that a skyline is a visual metaphor. Different tools may map weeks, days, or contribution counts into height differently. A skyline that looks shorter than a city does not always mean the data is wrong; it may simply use a different rendering scale.
不足したコミット
commit email、対象 branch、fork、repository visibility、更新時間を確認します。
private の作業
private contribution は設定により非表示または匿名化されます。
誤ったアカウントや年
ユーザー名と対象期間を確認します。
セットアップ失敗
GitHub CLI、認証、拡張、repository の手順を確認します。
When GitHub Skyline Is Worth Using
Use GitHub Skyline when the final artifact is the point. It is a better fit for 3D printing, physical desk objects, event displays, team retrospectives, and personal developer keepsakes. In those cases, the extra local setup pays off because you can control the generated model instead of relying on a live browser scene.
Use GitHub City when speed and accessibility matter more. A recruiter, teammate, or visitor can open a page, enter a public username, and see a contribution city without installing anything. That makes GitHub City more practical for quick portfolio exploration, while Skyline remains better for model-oriented projects.
A strong portfolio can use both: Skyline for a polished export or printed object, GitHub City for interactive exploration, and the official GitHub contribution graph as the factual baseline. Link them with clear language so viewers understand that all three are different views of contribution history rather than three competing measurements.
Practical rule
If you cannot explain why you need a model file, start with GitHub City. If you need a physical or exportable skyline, use GitHub Skyline after verifying the official contribution graph.
FAQ
What is GitHub Skyline?
GitHub Skyline is a model-oriented way to turn GitHub contribution history into a skyline-style 3D visualization, often discussed with the gh-skyline workflow.
Is GitHub Skyline the same as GitHub City?
No. GitHub Skyline is better for exportable skyline models, while GitHub City is better for quick browser-based 3D city exploration.
Can GitHub Skyline make an STL file?
Skyline searches often focus on STL-style or printable output. Follow the current gh-skyline repository instructions for exact export behavior because project tooling can change.
Why is my GitHub Skyline empty?
First check the official GitHub contribution graph. Missing commit email, branch rules, forks, private visibility, repository eligibility, or the wrong year can make a skyline look empty.
Which is better for a portfolio, GitHub Skyline or GitHub City?
Use GitHub City for a fast interactive visual on the web. Use GitHub Skyline when you want a model, print, or exportable artifact as part of the portfolio story.