Communitygithub.com

Página de Lista de Espera

Página de pré-lançamento minimalista com captura de e-mail, logotipo da marca e camada decorativa opcional. Lê DESIGN.md para cores, tipografia e regras de layout. Ideal para lançamentos de produtos, inscrições beta, acesso antecipado e projetos independentes.

O que é Página de Lista de Espera?

Esta skill cria uma página de pré-lançamento focada, honesta e responsiva, que serve como o primeiro contato com futuros usuários. Ela utiliza um fluxo de trabalho baseado em template rígido e validado: primeiro, a skill carrega a identidade da marca a partir do arquivo `DESIGN.md` e copia o template `assets/template.html` como base. Em seguida, realiza a substituição de tokens (como `{{PRODUCT_NAME}}` e `{{BG_EXPRESSION}}`) com validação rigorosa, incluindo escape de HTML, sanitização de SVG e gramática restrita de cores para evitar injeção de CSS. A saída é um único arquivo HTML com todas as regras de layout mobile-first (375px, 768px, 1440px+), acessibilidade (WCAG AA) e um checklist de qualidade que deve ser aprovado antes da emissão. Esta skill é ideal para desenvolvedores que precisam de uma landing page de espera segura, consistente com a marca e que segue boas práticas de engenharia.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/kelgirechandrakant-cpu/statsarthi/tree/HEAD/.agents/skills/waitlist-page

Perguntar na sua IA favorita

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

Documentação

Habilidade de Página de Lista de Espera

As páginas de pré-lançamento são o primeiro aperto de mão com futuros usuários. Esta skill constrói uma entrada focada e honesta: sua identidade de marca, o que você está construindo e um caminho claro para entrar na lista inicial. Sem escassez artificial, contagem regressiva falsa ou táticas de inflação — apenas um recipiente limpo e mobile-first para o interesse genuíno.

Fluxo de Trabalho

Pré-voo: Carregar template endurecido e base da marca

  1. Carregar a identidade da marca — Leia DESIGN.md para obter o sistema de cores, pares de fontes e regras espaciais. Esta é sua base. Uma página de lista de espera vive ou morre pela consistência com a marca que representa. Se DESIGN.md estiver faltando, peça ao usuário para fornecer um antes de prosseguir.
  2. Ler e copiar o template reutilizável — Leia assets/template.html. Este template é a semente endurecida para todas as saídas. Copie-o para index.html como sua base. Não escreva HTML do zero nem desvie desta estrutura. O template possui todo o layout necessário, estrutura de formulário, decorações, estilos de foco e scaffolding de acessibilidade incorporados.

