Communitygithub.com

promptory-web-builder

Mostra a um agente como dirigir visualmente e construir o 'promptory web builder' para que o resultado concreto seja um vídeo finalizado. O procedimento passa por Promptory Web Build, 0. Regra de ouro — não redesenhe, 0.5 Questionário de coleta — PRIMEIRO passo em cada nova solicitação de site. Use quando uma nova tarefa exigir este ofício.

O que é promptory-web-builder?

Esta skill ensina um agente de IA a construir sites interativos modernos, focado em animações suaves e direção visual personalizada, com o objetivo final de produzir um vídeo editado do resultado. Ela descreve um fluxo de trabalho estruturado em torno de três ferramentas principais: Lenis (rolagem suave), GSAP (animações personalizadas) e React Bits (componentes prontos). A skill estabelece regras rigorosas, como a 'regra de ouro' de nunca redesenhar um design existente sem aprovação, e um processo inicial de questionário de coleta para cada novo site. Ela é compatível com ambientes React (Next.js, Vite) e HTML/JS puro, e inclui instruções detalhadas para conectar Lenis e GSAP em um único loop de animação, selecionar componentes adequados e manter um alto padrão de qualidade visual. O cerne da habilidade é evitar entregas genéricas (como gradientes índigo padrão ou ícones de emoji) e, em vez disso, produzir uma direção de design distinta para cada cliente, seja seguindo um design existente ou escolhendo um estilo a partir de um catálogo de referências.

Funciona com✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/moramadan91/promptory-web-builder/tree/HEAD

Perguntar na sua IA favorita

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

Documentação

Promptory Web Build

Três ferramentas, uma pilha, cada uma com um trabalho:

FerramentaFunçãoRegra prática
LenisMotor de rolagem — rolagem suave e inercial sobre a rolagem nativaInstalado uma vez, globalmente. Nunca por seção.
GSAP (+ ScrollTrigger)Motor de animação — linhas do tempo personalizadas, animação acionada por rolagem, fixaçãoQualquer coisa personalizada para o design deste site.
React BitsComponentes animados prontos (texto, fundos, cursores, cartões, botões)Recorra a ele primeiro quando um componente do catálogo já fizer o efeito.

Eles compartilham um loop de animação: o ticker do GSAP aciona o Lenis, e o ScrollTrigger lê a rolagem do Lenis. Acertar essa conexão é a coisa mais importante nesta skill (§3).

Escopo: apenas web/DOM em tempo real. Para renderização de vídeo (Remotion, reels), esta skill não se aplica.

0. Regra de ouro — não redesenhe

Implemente o design e os efeitos solicitados pelo usuário. Não altere layout, cores, fontes, espaçamento ou texto por conta própria, e não adicione seções extras ou efeitos "bônus" que ninguém pediu. Se um efeito ou correção claramente melhorar algo, sugira em uma linha e aguarde uma resposta positiva. Movimento e verificações de qualidade devem servir ao design existente, não substituí-lo.

0.5 Questionário de coleta — PRIMEIRO passo em cada nova solicitação de site

Antes de escrever qualquer código para um novo site, execute o questionário de coleta em references/intake-questionnaire.md:

  1. Leia a solicitação e pule qualquer coisa já respondida.
  2. Faça as perguntas restantes em até 3 rodadas curtas (projeto → movimento → entrega). Use a ferramenta AskUserQuestion do Claude Code quando disponível (opções clicáveis + caixa de texto livre "Outro" automática); caso contrário, imprima cada rodada como um bloco de código com opções numeradas e uma linha "✎ أخرى" vazia em cada pergunta.
  3. Mostre o Resumo do Projeto em um bloco de código e aguarde a autorização.
  4. Em seguida, construa, seguindo exatamente as respostas.

Se o usuário disser "ابدأ على طول" / "pule", use os padrões ⭐ e indique-os no Resumo. Para pequenas edições em um site existente, pule o questionário, a menos que a solicitação seja ambígua.

