programmatic-seo

Visão geral

O que a skill programmatic-seo faz

A skill programmatic-seo ajuda você a desenhar páginas otimizadas para SEO em escala usando templates e dados estruturados. Em vez de escrever cada página manualmente, você usa esta skill para planejar tipos de página repetíveis — como páginas "[keyword] + [city]", landing pages focadas em setores, páginas de comparação, páginas de integração, diretórios e páginas de perfil — mantendo valor único em cada página.

A skill é focada em estratégia e estrutura, não em redigir texto ou fazer deploy de código. Ela orienta você a:

• Identificar oportunidades viáveis de SEO programático
• Escolher o playbook certo (templates, locations, comparisons, integrations, directories, etc.)
• Definir requisitos de dados para que cada página tenha valor real, e não seja conteúdo raso
• Planejar a estrutura de URLs, links internos e indexação
• Evitar conteúdo duplicado ou quase duplicado que tem baixo desempenho em busca

Para quem é esta skill

Use a skill programmatic-seo se você é:

• Especialista em SEO ou growth marketer planejando lançar centenas ou milhares de landing pages para um produto ou marketplace
• Profissional de marketing de conteúdo ou de produto que quer conteúdo escalável e focado em conversão (por exemplo, páginas "CRM para [industry]", hubs "melhores [category]" ou diretórios de integrações)
• Founder ou parte de um time de produto explorando SEO programático para geração de leads sem contratar um time grande de conteúdo

Se você precisa apenas de estratégia de SEO em alto nível ou de um plano de conteúdo geral, comece com seo-audit ou content-strategy. Use programmatic-seo quando você quer especificamente landing pages em escala baseadas em templates e dados.

Problemas que a skill programmatic-seo resolve

Esta skill foi criada para atacar os desafios clássicos do SEO programático:

• Risco de conteúdo raso – Ela força você a definir valor único por página, para não apenas trocar o nome da cidade ou setor em um template.
• O que deveríamos construir? – Ela usa playbooks de SEO programático já testados (templates, locations, comparisons, personas, integrations, directories, profiles etc.) de references/playbooks.md para casar padrões com os seus ativos e audiência.
• Como estruturamos todas essas URLs e links? – Ela incentiva padrões limpos de URL (como /templates/[type]/, /best/[category]/ ou /locations/[city]/) e uma estratégia de links internos.
• Quais dados realmente precisamos? – Ela ajuda a identificar dados proprietários ou curados que tornem cada página realmente útil.

Se o seu principal objetivo é simplesmente gerar texto automaticamente sem estratégia ou dados únicos, esta skill não é adequada; ela foi feita para priorizar qualidade e utilidade, não volume.

Conceitos principais e estrutura do repositório

Dentro do diretório da skill programmatic-seo, você encontrará:

• SKILL.md – O playbook central, incluindo:
  • Perguntas de avaliação inicial (negócio, público, objetivos de conversão)
  • Prompts para análise de oportunidade e concorrência
  • Princípios centrais como valor único por página e dados proprietários
• references/playbooks.md – "The 12 Programmatic SEO Playbooks" com padrões reais, como:
  • Templates (por exemplo, resume templates, invoice templates)
  • Curation (por exemplo, "best [category]")
  • Comparisons (por exemplo, "Notion vs Asana")
  • Locations, Personas, Integrations, Directory, Profiles e mais
• evals/evals.json – Prompts de exemplo e comportamentos esperados que mostram como a skill deve responder em cenários comuns (por exemplo, páginas de CRM para [industry], páginas de comparação para vários concorrentes).

Entender esses arquivos ajuda você a decidir rapidamente se esta skill combina com seus objetivos de SEO programático.

Como usar

Instalação e configuração

1. Instale a skill programmatic-seo

Para adicionar esta skill ao ambiente do seu agent, execute:

npx skills add https://github.com/coreyhaines31/marketingskills --skill programmatic-seo

Isso traz a configuração de programmatic-seo e os arquivos de referência de suporte do repositório coreyhaines31/marketingskills para o seu setup de skills.

2. Revise os arquivos centrais de orientação

Depois de instalar, abra primeiro estes arquivos para entender como a skill funciona:

• SKILL.md – Leia de ponta a ponta. Ele define o papel do agent como especialista em SEO programático e descreve:
  • Como checar o contexto de marketing de produto
  • Como avaliar oportunidades de negócio e de busca
  • Princípios para evitar conteúdo raso
