Communitygithub.com

launch-qa

Execute uma verificação de qualidade pré-lançamento em um site, abrangendo desempenho, acessibilidade, fundamentos de SEO, formulários, comportamento entre dispositivos e conteúdo, e relate os resultados classificados por gravidade com correções. Use isso sempre que alguém disser que um site está "pronto para lançar", "indo ao ar", pedir "pode verificar meu site", quiser uma validação de QA, uma auditoria de site, uma revisão estilo Lighthouse, ou quiser saber por que uma página está lenta ou com pontuação baixa.

O que é launch-qa?

O skill 'launch-qa' é uma ferramenta de auditoria de qualidade pré-lançamento para sites, projetada para identificar problemas críticos que podem envergonhar o proprietário ou prejudicar conversões. Ele organiza os achados em três níveis de gravidade: Bloqueadores (problemas que quebram funcionalidade ou acessibilidade), Deve Corrigir (danos mensuráveis a desempenho, acessibilidade ou SEO) e Acabamento (inconsistências menores). O skill suporta plataformas como Claude Code, Cursor e Codex, e pode ser executado manualmente ou integrado a pipelines CI via CLI webcraft ou ferramenta MCP audit_site. Ele cobre seis áreas principais: funcionalidade e conteúdo, desempenho (com métricas alvo como LCP < 2,5s), acessibilidade, fundamentos de SEO, comportamento entre dispositivos e segurança/operações. O resultado é um relatório conciso com veredito claro e recomendações práticas, evitando listas longas de problemas igualmente ponderados.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/imperfec-t/webcraft/tree/HEAD/skills/launch-qa

Perguntar na sua IA favorita

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

Documentação

QA de Lançamento

Encontre o que envergonhará o proprietário ou custará consultas, classifique e diga como corrigir. Uma lista de quarenta picuinhas de peso igual não é útil; três bloqueadores e uma cauda curta sim.

Como executar

  1. Estabeleça o que você pode inspecionar: URL ao vivo, arquivos fonte ou ambos. Diga quais verificações você não pôde realizar (por exemplo, teste em dispositivo real ou entrega de formulário) em vez de marcá-las como aprovadas.

  2. Se a CLI webcraft estiver disponível, execute-a primeiro para as verificações mensuráveis (ou chame a ferramenta MCP audit_site):

    webcraft audit https://example.com --pages 10     # site ao vivo: também robots, sitemap, redirecionamentos, 404, links
    webcraft audit ./dist                             # pasta de build local
    webcraft audit ./dist --json --fail-on blocker    # CI: sair com 1 em caso de bloqueadores
    

    Ela produz o modelo de relatório abaixo com uma lista "Não verificado". Verifique descobertas surpreendentes antes de repeti-las e então gaste seu próprio esforço no que ela não pode ver: renderização, uso do teclado, dispositivos reais, precisão do conteúdo.

  3. Trabalhe nas áreas abaixo. Prefira medição a opinião: execute a página, leia a marcação, conte os bytes.

  4. Classifique cada descoberta:

    • Bloqueador: funcionalidade quebrada, conteúdo principal inacessível, formulário que não entrega, conteúdo errado ou placeholder, site não indexável quando deveria ser.
    • Deve corrigir: dano mensurável à velocidade, acessibilidade ou aparência nos mecanismos de busca.
    • Acabamento: inconsistências menores.
  5. Relate com o modelo no final.

Funcionalidade e conteúdo

  • Cada link e botão vai para algum lugar real. Nada de #, lorem ipsum, restos de template, endereços de e-mail de teste.
  • Formulários: validação obrigatória, mensagens de erro claras, estado de sucesso, proteção contra spam e um envio de teste real que chega na caixa de entrada correta.
  • Números de telefone usam tel:, e-mails usam mailto:, e são os corretos (verifique números incompatíveis entre cabeçalho e rodapé).
  • Página 404 existe e tem link para a página inicial.
  • Páginas legais presentes quando necessário: política de privacidade, termos, aviso de cookies se houver rastreamento.
  • Ano de direitos autorais e detalhes do negócio estão atualizados e consistentes.

Desempenho

Metas em um telefone de gama média com 4G: LCP abaixo de 2,5s, INP abaixo de 200ms, CLS abaixo de 0,1.

  • Imagens: formato moderno (WebP ou AVIF), dimensionadas para seu tamanho de exibição, width e height definidos, loading="lazy" abaixo da dobra e a imagem LCP pré-carregada e não lazy.
  • Vídeo: imagem de pôster, sem reprodução automática com som, comprimido, não carregado em telas pequenas se decorativo.
  • Fontes: no máximo duas famílias, font-display: swap, pré-carregue os arquivos acima da dobra.
  • CSS e JS: minificados, adiados quando possível, sem bibliotecas não utilizadas (uma biblioteca de slider carregada para uma imagem estática é comum).
  • Scripts de terceiros: cada um justificado. Widgets de chat e rastreadores são infratores frequentes de LCP e INP.
  • Caching e compressão habilitados no servidor.