O resumo deve registrar: idioma e direção (Árabe/RTL, Inglês/LTR, ou ambos), o alvo de acessibilidade (padrão WCAG 2.2 AA), os formulários e seu backend, e a ferramenta de análise, se houver.

0.6 Referências visuais — Prompt Motion

https://prompt-motion.com/ é a biblioteca visual para direção de movimento (texto cinético, UI de produto, partículas, formas, gráficos…, cada um com o prompt por trás). Use-a apenas quando o usuário pedir inspiração, selecionar "precisa de uma proposta" / "movimento ousado" no questionário, ou compartilhar um link dela. Pegue a ideia de movimento, reconstrua-a com GSAP / Lenis / React Bits, mantenha o design do cliente. Fluxo de trabalho, mapa categoria→componente e o modelo de especificação de movimento: references/visual-references.md.

0.7 Nível de qualidade — verifique antes de mostrar qualquer coisa

Examine a construção em busca dos sinais de entrega genérica (acento índigo padrão, ícones de emoji, métricas inventadas, lorem ipsum, seções de modelo padrão). Corrija o que estiver em seu próprio código; sugira uma correção de uma linha para qualquer coisa no design do cliente. Lista completa: references/quality-bar.md.

0.8 Direção de design — cada site parece diferente

Quando o cliente não tem design próprio, escolha uma direção antes de escrever código. Leia references/design-styles.md e:

  1. Selecione três direções do guia de adequação para o setor e público do resumo.
  2. Pule qualquer direção usada nos últimos três sites neste chat ou projeto (Registro de Estilo).
  3. Escreva uma linha no Resumo do Projeto: Direção: <nome> — <porquê>, com uma alternativa.
  4. Construa com as escolhas de assinatura dessa direção e, em seguida, execute a verificação de Variedade: pelo menos quatro de seis eixos devem diferir do site anterior.

As direções são referências para estrutura e sensação. Nunca copie a marca, fotos, texto ou layout exato de uma referência. Se o cliente fornecer um design, siga-o e pule esta etapa (§0 regra de ouro).

0.9 Design visual distinto (quando o resumo deixa em aberto)

Fonte: anthropics/skills, skill frontend-design (Apache-2.0, veja seu LICENSE.txt). Aplica-se apenas onde o resumo deixa a direção visual em aberto. §0 vence: siga o design do cliente e as próprias palavras do resumo, inclusive quando o resumo pedir um dos looks listados abaixo.

  • Identifique o assunto primeiro: produto, público, função principal. Se o resumo não disser, proponha um e confirme. Setor e materiais são de onde vêm as escolhas distintas.
  • O herói abre com a coisa mais característica no mundo do assunto (título, imagem, demonstração ao vivo ou interação). Evite o padrão de um grande número, um pequeno rótulo e um acento gradiente, a menos que seja claramente a melhor opção.
  • Tipo: uma família, ou duas que sejam claramente distintas. Defina uma escala de tipo clara. Em títulos, o tratamento de tipo faz parte do design.
  • Comprimento da linha com menos de 80 caracteres. Texto do corpo com serifa precisa de um pouco mais de entrelinha do que sem serifa.
  • Evite sinais tipográficos: uma palavra em itálico ou colorida em um título, rótulos em CAIXA ALTA e rótulos acima de títulos que não acrescentam nada.
  • Marcadores numerados (01 / 02 / 03) apenas quando o conteúdo for realmente uma sequência.
  • Movimento: um momento orquestrado (carregamento da página ou uma revelação). Sem fade-e-slide em cada seção, sem transição de hover em cada cartão. Movimento que responde a uma ação do usuário (abrir, expandir, confirmar) é bom.
  • Planeje antes do código: 4–6 cores hexadecimais nomeadas, funções de tipo, um conceito de layout (ASCII wireframe permitido) e princípios. Revise o plano contra o resumo. Se uma parte parecer o padrão genérico para qualquer página semelhante, revise-a e diga o que mudou.
  • Looks padrão a evitar, a menos que o resumo os solicite: fundo creme com acento terracota; quase-preto com acento verde-ácido ou vermelhão; jornal com regras finas e raio zero; cartões SaaS redondos idênticos com um raio e uma sombra cinza; sobrancelha EM CAIXA ALTA acima de cada título; strings de metadados com ponto médio ('A · B · C'); rótulos 'PALAVRA — fragmento'; #0B0B0B ou #111 representando preto; monoespaçado para rótulos pequenos; '→' em cada link.
  • Gaste ousadia em um só lugar. Mantenha tudo ao redor quieto. Corte decoração que não serve ao resumo.
  • Piso de qualidade: responsivo a dispositivos móveis, foco visível, movimento reduzido respeitado, contraste acessível.
  • Cuidado com a especificidade dos seletores CSS, especialmente padding e margem entre seções, onde as regras se cancelam.
  • Texto: palavras simples para o usuário final, voz ativa, capitalização de frase. Mantenha um verbo durante um fluxo ("Publicar" leva a "Publicado"). Erros dizem o que aconteceu e como corrigir, sem desculpas. Estados vazios convidam para a próxima ação.

