Communitygithub.com

ComeOnOliver/skillshub

Audite sites para problemas de SEO, técnicos, conteúdo, desempenho e segurança usando a CLI squirrelscan.

O que é skillshub?

Esta skill permite que agentes de IA realizem auditorias completas em sites, utilizando a ferramenta de linha de comando squirrelscan. A auditoria cobre mais de 230 regras em 21 categorias, incluindo SEO, desempenho, segurança, acessibilidade e usabilidade. A skill é compatível com macOS, Windows e Linux, e fornece um relatório detalhado com pontuação geral de saúde (0-100), problemas específicos por URL, detecção de links quebrados e recomendações acionáveis. O fluxo de trabalho principal envolve executar uma auditoria, exportar o relatório em formato otimizado para LLM e iterar na correção dos problemas, com suporte a paralelização de correções via subagentes e comparação de regressão entre auditorias.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/LeoYeAI/openclaw-master-skills/audit-website

Perguntar na sua IA favorita

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

Documentação

Habilidade de Auditoria de Sites

Audite sites para problemas de SEO, técnicos, conteúdo, desempenho e segurança usando a CLI squirrelscan.

O squirrelscan fornece uma ferramenta CLI squirrel - disponível para macOS, Windows e Linux. Ela realiza auditorias extensas de sites simulando um navegador, um rastreador de busca e analisando a estrutura e o conteúdo do site com base em mais de 230 regras.

Isso fornecerá uma lista de problemas, bem como sugestões sobre como corrigi-los.

Links

Você pode consultar a documentação de qualquer regra usando este modelo:

https://docs.squirrelscan.com/rules/{rule_category}/{rule_id}

exemplo:

https://docs.squirrelscan.com/rules/links/external-links

O que Esta Habilidade Faz

Esta habilidade permite que agentes de IA auditem sites com base em mais de 230 regras em 21 categorias, incluindo:

  • Problemas de SEO: Meta tags, títulos, descrições, URLs canônicas, tags Open Graph
  • Problemas Técnicos: Links quebrados, cadeias de redirecionamento, velocidade da página, compatibilidade com dispositivos móveis
  • Desempenho: Tempo de carregamento da página, uso de recursos, cache
  • Qualidade do Conteúdo: Estrutura de cabeçalhos, texto alternativo de imagens, análise de conteúdo
  • Segurança: Segredos vazados, uso de HTTPS, cabeçalhos de segurança, conteúdo misto
  • Acessibilidade: Texto alternativo, contraste de cores, navegação por teclado
  • Usabilidade: Validação de formulários, tratamento de erros, fluxo do usuário
  • Links: Verificação de links internos e externos quebrados
  • E-E-A-T: Expertise, Experiência, Autoridade, Confiabilidade
  • Experiência do Usuário: Fluxo do usuário, tratamento de erros, validação de formulários
  • Dispositivo Móvel: Verificação de compatibilidade com dispositivos móveis, design responsivo, elementos táteis
  • Rastreabilidade: Verificação de rastreabilidade, robots.txt, sitemap.xml e mais
  • Schema: Marcação Schema.org, dados estruturados, rich snippets
  • Legal: Conformidade com requisitos legais, políticas de privacidade, termos de serviço
  • Social: Open graph, twitter cards e validação de esquemas, snippets, etc.
  • Estrutura de URL: Comprimento, hífens, palavras-chave
  • Palavras-chave: Excesso de palavras-chave
  • Conteúdo: Estrutura do conteúdo, cabeçalhos
  • Imagens: Texto alternativo, contraste de cores, tamanho da imagem, formato da imagem
  • SEO Local: Consistência NAP, metadados geográficos
  • Vídeo: Esquema VideoObject, acessibilidade e mais

A auditoria rastreia o site, analisa cada página com base nas regras de auditoria e retorna um relatório abrangente com:

  • Pontuação geral de saúde (0-100)
  • Detalhamento por categoria (SEO principal, SEO técnico, conteúdo, segurança)
  • Problemas específicos com URLs afetadas
  • Detecção de links quebrados
  • Recomendações acionáveis
  • As regras têm níveis de erro, aviso e notificação, e também têm uma classificação entre 1 e 10

