benchmark

Visão geral do skill benchmark

O que o skill benchmark faz

O skill benchmark serve para detectar regressões de performance em fluxos web e de aplicativos. Ele ajuda você a estabelecer uma linha de base, comparar antes e depois das mudanças e acompanhar se um PR deixou páginas mais lentas, mais pesadas ou menos estáveis. Na prática, o skill benchmark é mais útil para equipes que querem responder a uma pergunta simples: esta mudança melhorou ou piorou a performance?

Quem deve usá-lo

Use este skill benchmark se você se importa com velocidade de página, Core Web Vitals, verificações no estilo Lighthouse, tamanho de bundle ou tendências de tempo de carregamento ao longo do tempo. Ele é uma ótima opção para revisores, engenheiros de frontend e agentes de IA que precisam de uma forma repetível de avaliar mudanças de performance em vez de adivinhar a partir de uma captura de tela ou de um teste manual rápido.

Por que ele é diferente

O skill benchmark não é só um prompt genérico de “rode um teste”. Ele é orientado à comparação antes/depois, à detecção de regressões e à percepção contínua de tendências, com orientação de fluxo ajustada para medições de performance no navegador. Isso o torna mais útil para Performance Optimization do que um prompt pontual que só pede por “problemas de velocidade”.

Como usar o skill benchmark

Instalação e configuração do benchmark

Instale o skill benchmark no seu ambiente de skills do Claude com o comando do repositório e, antes de usá-lo numa tarefa real, abra o arquivo do skill. O caminho esperado de instalação é:
npx skills add garrytan/gstack --skill benchmark

Depois da instalação, confirme que o skill está disponível no workspace atual e que sua tarefa é específica o bastante para ser medida. O skill funciona melhor quando o repositório em teste, a página ou rota e a mudança sendo avaliada já estão definidos de antemão.

O que ler primeiro

Comece por SKILL.md e, depois, examine SKILL.md.tmpl se quiser entender a estrutura gerada. Como este repositório não expõe rules/, resources/ ou scripts auxiliares adicionais para o skill, a principal fonte de verdade é o próprio arquivo do skill. Para fins de decisão, as seções mais importantes são o preâmbulo, a orientação de plan mode e qualquer nota de roteamento ou restrição que afete quando o skill benchmark deve ser executado.

Como escrever um bom prompt

Um prompt fraco diz “verifique a performance”. Um prompt melhor de uso do benchmark nomeia o alvo, a linha de base e a decisão que você precisa tomar:

• “Compare /pricing antes e depois da mudança de compressão de imagens e reporte qualquer regressão em LCP, CLS e tamanho total transferido.”
• “Faça benchmark da página de checkout em emulação mobile e me diga se o novo fracionamento do bundle melhorou o tempo de carregamento.”
• “Execute um benchmark de performance para a homepage e resuma se o PR está seguro para merge.”

Inclua a página, as suposições de dispositivo e o que conta como falha. Isso reduz a ambiguidade e torna o resultado acionável.

Fluxo de trabalho que gera resultados úteis

Use o guia de benchmark como um ciclo repetível: identifique a página, estabeleça a linha de base, execute a comparação e então interprete o delta em relação à mudança feita. Se você estiver trabalhando em plan mode, confirme se o skill deve apenas inspecionar ou também executar medições. Para obter o melhor resultado, mantenha o escopo do teste estreito; uma rota importante geralmente é melhor do que um sweep em todo o site.

Perguntas frequentes sobre o skill benchmark

O skill benchmark é só para performance web?

Ele é voltado principalmente para otimização de performance visível no navegador, especialmente páginas, rotas e mudanças de frontend. Se sua tarefa for latência de backend, profiling de infraestrutura ou ajuste de banco de dados, o skill benchmark pode não ser a melhor primeira escolha, a menos que a métrica da página para o usuário seja o objetivo.

Preciso de um prompt completo ou o skill basta?

O skill ajuda a estruturar o trabalho, mas ainda precisa de um alvo concreto. Um prompt genérico pode acionar o skill benchmark, porém o uso mais forte do benchmark acontece quando você fornece uma rota, uma mudança e um ponto de comparação. Quanto mais específico for o pedido, menos o agente precisa inferir.

O benchmark é bom para iniciantes?

Sim, se você quer uma forma guiada de verificar se uma mudança piorou a performance. Ele é mais fácil de usar do que montar sua própria checklist de avaliação do zero, mas ainda é preciso saber qual página ou recurso você quer medir.

Quando não devo usá-lo?

Não use o skill benchmark quando você só precisa de uma revisão qualitativa de UI, quando a página está instável demais para uma medição significativa ou quando o seu problema principal não é performance. Se você não consegue definir uma comparação estável de antes/depois, o resultado do benchmark tende a ficar ruidoso.

Como melhorar o skill benchmark

Dê ao skill um alvo mensurável

O maior ganho de qualidade vem de especificar exatamente o que deve ser benchmarkeado e como será o sucesso. Diga qual URL, qual classe de dispositivo e qual métrica importa mais. Para Performance Optimization, isso muitas vezes significa nomear uma métrica principal, como LCP ou tamanho do bundle, em vez de pedir “todos os problemas de performance”.

Inclua a mudança que está sendo testada

O benchmark é mais forte quando o skill sabe o que mudou: um novo pipeline de imagens, um refactor de code splitting, a troca de uma fonte ou a remoção de um script de terceiro. Esse contexto ajuda a separar variação normal de uma regressão real e torna a saída mais confiável.

Peça a comparação sobre a qual você vai agir

Se você precisa decidir se faz merge, diga isso. Se você precisa de ideias de correção, diga também. Bons prompts de acompanhamento incluem:

• “Compare com a última build estável e sinalize qualquer coisa acima de 5% de regressão.”
• “Faça benchmark desta branch e depois me diga qual correção tem maior impacto se o resultado piorar.”
• “Rode a verificação de novo em mobile e desktop, mas priorize a rota com o pior LCP.”

Itere na primeira execução

Se o primeiro resultado vier ruidoso, melhore a entrada antes de rodar de novo: restrinja a rota, remova mudanças irrelevantes ou defina as condições de teste com mais precisão. O skill benchmark funciona melhor quando você o trata como um skill benchmark repetível para apoio à decisão, e não como um diagnóstico de passagem única para qualquer tipo de problema de velocidade.