SVG animado para GitHub · todos estos banners los dibujó Jano

Tu banner de README, en la pared.

Un skill para agentes de IA que le da a tu repositorio de GitHub un banner animado para el README: muestra lo que hace, en modo oscuro y claro, antes de que nadie lea una palabra.

Versión actual: v0.6.0

Instalación

Primero el plugin. Después, donde quieras.

Jano necesita Python 3.9 o posterior. Con uv no hace falta nada más; si no lo tienes, ejecuta pip install fonttools brotli una vez.

/plugin marketplace add ilien-dev/jano
/plugin install jano@jano

luego /jano:jano en tu proyecto

npx skills add ilien-dev/jano

luego /jano · $jano · "usa el skill jano en este repositorio"

Claude Code, Codex, Cursor, Gemini CLI y todos los agentes que admite la CLI de skills.

Cómo se usa

Un banner, o cuatro para elegir.

Abre tu agente en el proyecto y llama a Jano: /jano en Claude Code (/jano:jano como plugin), $jano en Codex.

01 · Un banner
/jano haz un hero para este repositorio

Jano lee el proyecto, dibuja el banner, lo revisa y lo coloca al principio de tu README.

02 · Cuatro para elegir
/jano haz 4 alternativas para el hero de este repositorio

Las opciones se abren una al lado de otra en una página. Quédate con una, o mézclalas: "el dibujo de B con la disposición de C". El README cambia solo cuando eliges.

Di lo que quieres ver
/jano muestra un libro convirtiéndose en EPUB, conserva nuestro amarillo
Jano nunca se ejecuta si no lo llamas, y no hace commit de nada.

Funciona con

Antes / después

El mismo README, con un banner arriba.

El banner va arriba. Tu título, texto, insignias y enlaces quedan tal como los escribiste.

jano / README.md
El banner de Jano: un cartel se dibuja parte por parte, se revisa y se guarda para el modo oscuro y el claro.
Jano

oscuro + claro

Dos archivos que siguen el tema de GitHub de cada visitante.

60–130 KB

SVG normal, solo CSS. Nada que instalar ni alojar.

revisado

Tamaño del texto, contraste, bucle, velocidad y peso del archivo, en cada build.

menos movimiento

Una imagen fija para quien desactiva las animaciones.

El nombre

¿Por qué Jano?

Jano es el dios romano de las puertas, los pasos y los comienzos (Janus, en latín). Se le dibuja con dos caras que miran en sentidos opuestos, y enero lleva su nombre.

El banner de un README es la puerta de un repositorio, lo primero que se ve. Jano también lo dibuja con dos caras: una para el tema oscuro de GitHub y otra para el claro.

Los demás proyectos de la galería también llevan nombres de la mitología, como todos los proyectos del mismo autor.

Preguntas

Banners de README: preguntas frecuentes

¿Cómo poner un banner en el README de GitHub?

Instala Jano, abre tu agente en el repositorio y ejecuta /jano. Escribe el banner en dos archivos SVG, uno para el modo oscuro y otro para el claro, y lo coloca al principio de tu README sin tocar el resto.

¿Cómo hacer un README bonito en GitHub?

Jano se encarga de la parte de arriba: un banner animado que muestra lo que hace tu proyecto. El resto del README son tus palabras, y Jano no las cambia.

¿De qué tamaño debe ser un banner para el README?

Jano dibuja cada banner a 1280×640 (2:1), que ocupa todo el ancho de un README en GitHub. El texto del banner se puede leer en un teléfono.

¿Cómo mostrar una imagen en modo oscuro y otra en modo claro?

GitHub elige la imagen con un elemento <picture> y una fuente para prefers-color-scheme: dark. Jano escribe los dos archivos y ese código por ti.

¿Por qué un SVG animado y no un GIF?

Un SVG se ve nítido a cualquier ancho, suele pesar entre 60 y 130 KB y se mueve con CSS que GitHub reproduce tal cual. Quien desactiva las animaciones ve una imagen fija. Jano solo hace SVG, ni GIF ni video.

¿Jano es un generador de README para GitHub?

No. Herramientas como readme-ai escriben el texto del README, y la mayoría de los generadores de banners para GitHub rellenan una plantilla. Jano lee tu proyecto y dibuja un banner que muestra lo que hace.

¿Qué agentes de IA pueden usarlo?

Claude Code, como plugin o como skill, además de Codex, Cursor, Gemini CLI y los demás agentes que admite la CLI de skills.

anzu / hero-dark.svg

Anzu

Tus libros de Kindle, en EPUB.