• references/playbooks.md – Passe pelos 12 playbooks de SEO programático e anote quais padrões combinam com o seu negócio (templates, curation, locations, personas, comparisons, integrations, glossary, directory, profiles etc.).
• evals/evals.json – Revise os prompts de exemplo (por exemplo, páginas "CRM for [industry]", páginas de comparação para vários concorrentes) para ver como a skill deve raciocinar e responder.

Se o seu repositório inclui .agents/product-marketing-context.md (ou .claude/product-marketing-context.md em setups mais antigos), confira se está preciso e atualizado; a skill procura esse arquivo primeiro para embasar as recomendações.

Executando programmatic-seo em um novo projeto

1. Junte o contexto de produto e audiência

Antes de pedir ao seu agent para desenhar uma estratégia de SEO programático, prepare:

• Uma descrição curta do seu produto/serviço
• Seus principais públicos-alvo ou segmentos
• Os objetivos de conversão principais (cadastros em trial, pedidos de demo, compras, newsletter etc.)

A skill vai usar essas informações — como descrito em SKILL.md — para evitar templates genéricos de página e, em vez disso, adaptar as ideias ao seu funil real.

2. Defina a oportunidade de SEO programático

Ative a skill quando você tiver um padrão escalável claro, como:

• "Queremos páginas 'CRM for [industry]' para 20 setores."
• "Queremos páginas de comparação '[Our product] vs [Competitor]' para 15 concorrentes."
• "Queremos um diretório de '[service] providers in [city]'."
• "Queremos páginas de template como 'invoice template', 'quote template' etc."

A skill vai:

• Identificar a qual playbook isso se encaixa (por exemplo, Personas, Comparisons, Locations, Templates, Directory)
• Pedir qualquer contexto que estiver faltando
• Propor um plano estruturado: padrões de keywords, requisitos de dados, seções do template, links internos e abordagem de indexação

3. Escolha e refine seu playbook

Usando references/playbooks.md, a skill pode:

• Selecionar um ou mais playbooks que combinem com sua ideia
• Explicar por que um padrão específico funciona para o seu nicho
• Detalhar requisitos de valor (por exemplo, para Templates: downloads realmente utilizáveis, múltiplas variações, alta qualidade; para Curation: critérios claros de avaliação e atualizações regulares)

Você pode então refinar a direção, por exemplo:

• Sair de apenas "Locations" para uma combinação de Locations + Directory (por exemplo, um diretório de provedores por cidade)
• Combinar Comparisons + Conversions (por exemplo, páginas de comparação que também gerem trials com CTAs fortes)

4. Planeje dados e estrutura de conteúdo

Um objetivo central em programmatic-seo é valor único por página. Na prática, isso significa que a skill vai ajudar você a:

• Listar os pontos de dados que precisa coletar ou gerar para cada página (por exemplo, dores específicas por setor, estatísticas por cidade, uso de features do produto por vertical)
• Mapear esses dados nas seções do template (hero, prova, tabelas de comparação, FAQs, detalhes locais ou específicos do segmento)
• Decidir onde dados proprietários, exemplos reais ou insights curados devem aparecer, para que as páginas não sejam apenas texto genérico com troca de keyword

É aqui que a skill é especialmente útil para decisões de instalação: ela ajuda você a enxergar se tem dados estruturados suficientes para fazer SEO programático valer a pena.

5. Defina a estratégia de URL e links internos

Com base nos exemplos em references/playbooks.md, a skill pode sugerir:

• Estruturas de URL como:
  • /templates/[type]/ ou /templates/[category]/[type]/
  • /best/[category]/
  • /locations/[city]/
  • /integrations/[tool]/
• Padrões de linkagem interna, como:
  • De cada página de setor para um hub central de "Industries"
  • De páginas de comparação para as páginas principais de produto e pricing
  • De entradas de diretório de volta para páginas de cidade e vice-versa

Este planejamento é crucial antes de construir qualquer coisa, já que reestruturar conjuntos grandes de URLs depois sai caro.

6. Valide usando os cenários de eval

Use os exemplos em evals/evals.json como checklist:

• Você está checando se existe contexto de marketing de produto?
• Está aplicando os princípios centrais (valor único, dados proprietários, URLs limpas)?
• Está planejando pesquisa de keywords e coleta de dados por variação?
• Está incluindo uma estratégia de links internos e alertas sobre conteúdo raso?

Se o seu plano falharia nesses evals, revise seu modelo de dados ou reduza o escopo até que cada página realmente se sustente sozinha.

Quando esta skill é ou não é uma boa escolha