Quando Usar

Use esta habilidade quando precisar:

  • Analisar a saúde de um site
  • Depurar problemas de SEO técnico
  • Corrigir todos os problemas mencionados acima
  • Verificar links quebrados
  • Validar meta tags e dados estruturados
  • Gerar relatórios de auditoria do site
  • Comparar a saúde do site antes/depois de alterações
  • Melhorar o desempenho, acessibilidade, SEO, segurança e muito mais do site.

Você deve reauditar o máximo possível para garantir que seu site permaneça saudável e tenha um bom desempenho.

Pré-requisitos

Esta habilidade requer a CLI squirrel instalada e no PATH.

Instalação: squirrelscan.com/download

Verificação:

squirrel --version

Configuração

Execute squirrel init para criar um arquivo de configuração squirrel.toml no diretório atual. Se nenhum existir, crie um e especifique um nome de projeto:

squirrel init -n my-project
# sobrescrever configuração existente
squirrel init -n my-project --force

Uso

Introdução

Existem três processos que podem ser executados e todos são armazenados em cache no banco de dados local do projeto:

  • crawl - subcomando para executar um rastreio ou atualizar, continuar um rastreio
  • analyze - subcomando para analisar os resultados do rastreio
  • report - subcomando para gerar um relatório no formato desejado (llm, text, console, html, etc.)

O comando 'audit' é um wrapper em torno desses três processos e os executa sequencialmente:

squirrel audit https://example.com --format llm

VOCÊ DEVE sempre preferir a opção de formato llm - ela foi feita para você e fornece um formato de saída exaustivo e compacto.

A PRIMEIRA VARREDURA deve ser uma varredura de superfície, que é um escaneamento rápido e superficial do site para coletar informações básicas sobre o site, como sua estrutura, conteúdo e pilha de tecnologia. Esta varredura pode ser feita rapidamente e sem impactar o desempenho do site.

A SEGUNDA VARREDURA deve ser uma varredura profunda, que é um escaneamento completo e detalhado do site para coletar mais informações sobre o site, como segurança, desempenho e acessibilidade. Esta varredura pode levar mais tempo e pode impactar o desempenho do site.

Se o usuário não fornecer um site para auditar, pergunte qual URL ele gostaria de auditar.

Você deve PREFERIR auditar sites ao vivo - somente lá obtemos uma VERDADEIRA representação do site e problemas de desempenho ou renderização.

Se você tiver sites locais e ao vivo para auditar, peça ao usuário para escolher qual auditar e SUGIRA que ele escolha o site ao vivo.

Você pode aplicar correções de uma auditoria no site ao vivo contra o código local.

Ao planejar tarefas de escopo para que possam ser executadas simultaneamente como subagentes para acelerar as correções.

Ao implementar correções, aproveite os subagentes para acelerar a implementação das correções.

Após aplicar as correções, verifique se o código ainda compila e passa nas verificações existentes do projeto.

Fluxo de Trabalho Básico

O processo de auditoria consiste em duas etapas:

  1. Executar a auditoria (salva no banco de dados, mostra saída no console)
  2. Exportar relatório no formato desejado
# Etapa 1: Executar auditoria (padrão: saída no console)
squirrel audit https://example.com

# Etapa 2: Exportar no formato LLM
squirrel report <audit-id> --format llm

Diffs de Regressão

Quando precisar detectar regressões entre auditorias, use o modo de diff:

# Comparar relatório atual com um ID de auditoria de referência
squirrel report --diff <audit-id> --format llm

# Comparar o relatório de domínio mais recente com um domínio de referência
squirrel report --regression-since example.com --format llm

O modo diff suporta console, text, json, llm e markdown. html e xml não são suportados.

Executando Auditorias

