A skill leva um agente de programação da medição à correção de uma página Astro. Ela usa o CLI para medir e trabalha no código do projeto aberto no agente.
Instalação
Na raiz do projeto Astro, instale a skill direto do repositório no GitHub:
npx skills add https://github.com/promovaweb/pagespeedfyO npx skills lê a pasta skills/ do repositório e instala a skill nos
agentes escolhidos. A skill precisa do CLI instalado e de uma chave gravada
com pagespeedfy auth login.
Acionamento
Use $pagespeedfy-otimizar-pagina para otimizar https://promovaweb.com/blog/Informe uma URL. Com várias, a skill pede que você escolha uma e lista as outras para depois.
O que a skill faz
- Confere o CLI, a chave, o projeto Astro e o estado do Git.
- Confere se
pagespeedfy-reports/está no.gitignore. Se faltar, a linha entra no plano de correções. - Mede a página com
pagespeedfy run <url> --print path. - Lê todos os relatórios: o
report.json, os dois JSON brutos e as medições anteriores da mesma rota, para separar problemas recorrentes dos novos. - Acha a rota em
src/pages/, o layout, os componentes e os arquivos de origem de cada item reprovado, sem alterar nada. - Cria o plano de correções em
plano.md, na pasta da medição, com uma linha por auditoria: escopo, arquivo, correção proposta e efeito esperado. - Mostra o plano na tela e espera você dizer que pode corrigir.
- Aplica só as linhas autorizadas e atualiza o status de cada uma no plano.
- Roda o build e os testes do projeto.
- Mede de novo quando houver URL de preview e compara com a linha de base.
- Entrega o relatório final.
O plano de correções
O plano é o ponto de controle da skill. Nenhum arquivo do projeto muda antes da sua resposta. Você pode:
- autorizar o plano inteiro,
- autorizar só algumas linhas, por número, ou só alguns escopos,
- pedir ajustes. A skill atualiza o
plano.md, mostra a nova versão e pergunta de novo.
A resposta fica registrada na seção “Autorização” do plano.md. Se durante a
correção aparecer uma mudança que não estava no plano, a skill acrescenta a
linha e pede autorização outra vez.
Cada linha recebe um de quatro escopos:
| Escopo | Exemplo |
|---|---|
| Página | Imagem de capa sem <Image> na própria rota |
| Componente | Botão do header sem nome acessível, usado em várias páginas |
| Global | build.inlineStylesheets no astro.config.mjs |
| Fora do código | Cabeçalho de cache da CDN |
O que a skill não faz
- Não mede mais de uma página por execução.
- Não pede nem mostra a API key.
- Não altera o projeto antes de você autorizar o plano.
- Não faz deploy, commit nem push.
- Não altera hospedagem, CDN ou DNS.
- Não remove conteúdo, funcionalidade ou analytics para ganhar nota sem perguntar.
Referências da skill
references/leitura-relatorio.md: todos os campos doreport.jsone como consultar o JSON bruto.references/astro-correcoes.md: correção recomendada para cada ID de auditoria de Performance, Acessibilidade, Boas práticas e SEO.references/modelo-plano.md: estrutura doplano.md.