Communitygithub.com

hihol-labs/product-factory-os

Mejora la efectividad del SEO para productos, páginas de destino, documentación y contenido mediante auditorías técnicas de SEO, intención de búsqueda, metadatos, datos estructurados, brechas de contenido y bucles de medición. Útil para auditorías SEO, tráfico orgánico, indexación, sitemap, robots.txt, schema, canónico, meta tags, Search Console y trabajo de optimización de contenido.

¿Qué es product-factory-os?

Esta habilidad permite realizar auditorías SEO completas y priorizar mejoras de búsqueda orgánica para sitios web, productos, documentación y contenido. Está diseñada para plataformas como Claude Code, Cursor y Codex, y se integra con artefactos PFO existentes (MARKET_BRIEF.md, ICP.md, GO_TO_MARKET.md, entre otros) para alinear las recomendaciones SEO con la estrategia de mercado. El proceso incluye la inspección de capacidad de rastreo, metadatos de página, datos estructurados y experiencia de usuario renderizada, evitando siempre el uso de datos privados no autorizados. Además, genera artefactos documentados como SEO_AUDIT.md y SEO_GROWTH_GUARANTEE_GATE.md, priorizando cambios pequeños y medibles basados en evidencia de fuentes públicas o datos de análisis proporcionados por el usuario.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hihol-labs/product-factory-os/tree/HEAD/skills/seo

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

SEO

Usa esta habilidad cuando PFO necesite mejorar la efectividad de la búsqueda orgánica para un producto, página de destino, sitio de documentación, backlog de contenido o plan de lanzamiento.

Entradas

  • URL, ruta del repositorio, página, producto o conjunto de contenido a evaluar.
  • Mercado objetivo, geografía, idioma, ICP y consultas prioritarias cuando se conozcan.
  • Artefactos PFO existentes cuando estén presentes: MARKET_BRIEF.md, ICP.md, GO_TO_MARKET.md, CONTENT_BACKLOG.md, FUNNEL_MODEL.md, VALIDATION_PLAN.md, TEST_PLAN.md.
  • Datos de análisis, Search Console, rastreo o ranking solo cuando el usuario los proporcione o autorice el acceso a datos privados.

Proceso

  1. Leer los artefactos PFO actuales e identificar la superficie de búsqueda: páginas, documentos, categoría de producto, ICP, idioma y objetivo de conversión.
  2. Separar la investigación de dominio público de los datos privados. Nunca enviar secretos, estrategia no publicada, datos de clientes o análisis propietarios a herramientas externas.
  3. Si una URL activa o un sitio local está disponible, inspeccionar:
    • capacidad de rastreo e indexabilidad: códigos de estado, redirecciones, robots.txt, sitemap, etiquetas canónicas, noindex y URLs duplicadas.
    • metadatos de página: título, descripción, encabezados, vista previa de Open Graph/Twitter, idioma y estructura de URL.
    • datos estructurados: tipo de esquema, campos obligatorios, brechas de validación y elegibilidad para resultados de búsqueda.
    • UX renderizada: legibilidad móvil, bloqueos de rendimiento, enlaces internos, descubribilidad de contenido y ruta de conversión.
  4. Enrutar a través de /browser-check cuando la interfaz de usuario renderizada, la vista previa local, los proxies de Core Web Vitals o las comprobaciones visuales/móviles afecten al SEO.
  5. Enrutar a través de /market-scan cuando la intención de palabra clave, páginas de competidores, señales de demanda pública recientes u oportunidades de contenido requieran evidencia pública actualizada.
  6. Construir un backlog priorizado por impacto:
    • correcciones técnicas que desbloqueen el rastreo, la indexación, los fragmentos o la velocidad.
    • correcciones de contenido que coincidan con la intención de búsqueda y fortalezcan la cobertura de entidades/temas.
    • correcciones de enlaces internos y arquitectura de información.
    • tareas de medición para Search Console, análisis, envío de sitemap y seguimiento de experimentos.
  7. Actualizar documentos según sea necesario:
    • SEO_AUDIT.md: estado actual, hallazgos, prioridad, evidencia y verificación.
    • SEO_GROWTH_GUARANTEE_GATE.md: métrica base, métrica objetivo, fuente de medición, ventana de atribución, cambios implementados, factores de exclusión, decisión del resultado y siguiente iteración cuando se reclame o apunte al crecimiento SEO.
    • CONTENT_BACKLOG.md: candidatos de contenido según intención de búsqueda y briefs.
    • GO_TO_MARKET.md: supuestos del canal de adquisición orgánica.
    • VALIDATION_PLAN.md: experimentos SEO, métrica objetivo, línea base y regla de decisión.
    • .pfo/EXPERIMENT_PROGRAM.md: solo para un bucle de experimento SEO aprobado con métrica fija.

Formato de Salida

Devuelve:

SUPERFICIE SEO:
LÍMITE DE DATOS PÚBLICOS/PRIVADOS:
HALLAZGOS TÉCNICOS SEO:
BRECHAS DE CONTENIDO E INTENCIÓN:
DATOS ESTRUCTURADOS:
ENLACES INTERNOS:
MEDICIÓN:
PUERTA DE GARANTÍA DE CRECIMIENTO SEO:
BACKLOG PRIORIZADO:
IMPACTO EN ARTEFACTOS PFO:
PRÓXIMO PASO DE VALIDACIÓN:

Al redactar documentos, añade evidencia fechada en lugar de reemplazar la investigación previa realizada por el usuario, a menos que el usuario solicite explícitamente reescribir.

Autovalidación

Antes de la salida final, verifica:

  • La ruta, los efectos secundarios y los requisitos de confirmación coinciden con los metadatos.
  • Los artefactos requeridos o el resultado de solo lectura son explícitos.
  • Se indican la verificación, los bloqueadores y la siguiente ruta.

Reglas

  • No inventar rankings, volumen de búsqueda, datos de Search Console, puntuaciones de Lighthouse, resultados de rastreo, backlinks o evidencia de competidores.
  • Citar fuentes públicas cuando influyan en una recomendación.
  • Tratar las afirmaciones de ranking y tráfico como hipótesis a menos que estén respaldadas por análisis proporcionados o evidencia pública verificada.
  • No optimizar para tráfico vanidoso cuando el ICP, el objetivo de conversión o la métrica del embudo lo contradigan.
  • Preferir cambios SEO pequeños y medibles con una línea base y una regla de decisión en lugar de una rotación amplia de contenido.
  • No reclamar crecimiento SEO como verificado hasta que SEO_GROWTH_GUARANTEE_GATE.md tenga una métrica base concreta, métrica objetivo, fuente de medición, ventana de atribución, cambios implementados, factores de exclusión, decisión del resultado y siguiente iteración.
  • No escribir cambios en robots.txt, sitemap, canónico o esquema en producción a menos que el usuario haya solicitado la implementación; la salida predeterminada es una auditoría/backlog.

Skills relacionados