1. Fluxo de decisão — qual ferramenta para qual solicitação

  1. Site em árabe, bilíngue ou RTL → leia references/rtl-arabic.md antes de escrever qualquer layout. A direção é estrutural; adaptá-la depois é caro.
  2. Rolagem suave em qualquer lugar do site → Lenis (provedor global, §3). Faça isso uma vez na configuração do projeto quando existir qualquer animação de rolagem.
  3. Existe um componente React Bits que já faz o efeito? → verifique references/react-bits-catalog.md → instale-o (§4). Acertos típicos: texto dividido/borrado/embaralhado, texto de revelação de rolagem, fundos animados (aurora, partículas, grades, shaders), cursores personalizados, cartões magnéticos/inclinados, marquises, galerias, dock/menus, botões/contadores animados.
  4. O efeito é específico para este design (sequência de introdução do herói, seção de storytelling fixa, seção de rolagem horizontal, revelações sincronizadas de vários elementos) → GSAP timeline / ScrollTrigger (§5, detalhes completos em references/gsap.md).
  5. O projeto NÃO é React (HTML puro/vanilla) → React Bits não está disponível; use apenas Lenis + GSAP (assets/vanilla-setup.js).
  6. Qualquer formulário, lista, reserva ou seção orientada a dados → references/forms-and-states.md (rótulos, erros, cinco estados).
  7. Escolhendo um serviço de terceiros (fontes, backend de formulários, análise, hospedagem, imagens) → references/free-services.md, depois verifique os limites atuais.
  8. Novo site sem design do cliente → escolha uma direção primeiro (§0.8, references/design-styles.md).

2. Instalação

npm install gsap @gsap/react lenis
  • @gsap/react → apenas para projetos React (fornece useGSAP).
  • lenis/react e lenis/snap vêm dentro de lenis — sem pacotes extras.
  • Todos os plugins GSAP (ScrollTrigger, SplitText, Flip, ScrollSmoother, Draggable…) vêm dentro de gsap.
  • Os componentes React Bits são adicionados individualmente via CLI (§4); alguns puxam suas próprias dependências (motion, three, ogl, matter-js…) — a CLI os instala, mas verifique a coluna Deps no catálogo antes de escolher, para evitar inflar o bundle.

Nunca use o ScrollSmoother do GSAP junto com o Lenis — eles são dois motores de rolagem suave concorrentes. Lenis é o motor de rolagem nesta pilha.

3. Conectando Lenis + GSAP + ScrollTrigger (faça exatamente isso)

React / Next.js

Copie assets/SmoothScroll.jsx para o projeto (ex.: components/SmoothScroll.jsx) e envolva o app uma vez:

// app/layout.jsx (Next.js App Router)
import SmoothScroll from '@/components/SmoothScroll';
import ScrollToTopOnRoute from '@/components/ScrollToTopOnRoute';

