AI-Ready Sites
Uma skill auto-contida para websites e interfaces. Toda a orientação necessária para esta skill está incluída aqui. Não carregue outra skill instalada, invoque um motor de design externo ou exija instruções globais para seguir este fluxo de trabalho. Use as ferramentas fornecidas pelo host e dependências já apropriadas ao projeto. Ferramentas externas opcionais melhoram a verificação; sua ausência não bloqueia o design ou a implementação.
Comece no estágio do usuário
Inspecione a solicitação, as instruções aplicáveis do projeto, a stack, os componentes existentes e a documentação relevante de produto/design. Para alterações, inspecione a implementação existente e a UI renderizada quando disponível. Identifique brevemente o resultado e o menor caminho útil. O resumo do usuário e as convenções do projeto governam as escolhas visuais. Um DESIGN.md ausente não é permissão para redesenhar.
| Solicitação | Leia e faça |
|---|---|
| Planejar ou discutir | Brief e UX, depois orientação de design relevante; entregue o plano sem alterar arquivos do projeto, a menos que solicitado |
| Novo website ou redesenho substancial | Brief e UX → design → implementação → QA no navegador e qualidade aplicáveis → finalização |
| Componente pequeno ou correção de UI | Inspecione a superfície afetada; use apenas a orientação de design/implementação relevante, verificação focada no navegador e verificações obrigatórias do projeto |
| Apenas auditoria/revisão | Orientação relevante de design/qualidade/navegador; colete evidências e relate descobertas priorizadas; não edite o projeto auditado |
| Movimento | Movimento, UI afetada e verificação de movimento reduzido |
| Texto de site ou interface | Texto de site e interface e revisão editorial; escreva ou edite dentro do escopo solicitado |
| Instruções ou documentação técnica | Redação técnica e revisão editorial; verifique o procedimento relevante sem exigir a construção de um website |
| Edição ou tradução PT/EN | Revisão editorial, mais o guia de cópia/documentação relevante; preserve fatos, texto executável e rótulos reais da UI |
| Pronto para publicar? | Finalização, evidências atuais do navegador e verificações obrigatórias do projeto; nenhuma implantação implícita |
Carregue as referências quando necessário, não todas de uma vez. Esta é uma seleção de capacidades, não uma sequência obrigatória. Reutilize evidências válidas; não repita revisões equivalentes sob nomes diferentes.
Entregue trabalho útil
- Para trabalho novo, transforme fatos do produto em uma direção coerente e finalize uma jornada de usuário funcional antes de estendê-la. Para refinamento, preserve identidade e comportamento existentes fora do escopo. Para redesenho, preserve a verdade do produto e as funções necessárias enquanto altera o sistema visual solicitado.
- Construa com conteúdo real e controles funcionais. Rotule dados de demonstração, simulações locais e integrações indisponíveis. Não invente citações de clientes, alegações de desempenho, preços ou um backend funcional.
- Ao escrever ou editar texto, use o guia de texto relevante. Preserve fatos, condições, comandos e rótulos atuais da UI. Melhore clareza e utilidade; não otimize para pontuações de detectores de autoria. Trabalho apenas com texto não dispara estágios de design ou navegador, a menos que a solicitação reivindicada os exija.
- Torne texto, formulários, navegação e estados utilizáveis nas telas pretendidas, com teclado e semântica de tecnologia assistiva. A ambição de design se adequa à superfície: marketing expressivo, UI de tarefa precisa, editorial legível ou uma experiência liderada pelo próprio trabalho.
- Confirme o comportamento observando o resultado em um navegador real. Inspecione capturas de tela para reivindicações visuais; código-fonte, um clique bem-sucedido e uma compilação bem-sucedida não provam o resultado renderizado.
- Se ferramentas, autenticação, ativos ou pré-requisitos de tempo de execução estiverem indisponíveis, finalize o trabalho independente e declare a verificação específica ausente. Não fabrique um APROVADO, instale ferramentas não relacionadas ou substitua silenciosamente a stack do usuário.
- Mantenha o trabalho dentro do escopo autorizado. A criação do site não autoriza publicação, envios reais de formulários, serviços pagos ou alterações em produção. Continue o trabalho autorizado comum sem solicitações repetidas de aprovação.
Ferramentas e portabilidade
Resolva toda referência/script relativo a este SKILL.md. Nenhum caminho pessoal, SO específico, nome de skill externo, chave de API, framework ou conta de hospedagem é necessário. QA no navegador cobre descoberta de ferramentas, comportamento sem navegador e ajudantes opcionais incluídos. Chrome DevTools e Playwright são instruções no pacote, não dependências de outras skills.
Os ajudantes Node incluídos são opcionais. scripts/doctor.mjs relata capacidades locais básicas sem instalar nada; scripts/browser-check.mjs realiza uma verificação de fumaça limitada quando Playwright e um navegador já existem. Comece com --help deles. Nenhum runtime Node é necessário apenas para ler e usar esta skill com ferramentas do host.
Finalize com evidências
Relate a superfície alterada ou o resultado da auditoria primeiro, seguido pelas verificações realmente realizadas, artefatos relevantes e limitações. Para entregas substanciais, salve evidências concisas de QA usando a convenção do projeto. Para pequenas correções, a resposta final pode ser suficiente. Indique NÃO EXECUTADO quando uma verificação não pôde ser executada; reserve APROVADO para lançamento para verificações obrigatórias que realmente passaram sem nenhum bloqueador conhecido. Finalização define os limites do relatório e da aceitação.
O registro de atribuição é THIRD_PARTY_NOTICES.md; é proveniência, não instruções de tempo de execução. Nenhum CLI upstream, binário, serviço pago ou atualizador automático está incluído.