Communitygithub.com

khatt

Crea caligrafía árabe animada (SVG auto-reproducible o página HTML) a partir de texto en árabe, persa o urdu, e inventa nuevos efectos de animación. Úsalo cuando alguien quiera caligrafía árabe, una palabra, nombre o saludo animado (Ramadán, Eid, bodas, cumpleaños), un logotipo caligráfico, una pegatina o pancarta, o pida escribir algo «en caligrafía árabe».

¿Qué es khatt?

Khatt es una habilidad especializada en AI agents que genera caligrafía árabe animada a partir de texto en árabe, persa o urdu. Utiliza HarfBuzz para unir correctamente las letras con dirección derecha a izquierda y colocar las marcas, y luego aplica diseño y animación con CSS puro dentro de un único archivo SVG. Todo funciona sin conexión a internet ni instalación adicional: el script, las fuentes y el motor de composición están incluidos en la carpeta. Soporta múltiples estilos (ruqaa, naskh, kufi, nastaliq, kano, blaka), diseños (línea, arco, círculo, espejo) y una docena de efectos predefinidos como tinta, oro, mosaico, neón, estrellas, linterna, etc. Además, los usuarios pueden crear sus propios efectos personalizados, ideales para logos, felicitaciones, publicaciones en redes sociales y proyectos con requisitos visuales específicos.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/M-Alkassem/khatt/tree/HEAD/skills/khatt

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Khatt: caligrafía árabe animada

Khatt da forma al texto con HarfBuzz (letras unidas, de derecha a izquierda, marcas en su lugar), lo diseña y lo anima con CSS puro dentro de un único archivo SVG. Sin red, sin instalación: el script, sus fuentes y el motor de composición están todos en esta carpeta.

Crear un dibujo

node scripts/khatt.mjs "النص" --style ruqaa --layout line --effect ink -o out.svg

Ejecútalo desde la carpeta de esta habilidad, o usa la ruta completa a scripts/khatt.mjs. Escribe la salida donde el usuario quiera (su carpeta de proyecto, Escritorio, …).

OpciónValores
--styleruqaa (cotidiano, inclinado), naskh (manuscrito clásico), kufi (angular), nastaliq (persa colgante), kano (pluma de caña gruesa), blaka (geométrico audaz)
--layoutline, arc, circle (un anillo con una estrella en el medio), mirror (el clásico musanna espejado)
--effectink, gold, bleed, mosaic, sand, neon, stars, lantern, rise, stamp, reveal, wave, o una ruta a un efecto .mjs
--palettepaper, night, neon, zellige, desert, clear (transparente)
--ink, --accent, --bgsustituir colores, p.ej. --ink "#0b3d2e" --bg none
--stillcongelar en el dibujo terminado (bueno para logos e impresión)
-o.svg para el archivo en sí, .html para una página que se reproduce al hacer clic

Ejecuta node scripts/khatt.mjs --list para ver todo con descripciones breves. Usa \n dentro del texto para una segunda línea (hasta cuatro líneas).

Elegir bien

  • Nombres y palabras en inglés: Khatt solo dibuja escritura árabe. Transcribe primero (Sara → سارة, Kamangir → كمنجير) y, cuando la ortografía pueda ser ambigua, muestra al usuario tu transcripción antes de renderizar.
  • Ramadán o Eid: lantern o gold con night, estilo naskh o ruqaa.
  • Bodas y tarjetas formales: gold, rise o ink; prueba --layout mirror.
  • Logos: --still, estilo kufi o blaka, --palette clear.
  • Publicaciones en redes: un .svg animado se reproduce en cualquier navegador. Para un video, dirige al usuario al estudio (https://m-alkassem.github.io/khatt/), que exporta MP4.
  • El texto corto se ve mejor. Frases largas: diseño line, dos o tres líneas.

Abre el resultado para el usuario cuando puedas (p. ej. open out.html en macOS).

Crear un nuevo efecto

Cuando ninguno de los doce efectos se ajuste («haz que las letras ardan», «una linterna de Ramadán que se balancee»), escribe uno nuevo. Comienza desde examples/ripple.mjs. Un efecto es un objeto simple sin importaciones:

export default {
  id: "mi-efecto", name: "Mi efecto", nameAr: "…", blurb: "…",
  palette: "night",          // id de paleta por defecto
  loop: false,               // true si sigue moviéndose
  render(ctx) {
    // return { css, defs?, body, duration, poster? }
  },
};

render(ctx) recibe:

  • ctx.pieces: una entrada por glifo: d (trayecto SVG), order (orden de lectura, 0 = primera letra), box {x0,y0,x1,y1}, cx, cy. Las copias espejadas comparten un orden.
  • ctx.steps, ctx.box (caja de texto), ctx.view (lienzo completo), ctx.em (tamaño de fuente, 100), ctx.palette (bg, ink, accent), ctx.rng() (aleatorio con semilla).
  • ctx.stagger(order, spread?): retardo para una letra, distribuido en spread segundos.
  • ctx.sample(piece, count): puntos aleatorios dentro de una letra, para partículas.
  • ctx.inside(piece, x, y), ctx.area(piece).
  • ctx.anim(name, seconds, { ease, loop, alternate }): CSS de animación para una clase.
  • ctx.at(seconds, extraStyle?): el estilo en línea que establece el retardo de un elemento.
  • ctx.n(number): redondea números para una salida compacta.
  • ctx.p: un prefijo único. Úsalo para cada clase, id y nombre de keyframe.

Reglas que mantienen el dibujo pausable en cualquier fotograma (las exportaciones estáticas y de video dependen de ello):

  1. Cada elemento animado recibe class="${p}-a ..." y style="${at(seconds)}".
  2. Usa ctx.anim(...) en tus reglas de clase. Nunca escribas la abreviatura animation: ni establezcas animation-delay tú mismo.
  3. Nombra los keyframes ${p}-algo. Añade ${p}-b a un elemento para escalarlo o rotarlo alrededor de su propio centro.
  4. Anima solo propiedades CSS (opacity, transform, stroke-dashoffset, fill-opacity, …). Las etiquetas SMIL <animate> y los scripts no se congelarán correctamente.
  5. Mantenlo ligero: como máximo unos pocos miles de elementos.

Luego ejecútalo:

node scripts/khatt.mjs "نار" --effect ./mi-efecto.mjs -o fuego.html

Si al usuario le gusta, sugiérele que lo comparta como una pull request en https://github.com/M-Alkassem/khatt (los efectos viven en src/effects/).

Skills relacionados