programmatic-seo

Visión general de la skill programmatic-seo

Qué hace la skill programmatic-seo

La skill programmatic-seo te ayuda a planificar páginas SEO a escala mediante plantillas, datos estructurados y patrones de página repetibles. Está pensada para casos como páginas por ubicación, páginas comparativas, páginas de integraciones, páginas por sector, directorios, glosarios y otros sistemas SEO de “muchas páginas”, donde un prompt genérico suele infravalorar el riesgo de contenido thin.

Quién debería usar esta skill

Esta skill de programmatic-seo encaja mejor para:

• marketers que planean desde decenas hasta miles de landing pages
• founders que quieren validar si merece la pena construir una estrategia de pSEO
• equipos de SEO/contenidos que están decidiendo tipos de página y patrones de URL
• equipos product-led con datos estructurados, integraciones, ejemplos o activos propios

Tiene menos utilidad si solo necesitas unos pocos artículos editoriales o un calendario de contenidos general.

El trabajo real que resuelve

La mayoría de usuarios no quieren simplemente “100 páginas SEO”. Antes necesitan responder preguntas más difíciles:

• qué patrón de página es realmente viable
• qué hace que cada página sea lo bastante distinta como para posicionar
• qué datos o activos hacen falta antes de construir
• cómo evitar publicar una gran huella de contenido thin
• cómo conectar las plantillas de página con objetivos de negocio y enlazado interno

Ahí es donde programmatic-seo aporta más valor que un prompt normal de brainstorming.

Qué diferencia a esta skill

El repositorio pone el foco desde el principio en dos ideas clave para decidir bien: cada página necesita un valor único real, y los datos o la utilidad propios suelen rendir mejor que las plantillas que solo sustituyen keywords. Además, incluye playbooks concretos de pSEO en references/playbooks.md, algo mucho más útil que un marco vago del tipo “crear páginas escalables”.

Cuándo no usar programmatic-seo

No uses programmatic-seo si:

• tu objetivo principal es auditar problemas SEO existentes
• necesitas una estrategia de blog top-of-funnel en lugar de páginas con plantilla
• tu única diferenciación consiste en cambiar el nombre de una ciudad, sector o competidor sin una diferencia real de contenido
• no tienes inputs estructurados, ni utilidad de producto, ni una forma creíble de hacer que las páginas sean distintas

Cómo usar la skill programmatic-seo

Instalar la skill programmatic-seo

Instálala desde el repositorio con:

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

Después, úsala dentro de tu flujo de trabajo con IA cuando la tarea trate claramente de construir sistemas de páginas SEO repetibles, no artículos puntuales.

Lee primero estos archivos

Para esta guía de programmatic-seo, el orden de lectura con más valor es:

1. skills/programmatic-seo/SKILL.md
2. skills/programmatic-seo/references/playbooks.md
3. skills/programmatic-seo/evals/evals.json

Por qué este orden:

• SKILL.md ofrece los principios de trabajo y el flujo de evaluación
• references/playbooks.md te ayuda a encajar el tipo de página correcto con los activos de tu negocio
• evals/evals.json muestra qué se espera que incluyan las buenas respuestas

Empieza por el contexto de producto antes de escribir el prompt

La skill indica explícitamente que primero revises .agents/product-marketing-context.md o .claude/product-marketing-context.md. Esto importa porque los buenos planes de pSEO dependen del producto, la audiencia, el objetivo de conversión y el posicionamiento actual. Si ese archivo existe, haz que el modelo lo lea antes de plantear preguntas de estrategia.

Ten claro qué inputs necesita la skill

La calidad de tu uso de programmatic-seo depende mucho de los inputs que aportes. Incluye:

• descripción del producto o servicio
• cliente objetivo e intención
• objetivo de conversión de las páginas
• patrón de keywords candidato
• volumen estimado de páginas
• qué datos estructurados ya tienes
• qué datos propios, ejemplos o funcionalidades del producto pueden hacer útiles las páginas
• quién posiciona ahora y por qué es difícil superarlo

Sin esto, la respuesta se quedará en un nivel demasiado general.

Convierte una idea difusa en un prompt sólido

Prompt débil:

• “Help us do programmatic SEO for our SaaS.”

Prompt mejor:

