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.
shields.io
Para los README que se estandarizan en insignias de shields.io, el registro también está disponible mediante la insignia de endpoint de shields. Cada repositorio sirve su estado actual como JSON de endpoint en https://inspect.software/badge/v1/OWNER/REPO.json, que shields renderiza en su propio lenguaje visual:
[](https://inspect.software/software/OWNER/REPO)La insignia renderizada enuncia el mismo índice, el mismo vocabulario de bandas y el mismo color de banda que la insignia nativa — los repositorios certificados encabezan con su calificación en letras — y se refresca con la misma cadencia horaria. Todos los parámetros de estilo de shields (style=, logo=, …) se aplican como en cualquier otra insignia de shields.
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 profundo excepcional al rojo crítico, y enuncia la banda en palabras junto al índice.
- Los repositorios certificados llevan un sello. Los repositorios de las tres bandas superiores muestran una roseta en relieve con su calificación en letras — A, AA o AAA —, la marca visible de su nivel de certificación. El sello es una marca de certificación, de modo que un repositorio por debajo de Bueno no lo lleva; su insignia enuncia la banda y el índice sin él.
- Un único tamaño fijo. Toda insignia mide 137×20 píxeles diga lo que diga el índice, así que un README nunca se recompone cuando el índice se mueve y una fila de insignias se mantiene alineada.
- 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.