Files
Emanuel Almeida 6b3a6f2698 feat: refactor 30+ skills to Anthropic progressive disclosure pattern
- All SKILL.md files now <500 lines (avg reduction 69%)
- Detailed content extracted to references/ subdirectories
- Frontmatter standardised: only name + description (Anthropic standard)
- New skills: brand-guidelines, spec-coauthor, report-templates, skill-creator
- Design skills: anti-slop guidelines, premium-proposals reference
- Removed non-standard frontmatter fields (triggers, version, author, category)

Plugins affected: infraestrutura, marketing, dev-tools, crm-ops, gestao,
core-tools, negocio, perfex-dev, wordpress, design-media

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-12 15:05:03 +00:00

4.2 KiB

name, description
name description
seo-report Relatorio de auditoria SEO completo com Lighthouse, Google Search Console e exportacao para Google Docs. Analisa Core Web Vitals, desempenho, SEO on-page e gera recomendacoes accionaveis.

Skill: /seo-report

Gera relatorio SEO completo com dados de multiplas fontes e exporta automaticamente para Google Docs.


Contexto NotebookLM

ANTES de executar, consultar notebook para contexto especializado:

Notebook ID Consultar quando
Marketing Digital PT 4c595973 Sempre
mcp__notebooklm__notebook_query({
  notebook_id: "4c595973-ba10-420a-a3bf-e4389e424ad3",
  query: "<adaptar ao contexto — ex: auditoria SEO, relatorio performance, recomendacoes tecnicas>"
})

Procedimento relacionado: PROC-DMARC-Email-Entregabilidade.md -- consultar quando o relatorio envolve email deliverability.


Trigger

/seo-report <url> ou /seo-report <url> <email_destino>


Exemplos

# Relatorio basico (envia para emanuelalmeidaa@gmail.com)
/seo-report https://descomplicar.pt

# Relatorio para cliente especifico
/seo-report https://cliente.pt cliente@email.com

# Relatorio com analise concorrencia
/seo-report https://site.pt --competitors=concorrente1.pt,concorrente2.pt

Fontes de Dados

Fonte Dados Recolhidos Tempo
Lighthouse (Desktop) Performance, SEO, Accessibility, Best Practices ~30s
Lighthouse (Mobile) Core Web Vitals, INP, comparacao mobile/desktop ~30s
Lighthouse (Optimizacoes) Oportunidades LCP, JS nao usado, images optimization ~15s
GSC Cliques, impressoes, CTR, posicao media, top queries, tendencia 90 dias ~10s
SEO Tools API Meta tags, imagens, alt text, links internos/externos, estrutura HTML ~5s
Ahrefs (opcional) DR, UR, backlinks, referring domains ~10s

Tempo Total: ~1m40s (sem concorrencia) | ~3m (com 2 concorrentes)


Workflow

  1. Validar URL de entrada
  2. Verificar se site esta no GSC (skip se nao)
  3. Executar auditorias em paralelo:
    • Lighthouse Desktop + Mobile
    • Core Web Vitals
    • SEO Tools API
    • GSC Analytics (se disponivel)
    • Ahrefs (se habilitado)
  4. Processar e formatar dados
  5. Gerar relatorio Markdown
  6. Criar Google Doc e partilhar
  7. Retornar link do documento

Estrutura do Relatorio

O relatorio final tem 8 seccoes:

  1. Sumario Executivo -- Top 5 descobertas + accao imediata recomendada
  2. Pontuacoes Globais -- Desktop vs Mobile (Performance, SEO, A11y, Best Practices)
  3. Core Web Vitals -- LCP, INP, CLS com oportunidades de optimizacao
  4. GSC Analytics -- Performance overview, top queries, oportunidades CTR (ultimos 90 dias)
  5. Analise On-Page -- Meta tags, imagens SEO, internal linking
  6. Backlinks e Autoridade -- DR, UR, top backlinks, estrategia
  7. Plano de Accao -- Priorizado (critico/importante/melhoria) com impacto e esforco
  8. Roadmap Trimestral -- Fundacao tecnica -> Conteudo e autoridade -> Consolidacao

Propriedades GSC Disponiveis

sc-domain:descomplicar.pt
https://emanuelalmeida.pt/
https://carstuff.pt/
https://solarfvengenharia.com/
https://aquisevende.pt/
https://alojadamaria.com/
https://e-commerce.descomplicar.pt/

Notas Tecnicas

Requisitos

  • SEO Tools API a correr: ~/mcp-servers/seo-tools-api/start.sh
  • Google Workspace MCP configurado
  • GSC authentication (OAuth primeira vez)

Erros Comuns

  • Site nao em GSC: Relatorio gerado sem dados GSC (aviso incluido)
  • Lighthouse timeout: Retry automatico (3x)
  • Ahrefs rate limit: Skip backlinks, aviso no relatorio

References (conteudo detalhado)

Ficheiro Conteudo
references/template-relatorio.md Template completo do relatorio com todas as tabelas e seccoes
references/implementacao-tecnica.md Workflow mermaid, codigo JS, funcoes GSC, notas tecnicas

Anti-Patterns

  • Gerar relatorio sem dados reais (sempre usar MCPs)
  • Ignorar gap mobile/desktop
  • Nao priorizar recomendacoes (tudo parece igual)
  • Esquecer de verificar se site esta no GSC antes de tentar recolher dados
  • Relatorio sem accoes concretas e estimativas de impacto

Versao: 2.1.0 | Autor: Descomplicar