Ao executar uma auditoria:

  1. Apresente o relatório - mostre ao usuário os resultados da auditoria e a pontuação
  2. Proponha correções - liste os problemas que você pode corrigir e peça a confirmação do usuário antes de fazer alterações
  3. Paralelize as correções aprovadas - use subagentes para edições em massa de conteúdo (texto alternativo, cabeçalhos, descrições)
  4. Itere - corrija o lote → reaudite → apresente resultados → proponha o próximo lote
  5. Pause para julgamento - links quebrados, mudanças estruturais e qualquer coisa ambígua devem ser sinalizados para revisão do usuário
  6. Mostre antes/depois - apresente a comparação de pontuação após cada lote de correção
  • Ciclo de Iteração: Após corrigir um lote de problemas, reaudite e continue corrigindo até:

    • A pontuação atingir a meta (normalmente 85+), OU
    • Apenas problemas que exigem julgamento humano permanecerem (por exemplo, "este link deve ser removido?")
  • Trate todas as correções igualmente: Mudanças de código e mudanças de conteúdo são igualmente importantes.

  • Paralelize correções de conteúdo: Para problemas que afetam vários arquivos:

    • Crie subagentes para corrigir em paralelo
    • Exemplo: 7 arquivos precisam de texto alternativo → crie 1-2 agentes para corrigir todos
    • Exemplo: 30 arquivos têm problemas de cabeçalho → crie agentes para editar em lote
  • Critérios de conclusão:

    • ✅ Todos os erros corrigidos
    • ✅ Todos os avisos corrigidos (ou documentados como exigindo revisão humana)
    • ✅ Reauditoria confirma melhorias
    • ✅ Comparação antes/depois mostrada ao usuário

Após as correções serem aplicadas, pergunte ao usuário se ele gostaria de revisar as alterações.

Metas de Pontuação

Pontuação InicialPontuação AlvoTrabalho Esperado
< 50 (Nota F)75+ (Nota C)Correções principais
50-70 (Nota D)85+ (Nota B)Correções moderadas
70-85 (Nota C)90+ (Nota A)Aperfeiçoamento
> 85 (Nota B+)95+Ajuste fino

Um site só é considerado COMPLETO e CORRIGIDO quando as pontuações estão acima de 95 (Nota A) com cobertura definida como FULL (--coverage full).

Categorias de Problemas

CategoriaAbordagem de CorreçãoParalelizável
Meta tags/títulosEditar componentes da página ou metadadosNão
Dados estruturadosAdicionar JSON-LD aos templates da páginaNão
H1/cabeçalhos ausentesEditar componentes da página + arquivos de conteúdoSim (conteúdo)
Texto alternativo de imagensEditar arquivos de conteúdoSim
Hierarquia de cabeçalhosEditar arquivos de conteúdoSim
Descrições curtasEditar frontmatter do conteúdoSim
Links HTTP→HTTPSLocalizar e substituir no conteúdoSim
Links quebradosRevisão manual (sinalizar para o usuário)Não

Para correções paralelizáveis: Crie subagentes com atribuições de arquivo específicas.

Correções em Arquivos de Conteúdo

Muitos problemas exigem a edição de arquivos de conteúdo. Eles são igualmente importantes quanto as correções de código:

  • Texto alternativo de imagens: Adicionar texto alternativo descritivo às imagens
  • Hierarquia de cabeçalhos: Corrigir níveis de cabeçalho ignorados
  • Meta descrições: Estender descrições curtas no frontmatter
  • Links HTTP: Atualizar links inseguros para HTTPS

Paralelizando Correções com Subagentes

Quando o usuário aprovar um lote de correções, você pode usar subagentes para aplicá-las em paralelo:

  • Pergunte ao usuário primeiro — sempre confirme quais correções aplicar antes de criar subagentes
  • Agrupe 3-5 arquivos por subagente para o mesmo tipo de correção
  • Paralelize apenas arquivos independentes (sem componentes ou configuração compartilhados)
  • Crie vários subagentes em uma única mensagem para execução concorrente

Opções Avançadas

Auditar mais páginas:

squirrel audit https://example.com --max-pages 200

Forçar rastreio novo (ignorar cache):

squirrel audit https://example.com --refresh

Retomar rastreio interrompido:

squirrel audit https://example.com --resume

Saída detalhada para depuração:

squirrel audit https://example.com --verbose

