wordpress: adiciona skill wp-content-seo-gate

2026-07-30 22:39:49 +01:00
parent 3ed97b472e
commit d9d4bb8858
1 changed files with 110 additions and 0 deletions
@@ -0,0 +1,110 @@
+---
+name: wp-content-seo-gate
+description: "Regras e padrões obrigatórios para geração de conteúdo WordPress com RankMath Pro. INVOCAR AUTOMATICAMENTE quando: (1) escrevendo ou revendo prompts que gerem artigos, posts, descrições de podcast ou qualquer texto para publicar em WordPress, (2) criando, modificando ou auditando sistemas/pipelines/scripts que publicam conteúdo automaticamente em WordPress (publishers, crons, geradores), (3) gerando directamente conteúdo para posts WP. Previne os erros RankMath mais comuns: slug sem focus keyword, título sem número, keyword density baixa, meta description fora do limite."
+---
+
+# WP Content SEO Gate
+
+Aplicar ANTES de escrever prompts de geração e ANTES de implementar qualquer sistema que publique em WordPress.
+
+## Regras Obrigatórias para Prompts de Geração
+
+Todo o prompt que instruir um LLM a gerar conteúdo WP DEVE incluir estas regras literais:
+
+| Campo | Regra a incluir no prompt |
+|-------|--------------------------|
+| `focus_keyword` | 2-5 palavras, foco no benefício/problema, não no nome da ferramenta |
+| `slug` | Começar com palavras da focus_keyword (hifenado, sem acentos, ≤75 chars) |
+| `rank_math_title` | 50-60 chars, contém focus_keyword E um número (ano corrente ou dado concreto: "47%", "3x") |
+| `rank_math_description` | 140-160 chars, focus_keyword nos primeiros 120 chars |
+| `content` | focus_keyword nos primeiros 200 chars + ≥2x no corpo + ≥1 H2/H3 com a keyword |
+| `image_alt` | 40-100 chars descritivo, contém focus_keyword |
+| `secondary_keywords` | 3-5 keywords complementares, cada uma ≥1x no content |
+
+**Checklist mental no prompt (incluir literalmente):**
+- [ ] focus_keyword aparece em: title, rank_math_title, rank_math_description, slug, primeiros 200 chars, ≥1 H2, ≥2x no corpo
+- [ ] rank_math_title contém um número (ano ou dado concreto)
+- [ ] slug começa com as palavras da focus_keyword
+- [ ] ≥600 palavras (RankMath penaliza abaixo deste limite)
+
+## Padrões Obrigatórios em Publishers/Pipelines
+
+Todo o sistema que publica em WP via código DEVE implementar estes dois auto-fixes **depois** de receber o JSON do LLM e **antes** de publicar:
+
+### Auto-fix 1 — Slug sem focus keyword
+
+```python
+def slugify(text: str) -> str:
+    text = unicodedata.normalize("NFD", text.lower())
+    text = "".join(c for c in text if unicodedata.category(c) != "Mn")
+    text = re.sub(r'[^a-z0-9\s-]', '', text)
+    return re.sub(r'[-\s]+', '-', text.strip()).rstrip('-')
+
+def has_keyword_in_slug(slug: str, fk: str) -> bool:
+    # Match sem stopwords e sem acentos
+    stopwords = {"a","o","as","os","de","da","do","das","dos","e","em","no","na","nos","nas","para","por","pelo","pela"}
+    norm = lambda s: " ".join(t for t in slugify(s).replace("-"," ").split() if t not in stopwords)
+    return norm(fk) in norm(slug)
+
+# Aplicar após generate_article():
+if not has_keyword_in_slug(article['slug'], article['focus_keyword']):
+    fk_slug = slugify(article['focus_keyword'])
+    orig_words = [w for w in article['slug'].split('-') if w not in fk_slug.split('-') and len(w) > 3][:2]
+    article['slug'] = (fk_slug + ('-' + '-'.join(orig_words) if orig_words else ''))[:75].rstrip('-')
+```
+
+### Auto-fix 2 — Título sem número (RankMath Title Readability)
+
+```python
+import time, re
+
+if not re.search(r'\d', article.get('rank_math_title', '')):
+    year = time.strftime('%Y')
+    t = article['rank_math_title'].rstrip()
+    article['rank_math_title'] = (t[:55].rstrip() + f' {year}') if len(t) > 55 else f'{t} {year}'
+```
+
+## Checklist de Validação Pré-publicação
+
+Verificar em qualquer publisher antes do `wp post create`:
+
+- [ ] slug contém focus_keyword (sem acentos, hifenado)
+- [ ] rank_math_title tem ≥1 dígito e ≤60 chars
+- [ ] rank_math_description entre 140-160 chars e com focus_keyword
+- [ ] image_alt contém focus_keyword
+- [ ] content ≥600 palavras
+- [ ] focus_keyword nos primeiros 200 chars do content
+- [ ] ≥1 H2 com a focus_keyword
+- [ ] Link externo à fonte (`rel="noopener"`)
+- [ ] 1-3 links internos descomplicar.pt no corpo
+
+## Erros RankMath mais comuns
+
+| Erro no painel | Causa | Fix |
+|----------------|-------|-----|
+| "Focus Keyword not found in URL" | LLM gera slug sem a FK | Auto-fix 1 obrigatório |
+| "Title doesn't contain a number" | Título sem ano/dado | Auto-fix 2 + instruir LLM |
+| "FK not in first 10%" | Lead não inclui a FK | Regra de prompt: FK nos primeiros 200 chars |
+| "Keyword density too low/high" | <1% ou >3% | Verificar count antes de publicar |
+| SEO Score N/A no dashboard | Post criado via CLI sem Gutenberg | Usar cálculo server-side de `/seo-post` Passo 6 |
+| Schema ausente no HTML | Falta `rank_math_schema_*` | Ver `/seo-post` Modo aplicar Passo 3 |
+
+## PROC Canónico
+
+**Ler antes de agir:** `Hub/06-Operacoes/Procedimentos/D7-Tecnologia/WordPress/PROC-Conteudo-RankMath.md` (D7-WP-RM-001)
+
+Este PROC é a fonte única de verdade para:
+- Estrutura obrigatória do conteúdo (headings, distribuição FK, elementos por tipo)
+- Tabela completa de campos RankMath com valores aceitáveis
+- Comandos WP-CLI exactos para aplicar meta, schema e calcular score
+- Checklist de validação final (9 pontos)
+- Tabela de erros comuns e resolução
+
+Quando o detalhe de uma regra não está nesta skill, está no PROC.
+
+## Referências Adicionais
+
+- `/seo-post` — auditar e corrigir posts **já publicados** via WP-CLI (schema, score, OG, robots)
+- `Dev/claude_automations_dev/intelligence-publisher/publisher.py` — implementação de referência dos auto-fixes
+- `Dev/claude_automations_dev/intelligence-publisher/prompts/article.md` — prompt de referência para artigos de notícias
+- `Hub/05-Projectos/Podcast-Descomplicar-Digital/prompts/generate-wp-description.md` — prompt de referência para posts de podcast