• “We sell CRM software for SMBs. We are considering CRM for [industry] pages for 40 industries. Our goal is demo bookings. We have customer examples, industry workflow templates, and benchmark data for 12 industries. Competitors rank mostly with generic copy. Help us assess whether this programmatic-seo idea is viable, which playbook it fits, what makes each page genuinely unique, what template sections we need, and what pages should not be published until we have stronger data.”

Ese prompt mejor da a la skill información suficiente para evaluar el encaje, no solo para generar entusiasmo.

Encaja tu idea en un playbook

Una ventaja práctica de esta skill de programmatic-seo es su enfoque por playbooks. Según references/playbooks.md, los patrones habituales incluyen:

• templates
• curation
• comparisons
• examples
• locations
• personas
• integrations
• glossary
• translations
• directory
• profiles

Esto importa porque “programmatic SEO” por sí solo es demasiado amplio. CRM for healthcare requiere una construcción distinta a Notion vs Asana, y distinta también de páginas /integrations/[tool]/. El playbook determina los requisitos de datos, la estructura de la plantilla y el umbral de calidad.

Usa la skill programmatic-seo para poner a prueba la unicidad

El hábito de uso más importante: pídele a la skill que explique por qué cada página merece existir por separado. Los buenos prompts piden:

• ideas de secciones únicas por tipo de página
• oportunidades de datos propios
• utilidad específica del producto
• elementos de página que cambian de forma material entre variantes
• motivos para aplicar noindex, fusionar o evitar combinaciones de poco valor

Si la respuesta se basa sobre todo en intercambiar variables en los headings, para ahí. Ese es el principal riesgo de adopción que esta skill ayuda a sacar a la luz.

Pide un plan de implementación, no solo ideas de páginas

Un buen prompt para una programmatic-seo guide debería pedir:

• evaluación de la oportunidad
• plantilla y modelo de datos
• estructura de URL
• enfoque de enlazado interno
• criterios de indexación
• ubicación de elementos de conversión
• orden de despliegue
• controles de calidad

Así orientas la skill hacia un plan ejecutable y no hacia una simple lista de keywords.

Usa los evals para calibrar tus expectativas

Los ejemplos de evaluación muestran qué considera la skill una salida completa. Por ejemplo, en páginas comparativas y de tipo persona deberían aparecer:

• identificación del playbook
• requisitos de valor único
• oportunidades de insights o datos propios
• guía de diseño de plantilla
• estrategia de enlazado interno
• advertencias sobre contenido thin

Si tu respuesta no incluye esto, probablemente tu prompt necesita más especificidad.

Un flujo práctico de programmatic-seo para SEO Content

Sigue esta secuencia:

1. confirma el objetivo de negocio y el evento de conversión
2. identifica el playbook más probable
3. estima el inventario de páginas y el patrón de búsqueda
4. define qué datos hacen que las páginas sean realmente distintas
5. diseña la plantilla en torno a la utilidad, no solo a las keywords
6. decide qué páginas cumplen los requisitos para indexarse
7. crea enlaces internos desde páginas core y entre variantes
8. lanza primero un conjunto más pequeño y de alta calidad antes de escalar

Este flujo es especialmente útil para equipos de programmatic-seo for SEO Content que sienten la tentación de publicarlo todo de golpe.

FAQ de la skill programmatic-seo

¿Esta skill de programmatic-seo sirve para principiantes?

Sí, siempre que ya entiendas conceptos básicos de SEO como intención de búsqueda, plantillas y enlazado interno. La skill resulta práctica porque presenta el pSEO como un conjunto de playbooks y restricciones, no como una táctica abstracta de crecimiento. Los principiantes absolutos pueden seguir necesitando ayuda aparte con keyword research y fundamentos de SEO técnico.

¿En qué se diferencia programmatic-seo de un prompt SEO normal?

Un prompt normal suele producir ideas de páginas genéricas. Esta skill de programmatic-seo es más útil cuando necesitas:

• una comprobación de encaje antes de construir
• alertas sobre riesgo de contenido thin
• orientación sobre cómo lograr unicidad a escala
• un playbook alineado con tu modelo de negocio
• una estructura de despliegue repetible

Eso da más confianza para decidir la instalación y reduce los lanzamientos de páginas equivocadas.

¿Qué tipos de negocio encajan mejor?

Mejor encaje:

• SaaS con integraciones, comparativas, templates o casos de uso por vertical
• marketplaces y directorios
• productos con inventarios o perfiles estructurados
• empresas con datasets propios, benchmarks, ejemplos o contenido generado por usuarios