Opções Comuns

Opções do Comando Audit

OpçãoAliasDescriçãoPadrão
--format <fmt>-f <fmt>Formato de saída: console, text, json, html, markdown, llmconsole
--coverage <mode>-C <mode>Modo de cobertura: quick, surface, fullsurface
--max-pages <n>-m <n>Número máximo de páginas a rastrear (máx. 5000)varia por cobertura
--output <path>-o <path>Caminho do arquivo de saída-
--refresh-rIgnorar cache, buscar todas as páginas novamentefalse
--resume-Retomar rastreio interrompidofalse
--verbose-vSaída detalhadafalse
--debug-Log de depuraçãofalse
--trace-Habilitar rastreamento de desempenhofalse
--project-name <name>-n <name>Sobrescrever nome do projetodo config

Modos de Cobertura

Escolha um modo de cobertura com base nas suas necessidades de auditoria:

ModoPáginas PadrãoComportamentoCaso de Uso
quick25Apenas sementes + sitemaps, sem descoberta de linksVerificações de CI, verificação rápida de saúde
surface100Uma amostra por padrão de URLAuditorias gerais (padrão)
full500Rastrear tudo até o limiteAnálise profunda

O modo surface é inteligente - ele detecta padrões de URL como /blog/{slug} ou /products/{id} e rastreia apenas uma amostra por padrão. Isso o torna eficiente para sites com muitas páginas semelhantes (blogs, e-commerce).

# Verificação rápida de saúde (25 páginas, sem descoberta de links)
squirrel audit https://example.com -C quick --format llm

# Auditoria surface padrão (100 páginas, amostragem de padrões)
squirrel audit https://example.com --format llm

# Auditoria completa abrangente (500 páginas)
squirrel audit https://example.com -C full --format llm

# Sobrescrever limite de páginas para qualquer modo
squirrel audit https://example.com -C surface -m 200 --format llm

Quando usar cada modo:

  • quick: Pipelines de CI, verificações diárias de saúde, monitoramento
  • surface: A maioria das auditorias - cobre templates únicos de forma eficiente
  • full: Antes de lançamentos, análise abrangente, mergulhos profundos

Opções do Comando Report

OpçãoAliasDescrição
--list-lListar auditorias recentes
--severity <level>-Filtrar por gravidade: error, warning, all
--category <cats>-Filtrar por categorias (separadas por vírgula)
--format <fmt>-f <fmt>Formato de saída: console, text, json, html, markdown, xml, llm
--output <path>-o <path>Caminho do arquivo de saída
--input <path>-i <path>Carregar de arquivo JSON (modo de fallback)

Subcomandos de Config

ComandoDescrição
config showMostrar configuração atual
config set <chave> <valor>Definir valor de configuração
config pathMostrar caminho do arquivo de configuração
config validateValidar arquivo de configuração

Outros Comandos

ComandoDescrição
squirrel feedbackEnviar feedback para a equipe squirrelscan
squirrel skills installInstalar skill do Claude Code
squirrel skills updateAtualizar skill do Claude Code

Comandos de Autogestão

Comandos de autogestão sob squirrel self:

ComandoDescrição
self installInicializar instalação local
self updateVerificar e aplicar atualizações
self completionGerar conclusões de shell
self doctorExecutar verificações de saúde
self versionMostrar informações de versão
self settingsGerenciar configurações da CLI
self uninstallRemover squirrel do sistema

Formatos de Saída

Saída Console (padrão)

O comando audit mostra saída no console legível por humanos por padrão, com cores e indicadores de progresso.

Formato LLM

Para obter saída otimizada para LLM, use o comando report com --format llm:

squirrel report <audit-id> --format llm

O formato LLM é um híbrido compacto XML/texto otimizado para eficiência de tokens (40% menor que XML verbose):

  • Resumo: Pontuação geral de saúde e métricas principais
  • Problemas por Categoria: Agrupados por categoria de regra de auditoria (SEO principal, técnico, conteúdo, segurança)
  • Links Quebrados: Lista de links quebrados

Individual skills in this repo

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

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Habilidades Relacionadas