zark-seo 1.0.0

package/templates/README.md

@@ -0,0 +1,537 @@
+# 🚀 ZARK SEO & GEO Skills Stack
+
+Stack completo de 12 skills especialistas em SEO Local, SEO de conteúdo e GEO (Generative Engine Optimization) para o mercado brasileiro. Cada skill é autocontida, especialista em uma frente específica, e foi desenhada pra ser composta com as demais.
+
+> **Contexto de criação:** desenvolvido pela ZARK em maio de 2026 a partir de auditoria real (Limppetec) que evidenciou os gaps mais comuns de SEO em PMEs brasileiras. As skills incorporam o stack ZARK Chat / n8n / Evolution API / Supabase para automação operacional.
+
+---
+
+## 📚 Skills disponíveis
+
+| # | Skill | O que faz | Quando aciona |
+|---|---|---|---|
+| 1 | `seo-local-auditor` | Auditoria SEO Local completa em 3 dimensões | "auditar SEO", "analisar Google Meu Negócio", "diagnóstico SEO local" |
+| 2 | `schema-jsonld-builder` | Gera Schema.org JSON-LD pronto pra colar | "criar schema", "JSON-LD", "dados estruturados", "rich snippets" |
+| 3 | `gbp-optimizer` | Otimiza Google Business Profile item por item | "otimizar Google Meu Negócio", "qual categoria GBP", "ranquear no Maps" |
+| 4 | `service-area-page-builder` | Cria páginas de cidade/bairro sem cair em doorway | "página de cidade", "rankear em outro bairro", "service area page" |
+| 5 | `meta-tags-optimizer` | Title, description, OG e Twitter Card otimizados | "otimizar title", "meta description", "preview no WhatsApp" |
+| 6 | `core-web-vitals-fixer` | Diagnóstico e correção de performance | "site lento", "PageSpeed baixo", "LCP", "INP", "CLS" |
+| 7 | `topical-authority-architect` | Arquitetura pillar + clusters por nicho | "estratégia de conteúdo", "pillar page", "topical authority" |
+| 8 | `seo-content-writer-br` | Escreve conteúdo SEO sem o estilo "AI-genérico" | "escrever artigo SEO", "criar página de serviço", "produzir conteúdo" |
+| 9 | `review-acquisition-engine` | Sistema completo de aquisição de reviews | "estratégia de reviews", "automatizar pedido", "responder reviews" |
+| 10 | `competitor-gap-analyzer` | Análise competitiva em 3 dimensões | "analisar concorrentes", "gap analysis", "espionar concorrente" |
+| 11 | `citations-builder-br` | Cadastro em diretórios BR com NAP consistente | "cadastrar em diretórios", "NAP", "citations", "presença online" |
+| 12 | `geo-llm-optimizer` | Otimização para LLMs (ChatGPT, Claude, Gemini, Perplexity) ★ | "GEO", "aparecer no ChatGPT", "ranking em IA", "LLM SEO" |
+
+★ = moat competitivo ZARK em 2026
+
+---
+
+## 🗺️ Pipelines de uso (ordem de execução)
+
+### Pipeline A — Cliente novo (90 dias do zero ao top)
+
+Cliente chegou. Empresa com presença digital fraca ou nenhuma. Aplicar nessa ordem:
+
+```
+Semana 1     ┌─ 1. seo-local-auditor          (diagnóstico inicial)
+             └─ 10. competitor-gap-analyzer    (contextualizar gaps)
+                       │
+Semana 2-3   ┌─ 3. gbp-optimizer               (60% do ranking Local)
+             ├─ 2. schema-jsonld-builder       (fundação de entidade)
+             └─ 6. core-web-vitals-fixer       (performance se aplicável)
+                       │
+Semana 4-6   ┌─ 7. topical-authority-architect (arquitetura conteúdo)
+             ├─ 4. service-area-page-builder   (expansão geográfica)
+             └─ 11. citations-builder-br       (presença off-site)
+                       │
+Semana 7-12  ┌─ 8. seo-content-writer-br       (produção)
+             ├─ 5. meta-tags-optimizer         (toda página criada)
+             └─ 9. review-acquisition-engine   (sistema contínuo)
+                       │
+Mês 4+       └─ 12. geo-llm-optimizer          (vetor competitivo)
+```
+
+### Pipeline B — Cliente existente (manutenção e evolução)
+
+Cliente já é ZARK há tempos. Mantém:
+
+```
+Mensal        ─ 9. review-acquisition-engine    (resposta a reviews + monitoramento)
+              ─ 8. seo-content-writer-br        (produção contínua de conteúdo)
+              ─ 5. meta-tags-optimizer          (toda página/post novo)
+
+Trimestral    ─ 1. seo-local-auditor            (re-auditoria)
+              ─ 10. competitor-gap-analyzer     (mercado mudou)
+              ─ 11. citations-builder-br        (manutenção NAP)
+              ─ 12. geo-llm-optimizer           (re-medir BMR/SOV)
+
+Semestral     ─ 6. core-web-vitals-fixer        (validar performance)
+              ─ 7. topical-authority-architect  (refresh de estratégia)
+```
+
+### Pipeline C — Criação de site novo (do zero, com Claude Code)
+
+Site novo de cliente ZARK. Claude Code monta tudo:
+
+```
+Planejamento  ┌─ 7. topical-authority-architect (definir estrutura semântica)
+              └─ 10. competitor-gap-analyzer    (validar diferenciação)
+                       │
+Estrutura     ┌─ 4. service-area-page-builder   (páginas de cidade)
+              └─ 8. seo-content-writer-br       (cada página)
+                       │
+Por página    ┌─ 5. meta-tags-optimizer         (title/desc/OG)
+              └─ 2. schema-jsonld-builder       (schema apropriado)
+                       │
+Pré-launch    ┌─ 6. core-web-vitals-fixer       (validar performance)
+              └─ 1. seo-local-auditor           (checklist final)
+                       │
+Pós-launch    ┌─ 3. gbp-optimizer               (vincular ao site)
+              ├─ 11. citations-builder-br       (cadastros)
+              └─ 9. review-acquisition-engine   (ativar sistema)
+```
+
+### Pipeline D — Pivot pra GEO (cliente com fundação pronta)
+
+Cliente já tem Local SEO sólido. Quer próximo passo:
+
+```
+Mês 1         ┌─ 12. geo-llm-optimizer          (auditoria + plano + llms.txt + Wikidata)
+              └─ 2. schema-jsonld-builder       (reforço com sameAs avançado)
+                       │
+Mês 2-3       ┌─ 8. seo-content-writer-br       (Q&A expandido + dados originais)
+              └─ 7. topical-authority-architect (refresh com viés conversacional)
+                       │
+Mês 4-6       ┌─ 12. geo-llm-optimizer          (PR digital, Reddit, pesquisa anual)
+                       │
+Mês 7-12      └─ 12. geo-llm-optimizer          (Wikipedia se elegível, awards, expansão)
+```
+
+---
+
+## 🧠 Lookup table — "Cliente disse X, aciono skill Y"
+
+| Cliente disse... | Skill principal | Skills complementares |
+|---|---|---|
+| "Meu site não aparece no Google" | 1 | 3, 6, 11 |
+| "Quero rankear em [cidade]" | 4 | 1, 3, 11 |
+| "Como aparecer mais no Google Meu Negócio?" | 3 | 9, 11 |
+| "Preciso de mais reviews" | 9 | 3 |
+| "Site tá lento" | 6 | 1 |
+| "Como escrever um artigo que rankeia?" | 8 | 7, 5, 2 |
+| "Quero saber o que falta pra superar [concorrente]" | 10 | 1, 3, 7 |
+| "Em quais sites devo cadastrar minha empresa?" | 11 | 3 |
+| "Como aparecer no ChatGPT?" | 12 | 2, 8 |
+| "Quero plano de conteúdo de blog" | 7 | 8, 10 |
+| "Como otimizar a página de [serviço]?" | 8 | 5, 2 |
+| "Preview do meu link tá feio no WhatsApp" | 5 | — |
+| "Schema do meu site tá certo?" | 2 | 1 |
+| "GEO vale a pena?" | 12 | 1 (validar fundação) |
+| "Quero criar um site novo" | 7 → 4 → 8 → 5 → 2 → 6 → 1 | (pipeline C) |
+| "Cliente novo, monta plano completo" | 1 → 10 → todas | (pipeline A) |
+| "Como medir se SEO tá funcionando?" | 1 (re-auditoria) + 12 (BMR) | 10 |
+
+---
+
+## 🔧 Setup no Claude Code
+
+### Instalação (única vez)
+
+```bash
+# Na raiz do projeto, criar pasta de skills
+mkdir -p .claude/skills
+
+# Para cada skill, criar pasta e copiar o SKILL.md
+mkdir -p .claude/skills/seo-local-auditor
+mkdir -p .claude/skills/schema-jsonld-builder
+mkdir -p .claude/skills/gbp-optimizer
+mkdir -p .claude/skills/service-area-page-builder
+mkdir -p .claude/skills/meta-tags-optimizer
+mkdir -p .claude/skills/core-web-vitals-fixer
+mkdir -p .claude/skills/topical-authority-architect
+mkdir -p .claude/skills/seo-content-writer-br
+mkdir -p .claude/skills/review-acquisition-engine
+mkdir -p .claude/skills/competitor-gap-analyzer
+mkdir -p .claude/skills/citations-builder-br
+mkdir -p .claude/skills/geo-llm-optimizer
+
+# Copiar cada SKILL.md pra sua pasta correspondente
+# (substituir pelo caminho onde você baixou os arquivos)
+```
+
+### Estrutura final esperada
+
+```
+[seu-projeto]/
+└── .claude/
+    └── skills/
+        ├── seo-local-auditor/
+        │   └── SKILL.md
+        ├── schema-jsonld-builder/
+        │   └── SKILL.md
+        ├── gbp-optimizer/
+        │   └── SKILL.md
+        ├── service-area-page-builder/
+        │   └── SKILL.md
+        ├── meta-tags-optimizer/
+        │   └── SKILL.md
+        ├── core-web-vitals-fixer/
+        │   └── SKILL.md
+        ├── topical-authority-architect/
+        │   └── SKILL.md
+        ├── seo-content-writer-br/
+        │   └── SKILL.md
+        ├── review-acquisition-engine/
+        │   └── SKILL.md
+        ├── competitor-gap-analyzer/
+        │   └── SKILL.md
+        ├── citations-builder-br/
+        │   └── SKILL.md
+        └── geo-llm-optimizer/
+            └── SKILL.md
+```
+
+### Validação pós-instalação
+
+1. Abrir Claude Code no projeto
+2. Pedir uma tarefa que aciona uma skill: "Faz uma auditoria SEO desse site"
+3. Confirmar que Claude Code identificou e carregou a skill correta
+4. Se não acionou: verificar se SKILL.md está com YAML frontmatter correto e descrição rica em triggers
+
+---
+
+## 🎯 Convenções de design ZARK
+
+Todas as 12 skills seguem esses princípios:
+
+### Estrutura padrão de SKILL.md
+
+```markdown
+---
+name: nome-da-skill
+description: [Descrição rica com múltiplos triggers de invocação em PT-BR]
+---
+
+# Nome da Skill — Padrão ZARK
+
+## Por que essa skill existe (contexto)
+
+## Princípios não-negociáveis (5-10 princípios)
+
+## Fluxo de execução (etapas numeradas)
+
+## [Catálogos / Templates / Tabelas específicas do domínio]
+
+## Estrutura obrigatória do entregável (template canônico)
+
+## Erros comuns que esta skill EVITA (10-20 itens)
+
+## Edge cases (casos brasileiros reais)
+
+## Conexão com outras skills ZARK
+
+## Exemplo de invocação esperada
+```
+
+### Princípios cross-skills
+
+1. **Honestidade sobre limitações.** Toda skill declara o que NÃO consegue fazer (sem ferramenta paga, sem acesso ao painel, etc.). Sem fingir ter dado que não tem.
+
+2. **Output executável, não relatório descritivo.** Cada skill entrega tabelas, templates prontos pra colar, cronogramas — não dossiês de leitura.
+
+3. **Tom direto, sem rodeios.** Cliente brasileiro paga pra saber o problema, não pra ouvir poema. Skills evitam jargão excessivo e auto-elogio.
+
+4. **Contexto BR sempre.** Diretórios BR, telefones com DDD, endereço com CEP, formas de pagamento PIX/boleto, particularidades regionais.
+
+5. **Skills se compõem, não vivem isoladas.** Cada skill referencia explicitamente quais outras skills ZARK ela aciona ou alimenta.
+
+6. **Quick wins primeiro.** Toda recomendação separa o que se faz em 1-2h do que leva 30-90 dias. Cliente vê valor rápido.
+
+7. **Reconhecer o que está bom antes da pancadaria.** Auditoria/análise sempre lista pontos positivos antes dos críticos. Cliente que recebe só pancadaria fecha o documento.
+
+---
+
+## 💼 Pacotes comerciais sugeridos (transformação em produto)
+
+Pra transformar o stack em serviço vendável da ZARK:
+
+### 📦 Pacote "SEO Local Setup" — R$ 1.500–3.000 (one-time)
+
+Skills usadas: 1, 2, 3, 5, 11
+
+Entregável:
+- Auditoria SEO Local completa
+- GBP otimizado (categorias, descrição, fotos, atributos, Q&A, posts iniciais)
+- Schema LocalBusiness implementado no site
+- Meta tags otimizadas das páginas principais
+- Cadastro em 15-20 diretórios BR (Tier 1 + setoriais)
+- Ficha-mestra NAP padronizada
+
+Tempo de execução: 2-3 semanas
+Cliente ideal: PME com presença digital fraca, fazendo primeiro investimento em SEO
+
+### 📦 Pacote "SEO Local Recorrente" — R$ 800–2.500/mês
+
+Skills usadas: 9 (sempre), 8 (sempre), 5 (sempre), 1 (trimestral), 10 (trimestral), 11 (manutenção)
+
+Entregável mensal:
+- 4 conteúdos otimizados (blog ou páginas)
+- Posts semanais no GBP
+- Sistema de aquisição de reviews ativo (com automação ZARK Chat)
+- Resposta a 100% das reviews
+- Manutenção de citations
+- Relatório mensal com ranking e métricas
+
+Entregável trimestral:
+- Re-auditoria SEO
+- Análise competitiva atualizada
+- Refresh de estratégia
+
+### 📦 Pacote "Site Novo SEO-Ready" — R$ 5.000–15.000 (one-time)
+
+Skills usadas: 7, 4, 8, 5, 2, 6, 1, 3 + design + dev
+
+Entregável:
+- Arquitetura semântica completa (pillar + clusters + Service Area Pages)
+- 8-15 páginas escritas seguindo padrão ZARK
+- Schema completo em todas as páginas
+- Meta tags otimizadas
+- Performance validada (passa Core Web Vitals)
+- GBP otimizado e vinculado ao site
+- Auditoria de checklist pré-launch
+
+Tempo: 4-8 semanas
+Cliente ideal: empresa lançando site novo ou refazendo do zero
+
+### 📦 Pacote "GEO Boost" — R$ 2.000–5.000 setup + R$ 1.500–3.000/mês
+
+Skill principal: 12 (`geo-llm-optimizer`)
+Skills suporte: 2 (schema avançado), 8 (Q&A + dados originais), 7 (estrutura)
+
+Entregável setup:
+- Auditoria de presença em 5 LLMs (BMR, SOV, sentiment baseline)
+- llms.txt implementado
+- Wikidata cadastrado
+- Schema avançado (sameAs Wikidata, FAQPage expandida)
+- Plano de 12 meses
+
+Entregável mensal:
+- 1-2 peças de conteúdo Q&A expandido
+- Atividade Reddit/Quora orgânica
+- 1 release ou pitch jornalístico/mês
+- Re-medição mensal de BMR e SOV
+- Relatório de progresso
+
+Cliente ideal: empresa com fundação SEO sólida, querendo diferenciação competitiva avançada
+Diferencial: pouquíssimas agências brasileiras oferecem GEO em 2026 — moat de 24+ meses
+
+### 📦 Pacote "ZARK Premium Full" — R$ 15.000–25.000 setup + R$ 4.000–8.000/mês
+
+Skills usadas: TODAS as 12
+
+Entregável: stack completo, manutenção contínua, GEO ativado, relatórios mensais detalhados.
+
+Cliente ideal: empresa em mercado competitivo (proteção veicular, advocacia em capital, e-commerce) que precisa dominância de longo prazo.
+
+---
+
+## 🏢 Aplicação aos clientes ZARK atuais
+
+Como o stack se aplica aos 4 clientes reais ZARK:
+
+### Limppetec (locação de equipamentos de limpeza, Contagem-MG)
+
+**Stack inicial recomendado:**
+- ✅ Skill 1 (auditoria) — já feita, identificou H1 truncado, imagens cross-domain, subdomínios mortos, zero schema, one-page
+- 🔥 Skill 2 (schema) — prioridade #1, JSON-LD pronto entregue
+- 🔥 Skill 3 (GBP) — prioridade #2, otimizar perfil
+- 🔥 Skill 6 (CWV) — prioridade #3, corrigir performance
+- 📌 Skill 7 (topical authority) — mês 2: pillar "aluguel de equipamentos"
+- 📌 Skill 4 (Service Area Pages) — mês 2: páginas de Contagem, BH, Betim, Ibirité
+- 📌 Skill 11 (citations) — mês 2: Apontador, GuiaMais, B2Brazil
+- 📌 Skill 9 (reviews) — mês 3: ativar sistema com ZARK Chat
+
+**Pacote sugerido:** "SEO Local Setup" + "SEO Local Recorrente"
+
+### Gerais Desentupidora e Dedetizadora (Contagem-MG, atende RMBH)
+
+**Stack inicial recomendado:**
+- 🔥 Skill 1 (auditoria) — primeira ação
+- 🔥 Skill 4 (Service Area Pages) — **maior alavanca** desse nicho — 8-10 páginas de cidade/bairro
+- 🔥 Skill 9 (reviews) — desentupidora vive de review; sistema ZARK Chat com filtro NPS
+- 🔥 Skill 3 (GBP) — categoria primária "Serviço de desentupimento"
+- 📌 Skill 2 (schema) — `Plumber` com `additionalType` apontando pra "Pest control"
+- 📌 Skill 7 + 8 (conteúdo) — pillar "desentupimento" + clusters de "como evitar entupimento [bairro]"
+- 📌 Skill 11 (citations) — GetNinjas, Habitissimo, Triider são setoriais críticos
+
+**Pacote sugerido:** "SEO Local Recorrente" agressivo (volume de conteúdo + reviews)
+
+### VIPSeg (segurança eletrônica, CFTV, Contagem-MG)
+
+**Stack inicial recomendado:**
+- 🔥 Skill 1 (auditoria)
+- 🔥 Skill 3 (GBP) — categoria "Empresa de segurança", múltiplas secundárias
+- 📌 Skill 7 + 8 (conteúdo) — comparativos (IP vs analógica, Intelbras vs Hikvision) — alta intenção comercial
+- 📌 Skill 4 (Service Area Pages) — instalação CFTV em Contagem, BH, Betim
+- 📌 Skill 2 (schema) — `SecuritySystemInstaller`
+- 📌 Skill 11 (citations) — LinkedIn Company Page importante (B2B forte)
+- 📌 Skill 9 (reviews) — B2B reviews valem ouro (síndicos, gerentes de loja)
+
+**Diferencial:** considerar canal YouTube (vídeos demonstrativos rankeiam forte no nicho)
+
+**Pacote sugerido:** "Site Novo SEO-Ready" + "SEO Local Recorrente"
+
+### VIPCar (proteção veicular, Contagem-MG)
+
+**Stack inicial recomendado:**
+- 🔥 Skill 1 (auditoria) — nicho YMYL, escrutínio Google alto
+- 🔥 Skill 7 + 8 (conteúdo E-E-A-T) — proteção veicular tem desconfiança natural; conteúdo de transparência é prioridade
+- 🔥 Skill 9 (reviews) — pedir review pós-sinistro resolvido com sucesso (NPS alto naquele momento)
+- 📌 Skill 3 (GBP) — categoria "Associação" ou "Empresa de seguros" (cuidado com SUSEP)
+- 📌 Skill 2 (schema) — `Organization` + `Person` (gestores) pra E-E-A-T
+- 📌 Skill 11 (citations) — Reclame Aqui é CRÍTICO (RA1000 ideal)
+- 📌 Skill 12 (GEO) — mais difícil pelo nicho YMYL (12-18 meses pra menção em LLM)
+
+**Alerta especial:** monitoramento contínuo de reputação online (Reclame Aqui, redes sociais)
+
+**Pacote sugerido:** "ZARK Premium Full" (mercado exige tudo bem feito)
+
+---
+
+## 🔄 Manutenção do próprio stack
+
+SEO/GEO mudam rápido. Pra manter as skills atualizadas:
+
+### Trimestral (a cada 90 dias)
+
+- [ ] Validar que diretórios em `citations-builder-br` ainda existem e operam
+- [ ] Atualizar lista de plugins recomendados em `core-web-vitals-fixer`
+- [ ] Revisar mensagens de pedido de review em `review-acquisition-engine` (frescor)
+- [ ] Re-medir BMR/SOV em `geo-llm-optimizer` (LLMs mudam fontes)
+
+### Semestral (a cada 180 dias)
+
+- [ ] Revisar Catálogo de Tipos por Nicho em `schema-jsonld-builder` (schema.org evolui)
+- [ ] Revisar lista negra em `seo-content-writer-br` (LLMs mudam tiques)
+- [ ] Atualizar templates em `meta-tags-optimizer` se Google mudou limites
+- [ ] Revisar mapas canônicos em `topical-authority-architect`
+
+### Anual
+
+- [ ] Auditoria completa de TODAS as skills
+- [ ] Validar se alguma skill ficou redundante
+- [ ] Considerar criar 13ª, 14ª skill se identificou gap recorrente
+- [ ] Atualizar pacotes comerciais conforme realidade de mercado
+
+---
+
+## 🆘 Troubleshooting comum
+
+### Claude Code não está acionando uma skill
+
+**Causa provável 1:** descrição não tem triggers suficientes
+**Solução:** abrir SKILL.md, verificar que descrição lista variações de pedido em PT-BR (e.g. "auditar SEO", "analisar Google Meu Negócio", etc.)
+
+**Causa provável 2:** YAML frontmatter mal formatado
+**Solução:** garantir 3 traços antes e depois, sem espaço entre `---` e o conteúdo, indentação correta
+
+**Causa provável 3:** Claude Code não enxerga a pasta `.claude/skills/`
+**Solução:** verificar caminho relativo ao projeto, reiniciar Claude Code
+
+### Skill aciona, mas output não segue padrão ZARK
+
+**Causa provável:** Claude Code não está lendo SKILL.md inteiro (truncamento)
+**Solução:** validar que SKILL.md tem menos de ~600 linhas; se passar, considerar refatorar em sub-skills ou usar bundled resources
+
+### Output da skill é genérico demais
+
+**Causa provável:** principios não-negociáveis não foram respeitados
+**Solução:** reler a skill — provavelmente os princípios estão lá mas Claude Code priorizou contexto da conversa. Reforçar invocação: "Aplica todos os princípios da skill `[nome]` rigorosamente"
+
+### Skill X conflita com Skill Y
+
+**Causa improvável** porque skills foram desenhadas pra se compor. Se acontecer:
+- Verificar se acionamento foi correto (Lookup table acima)
+- Skill mais específica vence skill mais genérica
+- Em caso de dúvida, acionar skill 1 (`seo-local-auditor`) primeiro pra contextualizar
+
+---
+
+## 📊 Métricas de sucesso do stack
+
+Como medir se o stack está funcionando bem na ZARK:
+
+### Métricas operacionais (ZARK interna)
+
+- Tempo médio de auditoria de cliente novo: **< 2h** (era 4-6h sem skill)
+- Tempo médio de criação de página de serviço: **< 1h** (era 3-4h sem skill)
+- Tempo médio de produção de blog post 2.000 palavras: **< 1h** (era 3-5h sem skill)
+- Consistência de output entre membros da equipe: **alta** (skills padronizam)
+
+### Métricas de cliente
+
+- Tempo até primeiro top 3 em keyword principal: **60-120 dias** (depende do nicho)
+- Crescimento de tráfego orgânico em 6 meses: **2-5x** (PME que parte do zero)
+- Taxa de aquisição de reviews: **> 5% dos pedidos automatizados**
+- BMR (Brand Mention Rate em LLMs) em 12 meses: **20-40%**
+
+### Métricas comerciais
+
+- Diferença de fechamento com pacote ZARK vs concorrência: **+30-50%**
+- Retenção mensal de clientes recorrentes: **> 90%**
+- Upsell de Local SEO pra GEO: **> 30% dos clientes existentes**
+
+---
+
+## 🚧 Próximas skills a considerar (roadmap)
+
+Skills que podem ser criadas no futuro pra completar o stack:
+
+### Skill 13 — `local-seo-monthly-reporting`
+Geração automatizada de relatório mensal padronizado ZARK (combinando dados de auditoria + GBP + reviews + ranking + GEO em docx único). Encaixa direto no padrão `relatorio-cliente-zark` que ZARK já tem.
+
+### Skill 14 — `serp-feature-optimizer`
+Otimização específica pra rich results: featured snippet, People Also Ask, Knowledge Panel, vídeo carousel.
+
+### Skill 15 — `youtube-seo-optimizer`
+Otimização para canal YouTube + integração com SEO do site (transcrições, embeds estratégicos).
+
+### Skill 16 — `ecommerce-seo-br`
+Estratégia específica de SEO pra e-commerces brasileiros (categorias, produtos, sazonalidade, integração Mercado Livre/Shopee).
+
+### Skill 17 — `local-pack-tracker`
+Monitoramento de heatmap de ranking por bairro (integração com Local Falcon, GeoRanker, BrightLocal).
+
+---
+
+## 🤝 Como contribuir / evoluir o stack
+
+ZARK opera as skills em produção. Cada uso real é oportunidade de melhorar:
+
+1. **Identificar fricção:** se uma skill exige X perguntas extras frequentemente, talvez a Etapa 1 dela esteja incompleta
+2. **Identificar gaps:** se cliente pergunta algo que nenhuma skill cobre, é candidato a nova skill
+3. **Identificar redundância:** se duas skills entregam coisas similares, considerar fundir
+4. **Identificar atualização:** mercado mudou? Algoritmo Google mudou? Skill precisa refresh
+
+**Padrão de versionamento sugerido:**
+- Versão major (2.0.0): mudança estrutural na skill (nova etapa, refatoração)
+- Versão minor (1.X.0): adição de templates, edge cases, ou catálogos
+- Versão patch (1.0.X): correções, atualizações de URLs, refresh de listas
+
+**Onde armazenar versionamento:**
+- Adicionar comentário no início de cada SKILL.md: `<!-- v1.2.0 - última atualização: 2026-XX-XX -->`
+- Manter changelog separado (ex: `CHANGELOG.md` na pasta da skill)
+
+---
+
+## 📞 Contato
+
+**ZARK LTDA**
+Contagem-MG | www.zark.co.com | @zark.co
+
+Skills desenvolvidas em maio de 2026.
+
+---
+
+> "O comum nunca construiu impérios."