Etapas: Substituição de tokens com validação e escape

  1. Mapear tokens a partir das entradas — Para cada placeholder no template (ex.: {{PRODUCT_NAME}}, {{BG_EXPRESSION}}, {{BORDER_EXPRESSION}}, {{LOGO_MARK}}), siga as regras de substituição abaixo:
    • Tokens de texto ({{PRODUCT_NAME}}, {{TAGLINE}}): Faça escape HTML de <, >, &, ", ' antes da inserção em nós de texto HTML ou valores de atributo.
    • Tokens HTML ({{LOGO_MARK}}): Se estiver usando iniciais de texto, faça escape HTML por padrão. Se estiver usando SVG inline, você deve sanitizá-lo estritamente usando uma lista de permissões: remova tags <script>, manipuladores de eventos (on*), <foreignObject>, referências externas (href, xlink:href, url()), e quaisquer atributos/elementos não permitidos antes da inserção. Se o SVG não puder ser sanitizado com segurança, recue para iniciais de texto escapadas. Nunca emita HTML arbitrário não sanitizado. Garanta que qualquer SVG seja dimensionado corretamente dentro de seu contêiner.
    • Tokens de expressão de cor ({{BG_EXPRESSION}}, {{FG_EXPRESSION}}, {{ACCENT_EXPRESSION}}, {{DECO_EXPRESSION}}, {{STRIPE_EXPRESSION}}, {{SUCCESS_EXPRESSION}}, {{BORDER_EXPRESSION}}, {{BTN_LABEL_EXPRESSION}}, {{TICKER_BG_EXPRESSION}}, {{TICKER_FG_EXPRESSION}}, {{DECO_STROKE_EXPRESSION}}, {{LOGO_SHADOW_EXPRESSION}}, {{LOGO_FG_EXPRESSION}}): Devem aderir estritamente a uma gramática de cores explícita (#hex, rgb/rgba, hsl/hsla, oklch, ou color-mix() usando apenas variáveis locais). Rejeite completamente qualquer entrada contendo ;, {}, <, >, comentários (/*), @, url(, ou referências externas para evitar injeção de CSS. Não envolva em # nem adicione aspas extras. Exemplos: rgba(196, 169, 154, 0.38), color-mix(in srgb, var(--fg) 38%, transparent), #FDE8DF. Insira como está nas variáveis CSS :root. Derive --success do DESIGN.md se presente; caso contrário, use o fallback permitido #2D6A4F apenas.
    • Tokens de nome de fonte ({{DISPLAY_FONT_CSS}}, {{BODY_FONT_CSS}}): Estes são valores CSS font-family, já entre aspas se contiverem espaços (ex.: 'DM Sans', Syne). Insira como está nas declarações --font-display e --font-body; NÃO adicione aspas extras.
    • Tokens de URL de fonte ({{DISPLAY_FONT_URL}}, {{BODY_FONT_URL}}): Espaços devem ser codificados como + para a URL do Google Fonts (ex.: DM+Sans, IBM+Plex+Serif). Valide se a URL está bem formada antes da inserção.
  2. Verificar regras de mapeamento de tokens — Todos os tokens de cor estão agora em variáveis CSS:
    • --bg = {{BG_EXPRESSION}} (ex.: #FDE8DF)
    • --fg = {{FG_EXPRESSION}} (ex.: #1A1410)
    • --accent = {{ACCENT_EXPRESSION}} (distintivo da marca)
    • --deco = {{DECO_EXPRESSION}} (decoração primária)
    • --deco-stripe = {{STRIPE_EXPRESSION}} (faixa de destaque)
    • --input-border = {{BORDER_EXPRESSION}} (expressão CSS completa com opacidade)
    • --success = {{SUCCESS_EXPRESSION}} ou fallback #2D6A4F
    • --btn-label = {{BTN_LABEL_EXPRESSION}} (cor do texto do botão para contraste)
    • --ticker-bg = {{TICKER_BG_EXPRESSION}} (fundo do ticker animado)
    • --ticker-fg = {{TICKER_FG_EXPRESSION}} (texto do ticker animado)
    • --deco-stroke = {{DECO_STROKE_EXPRESSION}} (traços SVG, tipicamente suaves com 12–15% de opacidade)
    • --logo-shadow = {{LOGO_SHADOW_EXPRESSION}} (sombra do contêiner do logotipo, tom sutil do primeiro plano)
    • --logo-fg = {{LOGO_FG_EXPRESSION}} (cor de texto contrastante para iniciais do logotipo)
  3. Layout responsivo — O template inclui dimensionamento mobile-first:
    • 375px: formulário empilha em coluna única, logotipo encolhe para 40px, decoração comprime, sem rolagem horizontal.
    • 768px: espaço de respiro confortável em duas colunas.
    • 1440px+: layout centralizado com amplo espaço em branco.
    • Verifique se todo o texto permanece legível e se a entrada de e-mail + botão estão totalmente visíveis (sem corte) em 375×667 e 390×844.

Validação: Executar portões de qualidade endurecidos antes da emissão

  1. Executar a lista de verificação de qualidade — Leia references/checklist.md. Valide cada portão P0 antes de emitir:
    • Exatamente um CTA (formulário de e-mail)
    • Sem temporizador de contagem regressiva, sem prova social falsa, sem emoji
    • Sem rolagem horizontal em 375px
    • Entrada de e-mail tem type="email" e required; primeiro nome não tem required
    • Formulário NÃO usa novalidate; JS usa guarda checkValidity()
    • Mensagem de sucesso tem role="status" ou aria-live="polite"
    • Todas as cores do DESIGN.md ou fallback permitido; nenhum valor hex inventado
    • Todo texto do usuário é escapado para HTML; tokens de cor aderem à gramática estrita; fontes são codificadas na URL
    • Passe P0 ou não emita. Se algum portão P0 falhar, peça ao usuário ou corrija os mapeamentos de tokens e tente novamente.
  2. Verificar portões P1 para submissão de qualidade (recomendado):
    • Estados de hover e active no botão de envio
    • Validação de formulário com feedback claro
    • Animação do ticker respeita prefers-reduced-motion: reduce
    • Todos os elementos interativos têm estilos de foco visíveis (input:focus inclui outline)
    • Suporte a teclado Tab/Enter
    • Contraste WCAG AA para texto do corpo (≥4.5:1) e rótulo do botão (≥4.5:1)
    • Logo alt/aria-label presente; ticker tem aria-hidden="true"
    • <html lang=""> está definido

Saída

  1. Emitir HTML limpo — Arquivo único, CSS inline, SVG para gráficos. Marque elementos interativos com data-od-id (título, formulário, logotipo, ticker, grade, etc.) para que agentes possam personalizar sem fazer parsing.

Portões de Qualidade

Esta skill impõe um fluxo de trabalho baseado em template endurecido para garantir conformidade. Você deve seguir este caminho de execução; desviar do template desqualifica a saída.

Execução obrigatória baseada em template:

  • Leia assets/template.html como sua base; não escreva HTML do zero.
  • Copie-o para index.html e substitua apenas os tokens {{PLACEHOLDER}} por valores validados/escapados.
  • Execute cada portão P0 em references/checklist.md antes de emitir; se algum falhar, corrija e revalide.

Portões P0 (devem passar):

  • Único CTA: Formulário de e-mail é o único elemento interativo. Sem navegação, sem botões secundários, sem links sociais.
  • Posicionamento do logotipo: Fixo no canto superior esquerdo, combina com a cor de destaque do DESIGN.md, dimensiona para baixo em mobile (50px → 40px).
  • Consistência de cores: Toda cor da paleta do DESIGN.md. Única exceção codificada permitida: #2D6A4F para --success.
  • Sem antipadrões: Sem temporizador de contagem regressiva, sem prova social falsa, sem ícones emoji, sem lorem ipsum.
  • Integridade do conteúdo: Título e cópia vinculam diretamente às entradas product_name e tagline — sem cópia de preenchimento.
  • Ajuste móvel: Sem rolagem horizontal em 375px. Entrada de e-mail e botão de envio estão totalmente visíveis (sem corte) em 375×667 e 390×844. O overflow vertical é rolável, não oculto.
  • Disciplina tipográfica: Apenas fontes Display + Body (regra de 2 fontes). Tamanho consistente entre seções.
  • Estrutura do formulário: Dois campos (primeiro nome opcional, e-mail obrigatório), guarda checkValidity(), mensagem de sucesso com role="status".
  • Escape de tokens: Todo texto fornecido pelo usuário é escapado para HTML; tokens de cor aderem à gramática estrita e não contêm caracteres inseguros (;, {}, <, >, /*, @, url(); nomes de fontes são codificados na URL; {{LOGO_MARK}} são iniciais de texto escapadas ou SVG inline estritamente sanitizado (sem scripts, sem manipuladores de eventos, sem foreignObject, sem hrefs externos).

Portões P1 (devem passar para submissão de qualidade):

  • Seção Hero visualmente distinta e acima da dobra.
  • Botão de envio de e-mail tem estados hover e active.
  • Validação do formulário fornece feedback claro.
  • Página rolável (sem corte) em todos os viewports móveis; CTA visível sem rolagem.
  • Animação do ticker pausada/removida sob prefers-reduced-motion: reduce.
  • Todos os elementos interativos têm estilos de foco visíveis (outline, não apenas outline:none).
  • Teclado: Tab atinge cada campo do formulário; Enter envia.
  • Contraste WCAG AA: Texto do corpo ≥4.5:1, rótulo do botão ≥4.5:1.
  • Logo alt/aria-label presente; ticker tem aria-hidden="true".
  • <html lang=""> definido com o código de idioma correto.

Restrição de decoração:

  • Zona inferior aprimora sem distração. Opacidade, traços sutis, animação suave.
  • Sem gradiente que cubra mais de 20% da altura do viewport.
  • Bobina, faixa, grade ou ticker usam apenas cores do DESIGN.md.

Saída

Emita apenas depois que todos os portões P0 em references/checklist.md passarem.

Emita o artefato entre as tags:

<artifact identifier="waitlist-id" type="text/html" title="Em Breve — {{PRODUCT_NAME}}">
<!doctype html>
<html lang="pt">
...
</html>
</artifact>

Uma linha de descrição acima do artefato; nada abaixo.

Pós-emissão: Se o usuário solicitar alterações, atualize o index.html no local e reexecute a lista de verificação dos portões P0 antes de emitir a próxima versão. Não pule a validação em iterações.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Habilidades Relacionadas