export default function RootLayout({ children }) {
  return (
    <html lang="en">
      <body>
        <SmoothScroll>
          <ScrollToTopOnRoute />
          {children}
        </SmoothScroll>
      </body>
    </html>
  );
}

Para árabe, defina lang e dir a partir da localidade em <html> (veja references/rtl-arabic.md §1).

Para Vite/React, envolva <App /> em main.jsx da mesma forma e pule ScrollToTopOnRoute (ele usa next/navigation).

O que o provedor faz — e por que cada linha importa:

  • <ReactLenis root options={{ autoRaf: false }}> → uma instância global em <html>; autoRaf: false porque o GSAP irá acioná-lo.
  • lenis.on('scroll', ScrollTrigger.update) → ScrollTrigger recalcula em cada quadro de rolagem suave. Faltando isso = animações disparam tarde/em posições erradas.
  • gsap.ticker.add(t => lenis.raf(t * 1000)) → um loop compartilhado (tempo do GSAP é em segundos, Lenis quer ms).
  • gsap.ticker.lagSmoothing(0) → sem gagueira ao recuperar após uma troca de aba.
  • ScrollTrigger.refresh() após fontes e carregamento → posições do trigger correspondem ao layout final.

HTML/JS Vanilla

Use assets/vanilla-setup.js como módulo de entrada, importe lenis dele onde necessário.

4. React Bits — selecionando e instalando componentes

  1. Encontre o componente em references/react-bits-catalog.md (agrupados: Animações de Texto, Animações, Componentes, Micro, Fundos — nome, o que faz, deps).
  2. Escolha o sabor que corresponde ao projeto: JS ou TS, depois CSS ou TW (Tailwind).
  3. Instale:
    npx shadcn@latest add @react-bits/SplitText-TS-TW
    
    Para o atalho @react-bits/, o components.json do projeto deve conter:
    { "registries": { "@react-bits": "https://reactbits.dev/r/{name}.json" } }
    
    Sem components.json / não é um projeto shadcn? Use a URL direta:
    npx shadcn@latest add https://reactbits.dev/r/SplitText-TS-TW.json
    # ou
    npx jsrepo@latest add https://reactbits.dev/r/SplitText-TS-TW
    
  4. Abra o arquivo instalado e leia suas propriedades antes de usá-lo — todo componente é configurável (cores, velocidade, atraso, easing, triggers). Defina as propriedades para corresponder aos tokens de design existentes do site (cores, fontes) em vez de deixar os padrões de demonstração.
  5. Se o usuário quiser o fluxo de trabalho do agente: npx shadcn@latest mcp init --client claude conecta o Claude Code ao registro via MCP.

Notas de integração:

  • Os componentes React Bits que animam na rolagem (ScrollReveal, ScrollFloat, AnimatedContent, SplitText…) usam GSAP ScrollTrigger ou IntersectionObserver internamente → funcionam com Lenis automaticamente desde que §3 esteja em vigor.
  • Os componentes são componentes do cliente ('use client'). No Next.js, renderize-os dentro de componentes do cliente ou páginas que o permitam.
  • Fundos WebGL/shader (deps three, ogl, vgpu) são pesados: no máximo um ou dois por página, carregue sob demanda os que estão abaixo da dobra (next/dynamic com ssr: false ou React.lazy), e dê a eles um contêiner de tamanho fixo. Pause-os quando estiverem fora da tela ou quando a aba estiver oculta.
  • Não empilhe dois efeitos de cursor ou dois fundos na mesma janela de visualização.
  • Verifique cada componente para um controle de pausa se ele fizer loop por mais de 5 segundos (veja references/accessibility-motion.md §5).
  • Licença: React Bits é MIT + Commons Clause — livre para uso dentro de qualquer site de cliente (incluindo trabalho de cliente pago), mas os próprios componentes não devem ser revendidos ou redistribuídos como um pacote/modelo. Nunca cole a fonte do React Bits nesta skill ou em uma biblioteca compartilhada; sempre instale do registro.

5. Essenciais do GSAP (animação personalizada)

