Cada repositorio del registro público lleva una insignia integrable: un pequeño SVG que muestra el índice de salud actual y la banda de calificación, con enlace al informe completo. La insignia es el registro hecho visible allí donde se toman las decisiones — en el README, junto a las instrucciones de instalación.
Integrar una insignia
Cada página de informe proporciona fragmentos listos para copiar para su repositorio. El patrón:
[](https://inspect.software/software/OWNER/REPO)<a href="https://inspect.software/software/OWNER/REPO">
<img src="https://raw.githubusercontent.com/inspect-software/badges/main/v1/O/OWNER/REPO.svg"
alt="inspect.software health badge for OWNER/REPO" />
</a>Basta con reemplazar OWNER/REPO por el nombre completo del repositorio, y O por la primera letra del nombre del propietario en minúscula: las insignias se archivan bajo esa letra para que ningún directorio del repositorio crezca hasta hacerse inmanejable. Copiar los fragmentos exactos desde la página de informe del repositorio en el registro público evita equivocarse.
Cómo se comportan las insignias
- Siempre actual. La insignia refleja la última inspección publicada y se actualiza automáticamente tras cada escaneo — no hace falta volver a integrarla.
- Servida desde GitHub. Las imágenes de las insignias se publican en el repositorio público inspect-software/badges y las entrega la propia red de contenidos de GitHub. Un README con una insignia no depende de que este sitio esté accesible.
- Ruta versionada. El segmento
/v1/de la ruta es estable; cualquier cambio futuro en la semántica de las insignias llega como una nueva versión, nunca como un cambio silencioso. - Coloreada por banda. La insignia lleva el color de la banda actual del repositorio, del verde excelente al rojo crítico.
- Nunca rota. Un repositorio que aún no está en el registro recibe una insignia neutra en lugar de una imagen rota.
Qué afirma una insignia
Una insignia afirma exactamente lo que afirma el informe que la respalda: práctica medida y públicamente visible bajo una metodología versionada — y nada más. Es una señal para la revisión, no una garantía de calidad o seguridad (véase señales, no garantías). El informe enlazado muestra siempre el perfil completo por categorías, los componentes de cada métrica y los datos brutos.
Obtener una insignia
- Enviar el repositorio desde la página de inicio (requiere inicio de sesión con GitHub).
- Los repositorios de alto valor público se inspeccionan gratuitamente; los demás siguen la vía de certificación.
- Una vez publicado el informe, copiar los fragmentos de la insignia desde la página del informe.