GitHub README에 리포지토리 헬스 배지를 10초 안에 추가하기

Source: Dev.to

GitHub README 상단에 있는 배지를 보신 적 있나요? 배지는 빌드가 정상인지, 어떤 라이선스를 사용하는지 알려줍니다. 멋지죠.

하지만 실제로 중요한 것은 알려주지 않아요:

• 이 저장소가 활발히 유지 관리되고 있나요?
• 유지 관리자가 이슈에 얼마나 빠르게 대응하나요?
• 무시된 이슈가 대량으로 쌓여 있나요?
• 이 프로젝트에 실제로 의존해도 될까요?

그래서 저는 그 질문들에 답해주는 배지를 만들었습니다.

빠른 시작

README에 다음을 추가하세요 (owner/repo를 여러분의 저장소로 교체):

[![Repo Health](https://api.gitscope.dev/api/badges/owner/repo.svg)](https://gitscope.dev)

그게 전부입니다. 회원가입 필요 없음. API 키 필요 없음. 설정도 필요 없음.

→ 모든 저장소에서 실시간 예시 보기
→ 문서 읽기

사용 가능한 모든 배지

Visit gitscope.dev/badges for the full list.

저장소 건강 점수

전체 저장소 건강 상태를 0‑100 %로 표시합니다. 활동성, 유지 관리, 커뮤니티 참여, 이슈 관리가 결합된 지표입니다.

[![Repo Health](https://api.gitscope.dev/api/badges/owner/repo/health.svg)](https://gitscope.dev)

유지 관리 상태

최근 커밋 및 이슈 활동을 기반으로 매우 활발함 | 활발함 | 유지 관리됨 | 정체 중 하나를 표시합니다.

[![Maintained](https://api.gitscope.dev/api/badges/owner/repo/maintained.svg)](https://gitscope.dev)

응답 시간

활동 기반 지표로, 저장소가 최근에 얼마나 업데이트되었는지를 보여줍니다.

[![Response Time](https://api.gitscope.dev/api/badges/owner/repo/response-time.svg)](https://gitscope.dev)

기여자 수

GitHub API에서 가져온 실제 기여자 수입니다.

[![Contributors](https://api.gitscope.dev/api/badges/owner/repo/contributors.svg)](https://gitscope.dev)

기여자 친화적

저장소가 새로운 기여자를 환영하는지 표시합니다 (good‑first‑issues, 기여 가이드, 응답 패턴 등).

[![Contributor Friendly](https://api.gitscope.dev/api/badges/owner/repo/contributor-friendly.svg)](https://gitscope.dev)

이슈 환영

프로젝트가 이슈 보고를 적극적으로 받아들이고 응답하는지를 보여줍니다.

[![Issues Welcome](https://api.gitscope.dev/api/badges/owner/repo/issues.svg)](https://gitscope.dev)

문서 품질

README 완성도, 위키 존재 여부, 연결된 문서를 기반으로 평가합니다.

IMAGE.png)](PLACEHOLDER_FOR_DOCS_IMAGE)

[![Docs](https://api.gitscope.dev/api/badges/owner/repo/docs.svg)](https://gitscope.dev)

(플레이스홀더 URL을 실제 “Documentation Quality” 배지 이미지 URL로 교체하십시오.)

스타일 맞춤

?style=을 추가하여 모양을 변경하세요:

Custom Colors

값 색상 변경

https://api.gitscope.dev/api/badges/owner/repo.svg?color=purple

다크 모드 (라벨 배경 변경)

https://api.gitscope.dev/api/badges/owner/repo.svg?labelColor=dark

사용 가능한 색상

brightgreen green yellow orange red blue cyan purple pink teal indigo gray

헥스 코드를 사용할 수도 있습니다. 예: ?color=ff69b4.

전체 README 예시

# My Awesome Project

[![Build](https://github.com/owner/repo/actions/workflows/ci.yml/badge.svg)](https://github.com/owner/repo/actions)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Repo Health](https://api.gitscope.dev/api/badges/owner/repo/health.svg)](https://gitscope.dev)
[![Maintained](https://api.gitscope.dev/api/badges/owner/repo/maintained.svg)](https://gitscope.dev)
[![Contributors](https://api.gitscope.dev/api/badges/owner/repo/contributors.svg)](https://gitscope.dev)

A brief description of your awesome project...

→ 저장소용 배지를 생성하세요

왜 이것이 중요한가

사용자 / 기여자에게

• 프로젝트가 실제로 유지 관리되는지 확인하고 의존할 수 있습니다.
• 이슈를 열기 전에 유지 관리자가 응답하는지 확인하세요.
• 기여자 친화적인 프로젝트를 찾으세요.

유지 관리자를 위해

• 유지 관리 작업에 대한 크레딧을 받으세요.
• 프로젝트가 건강하고 활발함을 알리세요.
• 응답이 빠른 유지 관리자를 중시하는 기여자를 끌어모으세요.

점수 계산 방법

배지는 Cloudflare의 엣지 네트워크에서 15분 캐시와 함께 제공됩니다. 전 세계적인 평균 응답 시간은 < 100 ms 입니다.

FAQ

가입해야 하나요?
아니요. 배지는 모든 공개 GitHub 저장소와 즉시 작동합니다.

배지는 얼마나 자주 업데이트되나요?
데이터는 15 분 동안 캐시됩니다. 상태 메트릭은 매시간 재계산됩니다.

README가 느려지나요?
아니요. 엣지‑캐시, 전 세계에 분산, 100 ms 미만 응답 시간.

지금 바로 사용해 보세요

→ 레포지토리용 배지를 생성하세요

Or construct the URL yourself:

https://api.gitscope.dev/api/badges/YOUR-ORG/YOUR-REPO.svg

아래에 저장소를 남겨 주세요 👇

리포지토리를 댓글로 남겨 주시면 건강 점수를 공유해 드립니다!

*OSS 유지보수자가 번아웃을 피하도록 돕기 위해 **GitScope*를 만들고 있습니다. 배지는 영구적으로 무료입니다. 전체 문서 보기.