Respuesta rápida: GitHub Streak Stats es un widget de README, no una nota de productividad
GitHub streak stats suele referirse a una tarjeta para el README del perfil que calcula días consecutivos o actividad tipo racha a partir de contribuciones públicas. Sirve como señal rápida, pero no representa todo tu trabajo: revisiones, planificación, pair programming, trabajo privado o actividad fuera de GitHub pueden quedar fuera.
El uso correcto es concreto: añade la tarjeta si quieres un indicador ligero dentro del README. Para estructurar todo el perfil, usa la guía de plantilla de GitHub profile README. Para una imagen 3D generada por Actions, consulta profile-3d-contrib. Para una ciudad 3D interactiva, enlaza GitHub City.
Antes de cambiar el widget, compara el resultado con el gráfico oficial de contribuciones. Si GitHub no cuenta un commit por email, rama, fork, visibilidad privada o tiempo de actualización, la tarjeta normalmente tampoco podrá recuperarlo.
Cómo añadir GitHub Streak Stats sin cargar demasiado el README
Una buena implementación es pequeña y deliberada. Coloca la tarjeta cerca de la sección de actividad o prueba, mantén una explicación breve y evita apilar demasiados widgets remotos antes de los proyectos.
La tarjeta debe responder una pregunta: ¿este perfil muestra actividad visible? No debería ser el héroe del README si el perfil aún no explica quién eres, qué construyes y qué proyectos merecen atención.
Define qué prueba la tarjeta
Úsala para mostrar ritmo visible de contribución, no como única prueba de habilidad, seniority o fiabilidad.
Copia la URL oficial
Empieza desde el servicio o repositorio mantenido, configura el username y elige un tema legible en modo claro y oscuro.
Insértala en README.md
Usa Markdown normal o una etiqueta HTML con alt útil. Colócala bajo el resumen y cerca de la prueba de proyectos.
Revisa el gráfico oficial
Si la racha parece rota, consulta las reglas de contribución antes de tocar la tarjeta. La guía del contribution graph cubre las causas comunes.
Añade contexto, no más widgets
Una tarjeta de racha más una tarjeta de stats o un enlace a GitHub City suele bastar. Demasiadas tarjetas ralentizan y distraen.
GitHub Streak Stats vs GitHub Readme Stats vs GitHub City
Una tarjeta de streak debe apoyar proyectos reales, no competir con ellos. Colócala después del resumen inicial, usa un alt claro y explica que mide actividad visible de GitHub, no todo el trabajo de ingeniería. Si el perfil necesita una estructura completa antes de añadir widgets, revisa la guía de README template; si quieres una visualización 3D interactiva, enlaza GitHub City.
Estas herramientas cuentan partes distintas de la historia del perfil. Streak stats se centra en constancia, GitHub Readme Stats resume señales de repositorios o lenguajes, y GitHub City convierte el historial en una escena 3D interactiva.
| Opción | Mejor para | Configuración | Riesgo | Uso recomendado |
|---|---|---|---|---|
| GitHub streak stats | Mostrar ritmo visible en un README de perfil. | Añadir una URL remota o referencia de imagen. | Puede parecer una nota de productividad si no se explica. | Señal compacta cerca de la prueba de proyectos. |
| GitHub Readme Stats | Mostrar lenguaje, repositorios o resumen general. | Configurar parámetros y temas. | Muchas tarjetas pueden volver lento y confuso el README. | Úsalo cuando la tarjeta apoye los proyectos. |
| GitHub City | Explorar contribuciones como ciudad 3D. | Abrir la herramienta y escribir un username. | No es una tarjeta de README si no se enlaza con claridad. | Cuando quieres un visual interactivo memorable. |
| profile-3d-contrib | Generar imágenes 3D para README con Actions. | Configurar permisos y rutas de salida. | Un fallo de workflow puede romper la imagen. | Cuando el README necesita archivos 3D generados. |
Solucionar tarjetas de racha rotas, vacías o engañosas
La mayoría de problemas son de datos, no de diseño. Si el gráfico oficial no muestra actividad, la tarjeta probablemente tampoco. Empieza por email de commit, rama principal, forks, visibilidad del repositorio, contribuciones privadas y retrasos de actualización.
Después revisa la configuración de la tarjeta: username, codificación de URL, nombre de tema, caché y si GitHub puede cargar la imagen remota. Si el README pesa demasiado, elimina widgets antes de añadir más.
La racha se reinició
Comprueba si el día faltante aparece en el gráfico oficial. Si no, revisa email, ramas, forks, ajustes privados y zona horaria.
La tarjeta está en blanco
Confirma que el servicio responde, que el username es correcto y que GitHub puede cargar la imagen remota.
El README está saturado
Mantén una tarjeta de actividad, proyectos claros y un enlace visual opcional. Baja lo decorativo.
La métrica parece injusta
Aclara que refleja actividad visible de GitHub, no todo el trabajo de ingeniería ni la calidad del código.
Dónde colocar una tarjeta de racha en un perfil sólido
Una tarjeta de racha funciona mejor después del resumen inicial y antes o después de proyectos destacados. Así ofrece una señal rápida sin ocultar la evidencia principal.
Para contar una historia de portfolio, combina contexto escrito, proyectos reales y una sola capa visual. Puede ser una tarjeta de racha, GitHub Readme Stats, profile-3d-contrib o un enlace a GitHub City. No hagas que todas compitan arriba.
Si ya usas GitHub City, preséntalo como exploración: el visitante puede abrir la ciudad 3D para entender el patrón detrás de la tarjeta.
Regla práctica
Si la tarjeta no hace que el siguiente proyecto sea más confiable, muévela abajo o elimínala.
FAQ
¿Qué es GitHub streak stats?
Un visual de README que muestra actividad consecutiva o tipo racha basada en contribuciones públicas.
¿Cómo lo añado a mi perfil?
Añade una URL de tarjeta mantenida a README.md en el repositorio especial que coincide con tu username y verifica que cargue bien.
¿Por qué se reinició mi streak?
Normalmente porque GitHub no contó actividad visible durante uno o más días, o por caché/configuración del servicio.
¿Es igual que GitHub Readme Stats?
No. Streak stats se centra en actividad consecutiva; GitHub Readme Stats resume perfil, repositorios o lenguajes.
¿Conviene usarlo con GitHub City?
Sí, si cada uno cumple una función: tarjeta rápida en README y GitHub City para exploración interactiva.