Encaje más débil:

• negocios con pocos datos y sin diferenciación a nivel de página
• equipos que esperan que el pSEO compense por sí solo una débil relevancia producto-mercado

¿La skill ayuda a generar las páginas en sí?

Sobre todo ayuda con estrategia, estructura y toma de decisiones, más que con la producción masiva de páginas finales. Puedes usar su salida para diseñar plantillas y después alimentar un flujo separado de generación, pero el valor real está en decidir qué debería existir y qué nivel de calidad debe cumplir cada página.

¿Cuándo no debería usar programmatic-seo?

Sáltatela cuando:

• necesites una estrategia de content marketing para posts de blog
• quieras una auditoría de SEO técnico
• tu sitio solo necesite unas pocas landing pages escritas a mano
• no puedas aportar inputs significativos por página más allá de una variable

¿El repositorio incluye material de apoyo?

Sí. El recurso de apoyo más útil es references/playbooks.md, que relaciona 12 patrones de pSEO con requisitos de valor y estructuras de URL. También merece la pena leer evals/evals.json, porque deja ver el nivel de razonamiento esperado en prompts reales.

Cómo mejorar la skill programmatic-seo

Da a la skill inputs de negocio más sólidos

La forma más rápida de mejorar los resultados de programmatic-seo es aportar contexto de negocio desde el inicio:

• modelo de ingresos
• segmento de audiencia
• acción objetivo
• autoridad existente
• datos estructurados disponibles
• funcionalidades del producto que puedan personalizar cada página

La skill funciona mucho mejor cuando puede vincular las páginas con conversión y diferenciación.

Pídele que descarte malas ideas

No preguntes solo “How do we do this?” También pregunta:

• “Which page variants should we avoid?”
• “What pages would be thin?”
• “What data gaps block launch?”
• “What would make this strategy non-viable?”

Así la skill de programmatic-seo resulta más útil para decidir y evita una falsa sensación de seguridad.

Aporta filas de muestra de tu dataset

Si ya tienes una hoja de cálculo, un directorio, un inventario o una lista de competidores, incluye entre 5 y 10 filas de muestra. Eso ayuda a la skill a:

• detectar campos débiles
• identificar atributos aptos para plantilla
• proponer mejores secciones de página
• estimar si las páginas se sentirán realmente diferentes entre sí

Las filas concretas superan casi siempre a las descripciones abstractas.

Pide secciones de plantilla con una función clara

En lugar de pedir “write a page template”, pide secciones alineadas con necesidades del usuario, como:

• qué ayuda a hacer esta página al usuario
• qué cambia en esta variante
• datos de prueba o benchmark
• explicación del encaje del producto
• comparación o ayuda para decidir
• CTA vinculado a la intención de la página

Esto mejora la utilidad de la página y reduce el texto de relleno.

Vigila los principales modos de fallo

Errores habituales de pSEO que la skill está diseñada para detectar:

• páginas con variables intercambiadas pero sin valor nuevo
• publicar demasiadas combinaciones con poca señal
• ignorar el enlazado interno
• usar un playbook que no encaja con tus activos
• asumir que el volumen de búsqueda por sí solo justifica construir
• no tener una ruta clara de conversión desde la página hasta el producto

Si la respuesta no aborda estos puntos, refina el prompt.

Itera después del primer borrador estratégico

Después de la primera respuesta, lanza preguntas de seguimiento como:

• “Score these 30 page ideas by value and uniqueness.”
• “Which 10 should launch first?”
• “What data fields are mandatory before publishing?”
• “Show a high-quality template for one example page.”
• “What internal links should connect these pages to core commercial pages?”

Suele ser en ese punto cuando la skill de programmatic-seo pasa a ser claramente mejor que un prompt de una sola pasada.

Combina programmatic-seo con skills adyacentes con criterio

El propio repositorio deriva a los usuarios a otras herramientas para otros trabajos. Usa programmatic-seo para sistemas de páginas escalables y después cambia de herramienta o skill para:

• auditorías SEO
• estrategia de contenidos más amplia
• pulido del copy de página
• implementación técnica

Esa división mantiene la skill de programmatic-seo centrada en lo que mejor hace: decidir si un sistema de pSEO debería existir y cómo estructurarlo bien.