빠른 답변: Skyline은 모델용, GitHub City는 브라우저 탐색용
GitHub Skyline은 모델 중심의 GitHub 기여 시각화입니다. 달력 그래프나 브라우저 도시 대신 기여 활동을 3D 스카이라인으로 바꿉니다.
핵심 차이는 출력입니다. Skyline은 파일, 모델, 3D 프린트가 목적일 때 적합합니다. GitHub City는 사용자 이름을 입력하고 바로 3D 도시를 보고 싶을 때 더 빠릅니다.
생성 전에 공식 GitHub 기여 그래프를 확인하세요. 커밋 이메일, 브랜치, 포크, 비공개 설정, 갱신 지연 때문에 활동이 빠질 수 있습니다.
안전한 순서는 데이터 확인, 출력 형식 선택, 모델 파일이 필요할 때만 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은 보통 브라우저 폼이 아니라 명령줄 워크플로로 다룹니다.
스카이라인 모델 생성
올바른 계정과 연도에 대해 일관된 인증 상태로 모델을 생성하세요.
출력 전 검토
활동이 많은 주가 예상한 높이로 보이는지 확인하세요. 비어 보이면 공식 그래프로 돌아가세요.
빠른 대안으로 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 스카이라인 모델 | 중간 | 모델 파일, STL형 워크플로, 로컬 생성이 필요할 때. |
| GitHub City | 빠른 온라인 3D 시각화 | 브라우저의 인터랙티브 3D 도시 | 낮음 | 사용자 이름을 입력하고 바로 탐색하고 싶을 때. |
| GitCity / CodeCity | 다른 프로필 시각 스토리텔링 | 공유 가능한 시각 장면 | 낮음-중간 | 다른 도시 은유나 표현을 원할 때. |
| 공식 GitHub 기여 그래프 | 활동이 집계됐는지 확인 | 달력 히트맵 | 없음 | 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.
누락된 커밋
커밋 이메일, 집계 브랜치, 포크, 저장소 공개 여부, 갱신 시간을 확인하세요.
비공개 작업
비공개 기여는 프로필 설정에 따라 숨겨지거나 익명 처리될 수 있습니다.
잘못된 계정 또는 연도
사용자 이름과 기간을 확인하세요.
설정 실패
GitHub CLI, 인증, 확장 설치, 저장소 안내를 확인하세요.
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.