Sempre em React via useGSAP com um scope — nunca useEffect bruto:

'use client';
import { useRef } from 'react';
import gsap from 'gsap';
import { ScrollTrigger } from 'gsap/ScrollTrigger';
import { useGSAP } from '@gsap/react';
gsap.registerPlugin(ScrollTrigger, useGSAP);

export default function Story() {
  const root = useRef(null);
  useGSAP(() => {
    const tl = gsap.timeline({
      scrollTrigger: { trigger: root.current, start: 'top top', end: '+=150%', scrub: 1, pin: true },
    });
    tl.from('.line', { yPercent: 100, autoAlpha: 0, stagger: 0.15 })
      .to('.image', { scale: 1.15 }, '<');
  }, { scope: root });
  return <section ref={root}>…</section>;
}

Padrões principais (detalhes + matchMedia responsivo, batching, FOUC, checklist em references/gsap.md):

  • Linhas do tempo para qualquer coisa com >1 elemento; ScrollTrigger.batch() para cartões repetidos.
  • scrub para movimento vinculado à rolagem (com Lenis, scrub: true já é suave; scrub: 1 adiciona atraso extra).
  • pin: true funciona com Lenis na rolagem nativa — sem necessidade de hacks pinType quando Lenis usa root.
  • Seção de rolagem horizontal: fixe o wrapper, anime o x da faixa para -(track.scrollWidth - innerWidth), scrub: true, invalidateOnRefresh: true. Em RTL, inverta a direção (veja references/rtl-arabic.md §6).
  • Envolva blocos decorativos em gsap.matchMedia() para que usuários com movimento reduzido obtenham o substituto (references/accessibility-motion.md §3).

6. Formulários e estados

  • Rótulos: flutuantes ou empilhados (veja references/forms-and-states.md).
  • Cinco estados: vazio, preenchendo, erro (com mensagem), sucesso (confirmação), e desabilitado (processamento).
  • Backend: escolha um serviço gratuito de references/free-services.md, ou configure um endpoint de API.

7. Fontes

  • Escolha de references/free-services.md (Google Fonts, Fontsource, ou self-hosted).
  • Defina uma escala de tipo clara no CSS.
  • No Next.js, otimize com next/font.
  • Evite um tratamento de tipo que pareça genérico (veja §0.9).

8. Marcação de acessibilidade

  • Meta descrição, landmarks (<nav>, <main>, <footer>), heading hierarchy.
  • Alvo: WCAG 2.2 AA por padrão.
  • Verificações de contraste em todo o design.
  • prefers-reduced-motion respeitado (veja references/accessibility-motion.md).
  • Estados de foco visíveis.
  • Suporte a navegação por teclado.

9. Análise

  • Configure a ferramenta de análise escolhida (padrão: nenhuma, a menos que especificado no questionário).
  • Use o data- attrs para rastrear interações ou integre com React context.

10. Entrega

  • Otimize imagens (WebP, AVIF, lazy loading).
  • Verifique abertura em dispositivos móveis, tablets e desktop.
  • Verifique desempenho com Lighthouse (alvo: >90 em todas as categorias).
  • Forneça o build final em um formato que o usuário possa implantar (código-fonte exportado, URL de preview, etc.).

11. Referências

  • references/intake-questionnaire.md — perguntas de coleta
  • references/visual-references.md — catálogo de inspiração visual Prompt Motion
  • references/quality-bar.md — verificações de qualidade
  • references/design-styles.md — direções de design
  • references/react-bits-catalog.md — catálogo de componentes
  • references/gsap.md — padrões GSAP e checklist
  • references/rtl-arabic.md — guia de layout RTL
  • references/forms-and-states.md — guia de formulários
  • references/free-services.md — serviços gratuitos
  • references/accessibility-motion.md — guia de acessibilidade e movimento
  • assets/SmoothScroll.jsx — componente React Lenis + GSAP
  • assets/vanilla-setup.js — configuração vanilla Lenis + GSAP

Habilidades Relacionadas