Acessibilidade

  • Um h1; níveis de cabeçalho não pulam.
  • Todas as imagens significativas têm texto alt; as decorativas têm alt="" vazio.
  • Contraste de texto pelo menos 4,5:1 (3:1 para texto grande). Verifique texto sobre imagens e texto cinza suave primeiro.
  • Tudo funciona pelo teclado: anel de foco visível, ordem lógica, menus e acordeões operáveis, sem armadilha de foco.
  • Campos de formulário têm elementos <label> associados; erros são anunciados, não mostrados apenas por cor.
  • prefers-reduced-motion respeitado; nada pisca; movimento de reprodução automática pode ser pausado.
  • Atributo lang em <html>; página funciona com zoom de 200%.

Fundamentos de SEO

  • <title> único (50 a 60 caracteres) e meta descrição (cerca de 150) por página.
  • URL canônica definida; uma versão do domínio (https, com ou sem www) redirecionando as outras.
  • robots.txt não bloqueando o site, nenhum noindex perdido do staging, sitemap XML presente.
  • Open Graph título, descrição e imagem (1200 por 630, servidos via https) para que links compartilhados fiquem corretos.
  • Dados estruturados onde couber (Organization ou LocalBusiness, FAQ, Article) e válidos.
  • Texto de link descritivo em vez de "clique aqui"; URLs limpas.

Entre dispositivos

  • Larguras 320, 390, 768, 1024, 1440: sem rolagem horizontal, sem texto sobreposto, alvos de toque de pelo menos 44px.
  • Chrome, Safari, Firefox e Edge atuais; iOS Safari especificamente para unidades vh, posicionamento fixo e reprodução automática de vídeo.
  • Animações não escondem conteúdo se JavaScript falhar.

Segurança e operações

  • HTTPS em todos os lugares, sem conteúdo misto.
  • CMS, tema e plugins atualizados; plugins e temas não utilizados removidos; nenhum nome de usuário admin padrão.
  • Backups agendados e um restore testado.
  • Analytics e Search Console conectados, com tratamento de consentimento onde exigido.
  • Favicon e touch icon presentes.

Modelo de relatório

# QA de Lançamento: [site]   Verificado em: [data]   Escopo: [o que foi e não foi inspecionado]

Veredito: Pronto / Pronto após bloqueadores / Não pronto

## Bloqueadores
1. [O que está errado] — [onde] — [correção]

## Deve corrigir
...

## Acabamento
...

## Não verificado
- [Verificação] — [por que, e como o proprietário pode verificá-la]

Mantenha cada descoberta em uma linha de problema, uma de localização, uma de correção. Lidere com o veredito para que o proprietário saiba imediatamente onde está.

Individual skills in this repo

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

design-tokens

Create a website's visual system as CSS custom properties, covering color palette, typography scale, spacing, radius and shadows, with contrast checked. Use this whenever someone asks for a color scheme, a palette from one brand color, font pairing, a type scale, "make it look consistent", dark mode, a rebrand of an existing site into new colors, or starts a build with no defined styles.

hero-section

Design and build the hero (first screen) of a website, including headline layout, media treatment, CTA, proof badge, marquee and entrance animation. Use this whenever someone asks for a hero section, a landing page header, "the top of my homepage", a cinematic or animated intro, a video background, a text marquee, or says their first screen looks plain or generic.

homepage-blueprint

Plan the section structure and content slots of a homepage for an agency, freelancer, studio or service business before any design or code. Use this whenever someone asks "what sections should my homepage have", "plan my website", "structure a landing page for my business", wants a wireframe or sitemap for a service site, or starts building a homepage without a clear outline.

responsive-layout

Build page layouts that work from phones to wide desktops using CSS grid, flexbox, container queries and fluid sizing, including card grids, bento grids, split sections, sticky sidebars and navigation that collapses. Use this whenever someone says their site "breaks on mobile", asks for a responsive grid, a bento layout, a mobile menu, fixing horizontal scroll or overflow, or is laying out any multi-column section.

scroll-motion

Add scroll-driven and entrance animation to a website with GSAP, ScrollTrigger and Lenis, including reveals, parallax, pinned sections, horizontal scroll, line drawing, counters and preloaders. Use this whenever someone wants a site to "feel premium", asks for smooth scrolling, scroll animations, parallax, text reveals, a pinned or sticky scroll section, an animated preloader, or names GSAP, ScrollTrigger, Lenis, Locomotive or AOS.

site-teardown

Analyze a live website and turn it into a section-by-section build brief that another person or AI can rebuild from, with brand name, colors, fonts and images swapped for placeholders. Use this whenever someone shares a URL and says "analyze this site", "make something like this", "give me a prompt to build this", "recreate this effect", "clone the layout with my branding", or asks how a page's animation or structure works, even if they never say "teardown".

website-workflow

Plan and sequence a whole website build, from structure through design, code, WordPress and launch, by routing each stage to the right webcraft skill. Use this when someone asks to "build me a website", "design my site from scratch", "redo our homepage", wants an end-to-end plan for a marketing, agency, studio or service site, or the request spans more than one of structure, look, layout, motion, CMS and QA.

wordpress-theme-build

Turn a static HTML/CSS/JS design into a custom WordPress theme that the client can edit, covering theme structure, theme.json, enqueueing scripts, block patterns, custom post types and editable content. Use this whenever someone wants to convert a design or static site to WordPress, build a custom or block theme, make sections editable in Gutenberg, add GSAP or other scripts to a theme properly, or asks why their theme edits are lost or their content is hard-coded.

Habilidades Relacionadas