빠른 답: GitHub Streak Stats는 README 위젯이지 생산성 점수가 아닙니다
GitHub streak stats는 보통 공개 GitHub contribution 데이터를 바탕으로 연속 활동을 계산해 README에 보여주는 카드입니다. 빠른 시각 신호로는 좋지만 실제 작업 전체를 기록하지는 않습니다.
가장 좋은 쓰임은 명확합니다. 프로필 README 안에 가벼운 활동 위젯이 필요할 때만 사용하세요. 전체 구조는 GitHub profile README template 가이드, 자동 3D 이미지는 profile-3d-contrib, 인터랙티브 3D 탐색은 GitHub City가 맞습니다.
위젯을 고치기 전에 공식 contribution graph와 비교하세요. 이메일, 브랜치, fork, 비공개 표시, 업데이트 지연 때문에 GitHub가 세지 않은 커밋은 카드도 대개 복구하지 못합니다.
README를 복잡하게 만들지 않고 GitHub Streak Stats 추가하기
좋은 설정은 작고 의도적입니다. 활동이나 증거 섹션 가까이에 카드를 두고 설명은 짧게 유지하며, 프로젝트보다 위에 원격 위젯을 너무 많이 쌓지 마세요.
카드는 한 가지 질문에 답해야 합니다. 이 프로필이 눈에 보이는 활동을 보여주는가? 아직 누가 무엇을 만들고 어떤 프로젝트가 중요한지 설명하지 못한다면 카드가 README의 주인공이 되어서는 안 됩니다.
카드가 무엇을 보여줄지 정하기
보이는 기여 리듬을 보여주는 데 사용하고 실력이나 신뢰성의 유일한 증거로 사용하지 마세요.
공식 카드 URL 복사하기
관리되는 서비스나 저장소에서 시작해 username을 설정하고 읽기 쉬운 테마를 선택하세요.
README.md에 삽입하기
Markdown이나 의미 있는 alt 텍스트가 있는 HTML 이미지를 사용하고 프로젝트 증거 가까이에 카드를 배치하세요.
공식 Contribution Graph 확인하기
streak가 이상하면 먼저 GitHub 규칙을 확인하세요. Contribution Graph 가이드에서 흔한 원인을 설명합니다.
위젯보다 맥락을 추가하기
streak 카드에 stats 카드나 GitHub City 링크를 하나 더하는 정도면 충분합니다. 카드가 너무 많으면 느리고 복잡해집니다.
GitHub Streak Stats vs GitHub Readme Stats vs GitHub City
스트릭 카드는 실제 프로젝트를 보조해야 하며 프로젝트와 경쟁하면 안 됩니다. 소개 뒤에 두고 명확한 alt를 넣으며, 이 카드가 보이는 GitHub 활동만 보여준다는 점을 설명하세요. 전체 구조가 먼저 필요하면 README template 가이드, 3D 탐색은 GitHub City가 적합합니다.
이 도구들은 프로필 이야기의 서로 다른 층을 담당합니다. Streak stats는 일관성, GitHub Readme Stats는 저장소나 언어 지표, GitHub City는 기여 기록의 인터랙티브한 3D 장면에 초점을 둡니다.
| 옵션 | 가장 적합한 경우 | 설정 | 위험 | 추천 사용 |
|---|---|---|---|---|
| GitHub streak stats | 프로필 README에 보이는 활동 리듬을 보여주기 | 원격 카드 URL이나 이미지 참조 추가 | 설명이 없으면 생산성 점수처럼 보일 수 있음 | 프로젝트 증거 가까이에 두는 간단한 신호 |
| GitHub Readme Stats | 언어, 저장소 또는 프로필 요약을 보여주기 | 매개변수와 테마 설정 | 카드가 너무 많으면 README가 느리고 산만해짐 | 카드가 프로젝트를 보조할 때 |
| GitHub City | 기여를 3D 도시로 탐색하기 | 도구를 열고 username 입력 | 명확한 링크 없이는 README 카드가 아님 | 기억에 남는 인터랙티브 보기 |
| profile-3d-contrib | Actions로 README용 3D 이미지 생성 | 워크플로 권한과 출력 경로 설정 | 워크플로 오류로 이미지가 깨질 수 있음 | README에 생성된 3D 파일이 필요할 때 |
깨지거나 비어 있거나 오해를 부르는 스트릭 카드 해결
streak 문제의 대부분은 디자인보다 데이터 문제입니다. 공식 contribution graph에 활동이 없으면 카드에도 보통 표시되지 않습니다. 커밋 이메일, 기본 브랜치, fork 처리, 저장소 공개 범위, 비공개 기여 설정, 업데이트 지연을 확인하세요.
다음으로 카드 설정을 확인합니다. username, URL 인코딩, 테마 이름, 캐시, GitHub가 원격 이미지를 가져올 수 있는지를 점검하세요. README가 느리거나 무거우면 위젯을 더 추가하기 전에 불필요한 카드를 줄이세요.
streak가 초기화됨
공식 그래프에서 빠진 날짜를 확인한 다음 이메일, 브랜치, fork, 비공개 설정, 시간대를 점검하세요.
카드가 비어 있음
서비스, username, GitHub의 원격 이미지 로딩 가능 여부를 확인하세요.
README가 복잡해 보임
활동 카드 하나, 명확한 프로젝트, 필요하면 시각 링크 하나면 충분합니다. 장식 요소는 아래로 내리세요.
지표가 불공정해 보임
이 지표는 보이는 GitHub 활동을 보여줄 뿐 전체 작업이나 코드 품질을 보여주지 않는다고 설명하세요.
좋은 GitHub 프로필에서 스트릭 카드를 둘 위치
스트릭 카드는 첫 소개 뒤, 주요 프로젝트 전후에 있을 때 가장 좋습니다. 포트폴리오 증거를 가리지 않으면서 빠른 활동 신호를 줍니다.
포트폴리오는 글로 된 맥락, 실제 프로젝트, 하나의 시각 레이어를 조합하세요. 그 레이어는 streak card, GitHub Readme Stats, profile-3d-contrib, GitHub City 링크 중 하나면 충분합니다.
이미 GitHub City를 쓴다면 탐색용으로 설명하세요. 방문자는 3D 도시를 열어 카드 뒤의 contribution 패턴을 더 잘 이해할 수 있습니다.
실전 규칙
스트릭 카드가 다음 프로젝트를 더 신뢰하게 만들지 못한다면 아래로 내리거나 제거하세요.
FAQ
GitHub streak stats란 무엇인가요?
공개 contribution 데이터를 바탕으로 연속 활동이나 streak 형태의 활동을 README에 보여주는 시각 요소입니다.
프로필에 어떻게 추가하나요?
사용자명과 같은 특별 프로필 저장소의 README.md에 유지보수되는 카드 URL을 추가하고 정상 표시를 확인합니다.
왜 streak가 초기화되었나요?
대개 GitHub가 하루 이상 보이는 활동을 세지 않았거나 서비스 캐시/설정이 맞지 않기 때문입니다.
GitHub Readme Stats와 같은가요?
아닙니다. Streak stats는 연속 활동에 집중하고 GitHub Readme Stats는 프로필, 저장소, 언어 신호를 요약합니다.
GitHub City와 함께 써도 되나요?
네. README에는 빠른 카드, GitHub City에는 인터랙티브 탐색이라는 역할이 분명할 때 좋습니다.