Use a skill programmatic-seo quando:

• Você tem um tipo de página repetível que pode escalar em muitas variações (locations, industries, integrations, use cases, templates, profiles etc.)
• Você consegue acessar ou criar dados estruturados que tornem cada variação significativamente diferente
• Você quer um blueprint estratégico para landing pages de alta intenção e foco em conversão

Ela pode não ser uma boa escolha quando:

• Você precisa apenas de algumas landing pages pontuais (uma skill geral de landing page ou trabalho manual de conteúdo resolve)
• Você não tem dados nem um ângulo para criar valor único e só quer "IA gerando 1.000 páginas" — a skill foi desenhada explicitamente para alertar contra isso
• Sua principal necessidade é auditoria técnica de SEO ou questões de site como um todo (use seo-audit nesse caso)

FAQ

Qual é o principal objetivo da skill programmatic-seo?

A skill programmatic-seo foi construída para ajudar você a planejar e estruturar projetos de SEO programático — grandes conjuntos de landing pages baseadas em templates e dados, capazes de ranquear e converter — minimizando o risco de conteúdo raso e de baixo valor. Ela foca em estratégia, desenho de dados e estrutura de página, não em publicar páginas automaticamente.

Como instalo a skill programmatic-seo?

Instale via Skills CLI:

npx skills add https://github.com/coreyhaines31/marketingskills --skill programmatic-seo

Depois, revise SKILL.md, references/playbooks.md e evals/evals.json dentro do diretório skills/programmatic-seo para entender como ela vai influenciar o comportamento do seu agent.

Que tipos de página posso desenhar com programmatic-seo?

Usando os playbooks em references/playbooks.md, a skill é indicada para padrões como:

• Templates (por exemplo, "invoice template", "resume template")
• Listas de curadoria (por exemplo, "best [category]", "top [number] [tools]")
• Comparisons (por exemplo, "[Product] vs [Competitor]")
• Locations (por exemplo, "[service] in [city]")
• Personas ou setores (por exemplo, "CRM for [industry]")
• Integrations (por exemplo, páginas "[Product] + [Tool]")
• Diretórios e perfis (por exemplo, marketplaces, diretórios de experts)

A skill ajuda você a escolher e combinar esses padrões de acordo com seu produto e seus dados.

Como essa skill ajuda a evitar conteúdo raso em SEO programático?

SKILL.md enfatiza que cada página precisa ter valor único, especialmente por meio de dados proprietários, exemplos reais ou curadoria significativa. A skill é avaliada (via evals/evals.json) em critérios como:

• Identificar requisitos de dados para diferenciar cada página
• Alertar contra simplesmente trocar uma keyword ou nome de cidade em um template
• Incentivar estruturas de URL e links internos limpas e com propósito

Se o seu plano não atender a esses padrões, a skill vai levar você a reduzir o escopo ou aprimorar seus dados antes de escalar.

Posso usar programmatic-seo em um site existente com muitas páginas de baixo desempenho?

Sim, mas a skill é mais orientada para desenhar ou redesenhar tipos de página estruturados do que para auditar questões técnicas. Você pode:

• Usá-la para repensar padrões existentes (por exemplo, páginas de localização ou de setor) usando os playbooks
• Redefinir templates e requisitos de dados para tornar cada página mais valiosa

Para problemas de crawl, indexação ou checagens gerais de saúde do site, combine com a skill seo-audit.

Em que a programmatic-seo é diferente de uma skill de content strategy geral?

content-strategy foca em planejamento editorial como um todo: temas, formatos e calendário de conteúdo. programmatic-seo foca especificamente em templates repetíveis baseados em dados (como diretórios, comparações e páginas de localização) e nos sistemas necessários para escalá-los. Use programmatic-seo quando sua pergunta principal é "Como desenhar centenas de landing pages de SEO que sejam realmente úteis?" e não "Sobre o que devemos blogar neste trimestre?".

O que preciso ter pronto antes de programmatic-seo ser útil?

Você extrai mais valor desta skill se já tiver:

• Um produto e público-alvo bem definidos
• Pelo menos um padrão de página repetível (por exemplo, setores, cidades, concorrentes, templates)
• Alguma forma de dado estruturado ou capacidade de coletá-lo (por exemplo, métricas internas, listings de marketplace, listas curadas ou pesquisas)

Se esses elementos estiverem faltando, você ainda pode instalar a skill e usá-la para identificar lacunas, mas provavelmente precisará de trabalho adicional antes de executar um projeto completo de SEO programático.