Communitygithub.com

Khatt

Cria caligrafia árabe animada (SVG auto-reproduzível ou página HTML) a partir de texto em árabe, persa ou urdu, inventando novos efeitos de animação. Use quando alguém desejar caligrafia árabe, uma palavra, nome ou saudação animada (Ramadã, Eid, casamentos, aniversários), um logotipo, adesivo ou banner em caligrafia, ou pedir para escrever algo 'em caligrafia árabe'.

O que é Khatt?

Khatt é uma ferramenta especializada em caligrafia árabe animada para agentes de IA e desenvolvedores. Ela processa texto em árabe, persa ou urdu usando o motor de formatação HarfBuzz, garantindo conexão correta das letras, escrita da direita para a esquerda e posicionamento adequado dos sinais diacríticos. O resultado é um único arquivo SVG contendo animações CSS puras — sem dependências de rede ou instalação, pois o script, as fontes e o motor de formatação estão todos incluídos no diretório da skill. O Khatt é executado a partir da linha de comando com Node.js, aceitando parâmetros como estilo (ruqaa, naskh, kufi, etc.), layout (linha, arco, círculo, espelho), efeitos de animação (tinta, ouro, neon, estrelas, lanterna, etc.) e paletas de cores. Suporta também criação de efeitos personalizados através de um sistema de plugins simples (arquivos .mjs), onde o agente pode programar animações CSS avançadas com acesso a funções utilitárias como geração de atrasos escalonados, pontos aleatórios dentro de letras e prefixação única para evitar conflitos. O resultado pode ser salvo como SVG (animado em qualquer navegador) ou HTML (reproduzível ao clicar), e também é possível gerar versões estáticas para logotipos e impressão.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Khatt: caligrafia árabe animada

O Khatt formata o texto com HarfBuzz (letras conectadas, da direita para a esquerda, marcas no lugar), organiza e anima com CSS puro dentro de um único arquivo SVG. Sem rede, sem instalação: o script, as fontes e o motor de formatação estão todos nesta pasta.

Fazer um desenho

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

Execute a partir da pasta desta skill, ou use o caminho completo para scripts/khatt.mjs. Salve a saída onde o usuário desejar (pasta do projeto, Área de Trabalho, ...).

OpçãoValores
--styleruqaa (diário, inclinado), naskh (manuscrito clássico), kufi (angular), nastaliq (persa pendurado), kano (caneta de junco grossa), blaka (geométrico ousado)
--layoutline, arc, circle (um anel com uma estrela no meio), mirror (o clássico musanna espelhado)
--effectink, gold, bleed, mosaic, sand, neon, stars, lantern, rise, stamp, reveal, wave, ou um caminho para um efeito .mjs
--palettepaper, night, neon, zellige, desert, clear (transparente)
--ink, --accent, --bgsubstitui cores, ex.: --ink "#0b3d2e" --bg none
--stillcongela no desenho final (bom para logotipos e impressão)
-o.svg para o arquivo em si, .html para uma página que repete ao clicar

Execute node scripts/khatt.mjs --list para ver tudo com descrições curtas. Use \n dentro do texto para uma segunda linha (até quatro linhas).

Escolhendo bem

  • Nomes e palavras em inglês: O Khatt desenha apenas escrita árabe. Translitere primeiro (Sara → سارة, Kamangir → كمنجير) e, quando a grafia puder ter várias opções, mostre ao usuário sua grafia antes de renderizar.
  • Ramadã ou Eid: lantern ou gold com night, estilo naskh ou ruqaa.
  • Casamentos e cartões formais: gold, rise ou ink; tente --layout mirror.
  • Logotipos: --still, estilo kufi ou blaka, --palette clear.
  • Postagens em redes sociais: um .svg animado funciona em qualquer navegador. Para um vídeo, aponte o usuário para o estúdio (https://m-alkassem.github.io/khatt/), que exporta MP4.
  • Texto curto fica melhor. Frases longas: layout line, duas ou três linhas.

Abra o resultado para o usuário quando possível (ex.: open out.html no macOS).

Fazer um novo efeito

Quando nenhum dos doze efeitos servir ("faça as letras queimarem", "uma lanterna de Ramadã que balança"), escreva um novo. Comece a partir de examples/ripple.mjs. Um efeito é um objeto simples sem imports:

export default {
  id: "my-effect", name: "My effect", nameAr: "…", blurb: "…",
  palette: "night",          // id da paleta padrão
  loop: false,               // true se continuar se movendo
  render(ctx) {
    // retorna { css, defs?, body, duration, poster? }
  },
};

render(ctx) recebe:

  • ctx.pieces: uma entrada por glifo: d (caminho SVG), order (ordem de leitura, 0 = primeira letra), box {x0,y0,x1,y1}, cx, cy. Cópias espelhadas compartilham uma ordem.
  • ctx.steps, ctx.box (caixa de texto), ctx.view (tela inteira), ctx.em (tamanho da fonte, 100), ctx.palette (bg, ink, accent), ctx.rng() (aleatório com semente).
  • ctx.stagger(order, spread?): atraso para uma letra, distribuído por spread segundos.
  • ctx.sample(piece, count): pontos aleatórios dentro de uma letra, para partículas.
  • ctx.inside(piece, x, y), ctx.area(piece).
  • ctx.anim(name, seconds, { ease, loop, alternate }): CSS de animação para uma classe.
  • ctx.at(seconds, extraStyle?): o estilo inline que define o atraso de um elemento.
  • ctx.n(number): arredonda números para saída compacta.
  • ctx.p: um prefixo único. Use-o para toda classe, id e nome de keyframe.

Regras que mantêm o desenho pausável em qualquer quadro (paradas e exportação de vídeo dependem disso):

  1. Todo elemento animado recebe class="${p}-a ..." e style="${at(seconds)}".
  2. Use ctx.anim(...) em suas regras de classe. Nunca escreva a abreviação animation: ou defina animation-delay você mesmo.
  3. Nomeie keyframes ${p}-something. Adicione ${p}-b a um elemento para escaloná-lo ou girá-lo em torno de seu próprio centro.
  4. Anime apenas propriedades CSS (opacity, transform, stroke-dashoffset, fill-opacity, …). SMIL <animate> e scripts não congelarão corretamente.
  5. Mantenha leve: no máximo alguns milhares de elementos.

Depois execute:

node scripts/khatt.mjs "نار" --effect ./my-effect.mjs -o fire.html

Se o usuário gostar, sugira que compartilhe como um pull request em https://github.com/M-Alkassem/khatt (os efeitos ficam em src/effects/).

Habilidades Relacionadas