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
parent 9404af7ac9
commit 6b3a6f2698
397 changed files with 67154 additions and 17257 deletions
--- a/marketing/skills/seo-audit/references/ferramentas-api.md
+++ b/marketing/skills/seo-audit/references/ferramentas-api.md
@@ -0,0 +1,94 @@
+# Ferramentas e APIs - SEO Audit
+
+## 1. SEO Tools API (http://localhost:3000)
+
+```bash
+# Auditoria basica
+curl "http://localhost:3000/seo-audit?url=URL"
+
+# Velocidade PageSpeed Insights style
+curl "http://localhost:3000/page-speed-analyzer?url=URL"
+
+# Backlinks + DR/UR
+curl "http://localhost:3000/backlink-checker?url=URL"
+
+# Rankings para keywords
+curl "http://localhost:3000/rank-checker?url=URL&keywords=keyword1,keyword2"
+
+# Optimizacao conteudo on-page
+curl "http://localhost:3000/content-optimization?url=URL"
+
+# Internal linking structure
+curl "http://localhost:3000/internal-linking?url=URL"
+
+# Sitemap XML generator
+curl "http://localhost:3000/sitemap-generator?url=URL"
+
+# Analise concorrencia
+curl "http://localhost:3000/competitor-analysis?url=URL&competitors=site1.com,site2.com"
+```
+
+## 2. Lighthouse MCP
+
+| Tool | Funcao | Output |
+|------|--------|--------|
+| `run_audit(url)` | Auditoria completa | Performance, SEO, A11y, Best Practices |
+| `get_performance_score(url)` | Score performance | 0-100 |
+| `get_core_web_vitals(url)` | LCP, INP, CLS | Mobile + Desktop |
+| `get_accessibility_score(url)` | Acessibilidade | 0-100 + issues |
+| `get_seo_analysis(url)` | Analise SEO tecnico | Meta, headings, indexabilidade |
+| `get_security_audit(url)` | Seguranca | HTTPS, mixed content, headers |
+| `compare_mobile_desktop(url)` | Comparacao | Diferencas performance |
+| `get_lcp_opportunities(url)` | Optimizacoes LCP | Preload, lazy load |
+| `find_unused_javascript(url)` | JS nao usado | Tamanhos, % savings |
+
+## 3. SEO Ahrefs MCP (via API)
+
+| Tool | Funcao | Dados |
+|------|--------|-------|
+| `get_backlinks_list(domain)` | Lista backlinks | DR, UR, anchor text |
+| `keyword_generator(keyword, country)` | Ideias keywords | Volume, KD, CPC |
+| `get_traffic(domain)` | Trafego estimado | Visitas mensais, keywords |
+| `keyword_difficulty(keyword)` | Dificuldade keyword | 0-100 (KD score) |
+
+## 4. Google Search Console MCP
+
+| Tool | Funcao | Dados Reais |
+|------|--------|-------------|
+| `list_properties` | Listar sites verificados | URLs properties |
+| `get_search_analytics(site, period)` | Queries, cliques, CTR | Ultimos 16 meses |
+| `inspect_url_enhanced(site, url)` | Inspeccionar URL | Indexacao, mobile usability |
+| `check_indexing_issues(site, urls)` | Problemas indexacao | Erros, avisos |
+| `get_sitemaps(site)` | Listar sitemaps | Status, URLs submetidos |
+
+## 5. Google Analytics MCP
+
+| Tool | Funcao | Metricas |
+|------|--------|----------|
+| `get_account_summaries` | Listar contas | Properties disponiveis |
+| `run_report(property, metrics, dimensions)` | Relatorio custom | Sessions, users, bounce rate |
+| `run_realtime_report(property)` | Tempo real | Utilizadores activos now |
+
+## 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/
+```
+
+## Requisitos
+
+- **SEO Tools API** deve estar a correr: `~/mcp-servers/seo-tools-api/start.sh`
+- **GSC** requer autenticacao OAuth na primeira utilizacao
+- **GA** requer ADC credentials configuradas (`gcloud auth application-default login`)
+
+## Limitacoes
+
+- Ahrefs API tem rate limiting (100 req/day free tier)
+- GSC data maximo: 16 meses historico
+- Lighthouse scores variam +/- 5 pontos entre execucoes (network dependent)
--- a/marketing/skills/seo-audit/references/template-relatorio-auditoria.md
+++ b/marketing/skills/seo-audit/references/template-relatorio-auditoria.md
@@ -0,0 +1,195 @@
+# Template Relatorio Auditoria SEO
+
+```markdown
+# Relatorio SEO - [DOMINIO]
+**Data:** YYYY-MM-DD
+**Versao:** 2.0 (2026 Standards)
+
+---
+
+## Resumo Executivo
+
+| Metrica | Valor | Status |
+|---------|-------|--------|
+| **Score Geral** | X/100 | Bom / Medio / Critico |
+| **Core Web Vitals** | LCP Xs | INP Xms | CLS X | OK / Aviso / Critico |
+| **Backlinks** | X (DR: X) | Bom / Medio / Fraco |
+| **Problemas Criticos** | X | Lista abaixo |
+
+---
+
+## 1. Analise Tecnica
+
+### Meta Tags
+- **Title**: [OK/NOK] - [Conteudo]
+- **Description**: [OK/NOK] - [Conteudo]
+- **Canonical**: [OK/NOK]
+- **Open Graph**: [OK/NOK]
+
+### Headings Structure
+```
+H1: [Texto] OK
+  H2: [Texto] OK
+    H3: [Texto] OK
+  H2: [Texto] Aviso (Sem keyword)
+```
+
+### Velocidade
+- **Mobile**: X/100 - [LCP Xs | INP Xms | CLS X]
+- **Desktop**: X/100 - [LCP Xs | INP Xms | CLS X]
+- **Bloqueio Principal**: [JS/CSS/Imagens]
+
+---
+
+## 2. Core Web Vitals
+
+### Comparacao Mobile vs Desktop
+
+| Metrica | Mobile | Desktop | Diferenca |
+|---------|--------|---------|-----------|
+| LCP | X.Xs | X.Xs | +X.X% |
+| INP | Xms | Xms | +X% |
+| CLS | X | X | +X% |
+
+### Oportunidades LCP
+1. **Preload imagem hero** - Savings: X KB
+2. **Lazy load below-fold** - Savings: X KB
+3. **Optimizar servidor**: TTFB > 600ms
+
+### Oportunidades INP
+1. **Reduzir JS nao usado**: X KB (X% savings)
+2. **Code splitting**: Carregar so necessario
+3. **Web Workers**: Tarefas pesadas off main thread
+
+---
+
+## 3. Conteudo e E-E-A-T
+
+### On-Page SEO
+
+| Factor | Status | Nota |
+|--------|--------|------|
+| Keyword no title | OK / NOK | |
+| Keyword no H1 | OK / NOK | |
+| Keyword primeiros 100 chars | OK / NOK | |
+| Alt text imagens | OK / Aviso / NOK | X/Y com alt |
+| Internal linking | OK / Aviso / NOK | X links internos |
+| External links | OK / Aviso / NOK | X links autoritativos |
+
+### E-E-A-T Score
+
+| Criterio | Status | Observacao |
+|----------|--------|------------|
+| Autor identificado | OK / NOK | |
+| Bio com credenciais | OK / NOK | |
+| Data publicacao | OK / NOK | |
+| Experiencia demonstrada | OK / NOK | |
+| Fontes citadas | OK / NOK | X links externos |
+
+---
+
+## 4. Backlinks e Autoridade
+
+### Perfil de Links
+
+| Metrica | Valor | Benchmark |
+|---------|-------|-----------|
+| **Domain Rating (DR)** | X | > 30 bom |
+| **URL Rating (UR)** | X | > 20 bom |
+| **Backlinks Totais** | X | |
+| **Referring Domains** | X | > 50 bom |
+| **DoFollow vs NoFollow** | X% / X% | > 60% DoFollow ideal |
+
+### Top 5 Backlinks
+
+| Dominio | DR | Anchor Text | DoFollow |
+|---------|-----|-------------|----------|
+| site1.com | 75 | [Texto] | Sim |
+| ... | ... | ... | ... |
+
+### Oportunidades
+1. **Guest posts** em sites DR > 40
+2. **Broken link building** (X links quebrados encontrados)
+3. **Recuperar mencoes nao linkadas** (X mencoes)
+
+---
+
+## 5. Search Console (Dados Reais)
+
+### Performance Ultimos 90 Dias
+
+| Metrica | Valor | Variacao vs periodo anterior |
+|---------|-------|------------------------------|
+| **Cliques** | X | +X% / -X% |
+| **Impressoes** | X | +X% / -X% |
+| **CTR Medio** | X% | +X pp |
+| **Posicao Media** | X | +X / -X |
+
+### Top 10 Queries
+
+| Query | Cliques | Impressoes | CTR | Posicao |
+|-------|---------|------------|-----|---------|
+| query1 | X | X | X% | X |
+| ... | ... | ... | ... | ... |
+
+### Oportunidades CTR
+- **Posicao 4-10, CTR < 5%**: Optimizar meta description
+- **Posicao 11-20**: Targets faceis para top 10
+- **Alta impressao, baixo CTR**: Melhorar title/description
+
+### Indexacao
+
+| Estado | Paginas | Accao Necessaria |
+|--------|---------|------------------|
+| Indexadas | X | - |
+| Excluidas | X | Investigar |
+| Erros | X | Corrigir urgente |
+
+---
+
+## 6. Recomendacoes Prioritarias
+
+### Critico (Fazer AGORA)
+1. [ ] **[Problema]** - [Impacto] - [Solucao]
+2. [ ] **[Problema]** - [Impacto] - [Solucao]
+
+### Importante (Fazer esta semana)
+1. [ ] **[Problema]** - [Impacto] - [Solucao]
+2. [ ] **[Problema]** - [Impacto] - [Solucao]
+
+### Melhoria (Fazer este mes)
+1. [ ] **[Problema]** - [Impacto] - [Solucao]
+2. [ ] **[Problema]** - [Impacto] - [Solucao]
+
+---
+
+## Roadmap Optimizacao (Q1-Q2 2026)
+
+### Mes 1: Fundacao Tecnica
+- [ ] Corrigir todos os problemas criticos
+- [ ] Optimizar Core Web Vitals (target: All green)
+- [ ] Implementar E-E-A-T basico (autor, datas, bio)
+
+### Mes 2: Conteudo e Autoridade
+- [ ] Actualizar conteudo underperforming (posicao 11-20)
+- [ ] Criar conteudo para keywords gap vs concorrencia
+- [ ] Campanha backlinks (target: +10 DR > 30)
+
+### Mes 3: Consolidacao e Escala
+- [ ] Monitorizar rankings e ajustar
+- [ ] Expandir internal linking
+- [ ] Criar cluster de conteudo para keywords principais
+
+---
+
+## Ferramentas Utilizadas
+- SEO Tools API (localhost:3000)
+- Lighthouse MCP
+- SEO Ahrefs MCP
+- Google Search Console MCP
+- Google Analytics MCP (opcional)
+
+---
+
+**Proxima Auditoria**: [Data + 3 meses]
+```