onboarding-cro

Descripción general

¿Qué es onboarding-cro?

La skill onboarding-cro es un sistema experto centrado en el onboarding posterior al registro y la activación de usuarios. Está diseñada para ayudarte a mejorar las primeras experiencias de producto, acortar el time-to-value y conseguir que más usuarios nuevos lleguen a su "aha moment" y adopten el hábito clave.

En lugar de ofrecer consejos genéricos de UX, onboarding-cro te guía a través de:

• Entender el contexto de tu producto y la definición de activación
• Auditar qué ocurre después del registro
• Identificar fricción en los flujos de onboarding y en los empty states
• Diseñar checklists y flujos que lleven rápido al usuario al valor
• Planificar experimentos y métricas para mejorar la activación de forma continua

Esta skill se sitúa en la intersección entre la optimización de landing pages, los wikis de onboarding y las auditorías de UX. Es especialmente útil cuando ya consigues registros, pero muy pocos usuarios nuevos completan la configuración o se convierten en usuarios activos.

¿Para quién es onboarding-cro?

Usa onboarding-cro si eres:

• Un growth o product marketer responsable de la activación de free trial o freemium
• Un product manager o UX designer que quiere mejorar la primera sesión de uso
• Un founder o solo builder que intenta convertir registros en usuarios retenidos
• Un desarrollador que quiere integrar un playbook de CRO reutilizable en un agente de IA o en herramientas internas

Es un buen encaje para productos SaaS, product-led growth, B2B y B2C donde la activación está claramente ligada a un conjunto pequeño de acciones clave (p. ej., crear el primer proyecto, invitar a un miembro del equipo, subir un archivo).

Problemas que esta skill ayuda a resolver

Instala y usa onboarding-cro cuando tengas problemas como:

• Usuarios que se registran pero nunca completan el onboarding
• Baja tasa de activación (pocos usuarios llegan al aha moment)
• Time-to-value lento (el valor principal oculto tras demasiados pasos)
• Primera experiencia de uso confusa y empty states poco claros
• Ausencia de un onboarding checklist o de un camino de éxito definido
• Falta de experimentos y métricas estructurados para el CRO de onboarding

Si necesitas optimizar el propio formulario de registro/signup, deberías mirar la skill signup-flow-cro. Para campañas de lifecycle y nurture después del onboarding, consulta la skill email-sequence.

Cuándo onboarding-cro no es una buena opción

Esta skill no está pensada para:

• Adquisición de tráfico top-of-funnel ni optimización de campañas de anuncios
• Experimentos de pricing page que no tengan relación con el onboarding
• Campañas de engagement a largo plazo más allá de las primeras sesiones
• Implementaciones técnicas profundas de analítica (configuración de herramientas de tracking, diseño de esquemas)

Aun así, puedes usar su estructura de experimentos y métricas como input para un flujo de trabajo separado de analytics o herramientas de email.

Cómo usarla

Instalación

Para añadir onboarding-cro a tu entorno de agente, instálala desde el repo marketingskills:

npx skills add https://github.com/coreyhaines31/marketingskills --skill onboarding-cro

Después de la instalación:

1. Abre skills/onboarding-cro/SKILL.md para entender el comportamiento y los supuestos de la skill.
2. Revisa el material de apoyo en:
   • evals/evals.json – prompts de ejemplo, razonamiento esperado y assertions
   • references/experiments.md – ideas detalladas de experimentos de onboarding y métricas

Intégrala en tu agente o flujo de trabajo según cómo tu plataforma cargue las skills desde SKILL.md y las carpetas asociadas.

Flujo de trabajo principal: del contexto a los experimentos

La skill onboarding-cro sigue un flujo de trabajo estructurado antes de recomendar cambios:

1. Cargar el contexto de product marketing

Si tu repo incluye un documento de contexto de product marketing, onboarding-cro está diseñada para usarlo primero:

• Busca .agents/product-marketing-context.md (o .claude/product-marketing-context.md en setups más antiguos)
• Lee este archivo para evitar volver a preguntar cosas que ya están cubiertas

Si no tienes este archivo, plantéate añadirlo. Incluye:

• Tipo de producto (B2B/B2C, SaaS, mobile, etc.)
• Audiencia objetivo y propuesta de valor principal
• Modelo de pricing y casos de uso principales

2. Definir la activación y el aha moment

A continuación, la skill te guía para definir qué significa una activación satisfactoria para tu producto, por ejemplo:

• Herramientas de proyectos: create first project
• Herramientas de diseño: upload a design, invite a teammate, leave a comment
• Herramientas de colaboración: create workspace, invite team, send first message

Definir bien la activación permite que la skill:

• Centre el flujo de onboarding en un conjunto pequeño de acciones clave
• Evalúe si el time-to-value es aceptable
• Sugiera una checklist de 3–7 pasos concretos alineados con la activación

3. Auditar el flujo actual posterior al registro

Onboarding-cro te ayuda a mapear qué ocurre justo después del registro:

• A qué página o pantalla llegan los usuarios
• Si ven una UI centrada en el producto, una configuración guiada o un tour orientado al valor
• Dónde se producen los drop-offs antes de las acciones de activación

Resultados habituales de la auditoría incluyen:

• Un funnel simplificado paso a paso desde el registro hasta la activación
• Identificación de pasos de alta fricción y momentos confusos
• Revisión de los empty states (p. ej., paneles de proyecto en blanco, inbox vacíos) como oportunidades de guía

4. Elegir un patrón de flujo de onboarding

Usando tu contexto, la skill recomienda un enfoque como:

• Product-first: mostrar de inmediato la UI principal con señales claras dentro del producto
• Guided setup: un wizard estructurado o checklist para configurar lo esencial
• Value-first: empezar con un ejemplo preconfigurado o datos demo para que los usuarios vean valor antes de hacer trabajo

Esta elección se basa en los patrones de evaluación de evals/evals.json, que enfatizan:

• Evaluación del time-to-value
• Patrones de checklist (3–7 items)
• Tratamiento de los empty states como superficies de guía

5. Diseñar un onboarding checklist enfocado

Basándose en las recomendaciones del repo, la skill impulsa una checklist concisa para dirigir la activación. Por ejemplo, una herramienta de diseño colaborativo podría usar:

1. Upload your first design
2. Invite at least one teammate
3. Leave or receive a comment

El patrón de checklist garantiza:

• No más de 3–7 pasos
• Cada paso claramente vinculado a la activación o a la configuración crítica
• Que las tareas opcionales no bloqueen las acciones del aha moment

6. Usar experimentos de references/experiments.md

El archivo references/experiments.md contiene una biblioteca completa de ideas de experimentos de onboarding, entre ellas:

• Flow simplification experiments – número de pasos requeridos, campos opcionales vs. obligatorios, opciones de skip
• Guided experience experiments – product tours, claridad de CTAs, guía dentro de la UI
• Personalization experiments – adaptar el onboarding por segmento o job-to-be-done
• Quick wins & engagement experiments – time-to-value más rápido, mecánicas de motivación, prompts de soporte
• Email & multi-channel experiments – drips de onboarding y bucles de feedback conectados al comportamiento en producto
• Re-engagement experiments – hacer que los usuarios estancados vuelvan y completen la configuración
• Technical & UX experiments – rendimiento, onboarding en mobile, accesibilidad

Onboarding-cro se apoya en estas ideas para recomendar:

• Tests A/B concretos
• Hipótesis vinculadas a puntos de fricción
• Priorización centrada en time-to-value y activación

7. Definir métricas y medición

La especificación de eval en evals/evals.json espera que la skill proponga métricas para cada recomendación, que normalmente incluyen:

• Tasa de activación (porcentaje de nuevos registros que completan las acciones de activación definidas)
• Time-to-value (tiempo desde el registro hasta la activación)
• Tasa de finalización y drop-off por paso
• Tasa de finalización de la checklist

Puedes conectar estas métricas a tus herramientas de analytics o BI; onboarding-cro te ayuda a especificar qué debes trackear y por qué.

Consejos prácticos de configuración

• Mantén actualizado el archivo de contexto de producto: cada vez que cambien tu ICP, propuesta de valor o pricing, actualiza .agents/product-marketing-context.md para que las recomendaciones de onboarding sigan alineadas.
• Empieza con una sola definición principal de activación: evita múltiples definiciones en conflicto dentro de un mismo ciclo de experimentación.
• Acota el alcance por segmento: si sirves a varios tipos de usuario, ejecuta onboarding-cro en un segmento principal cada vez.
• Combínala con signup-flow-cro: primero corrige la fricción importante en el registro; después usa onboarding-cro para optimizar lo que ocurre inmediatamente después.

Preguntas frecuentes (FAQ)

¿Qué hace exactamente onboarding-cro una vez instalada?

Onboarding-cro actúa como un estratega de onboarding estructurado dentro de tu ecosistema de agentes. Concretamente:

• Lee tu contexto de product marketing cuando está disponible
• Formula preguntas específicas sobre tu flujo de onboarding y definición de activación
• Audita tu recorrido actual posterior al registro y los empty states
• Propone un enfoque de onboarding (product-first, guided setup o value-first)
• Construye una checklist concisa y centrada en la activación
• Sugiere experimentos y métricas basados en los archivos references/experiments.md y evals/evals.json incluidos

¿En qué se diferencia onboarding-cro de signup-flow-cro?

• signup-flow-cro se centra en el funnel de registro: campos del formulario, número de pasos, conversión de visitante a cuenta creada.
• onboarding-cro empieza después del registro y se enfoca en la activación: primera experiencia de uso, checklists, empty states, time-to-value y retención temprana.

Usa ambas juntas si necesitas optimización end-to-end desde la landing page hasta el usuario activado.

¿Necesito un archivo de contexto de product marketing para que onboarding-cro funcione?

No, pero funciona mejor si lo tiene. La skill está diseñada para buscar:

• .agents/product-marketing-context.md
• O .claude/product-marketing-context.md en setups más antiguos

Si el archivo existe, onboarding-cro se apoyará en él y solo pedirá los detalles faltantes y específicos de la tarea. Sin él, tendrás que responder manualmente a más preguntas de contexto.

¿Puede onboarding-cro adaptarse a distintos tipos de producto (B2B vs. B2C, SaaS vs. mobile)?

Sí. Los patrones principales en SKILL.md, evals/evals.json y references/experiments.md son agnósticos al tipo de producto. La skill pregunta explícitamente por:

• Tipo de producto (B2B/B2C)
• Propuesta de valor principal
• Acciones clave de activación

Esto le permite adaptar su auditoría y sus sugerencias de experimentos a los retos concretos de onboarding y activación de tu producto.

¿Qué tipo de experimentos puedo esperar de onboarding-cro?

A partir de references/experiments.md, puedes esperar recomendaciones como:

• Cambiar empty states para mostrar plantillas o datos de ejemplo
• Ajustar el orden de los pasos para destacar antes las acciones de mayor valor
• Reducir campos obligatorios o pasos en la configuración inicial
• Añadir o refinar onboarding checklists con indicadores de progreso
• Testear product tours frente a guías ligeras dentro de la UI
• Disparar nudges de re-engagement para usuarios que se quedan a medio camino antes de la activación

Cada experimento va acompañado de una hipótesis clara y resultados medibles.

¿Cómo sé si onboarding-cro está funcionando?

Haz seguimiento de las métricas que la skill sugiere, habitualmente:

• Aumento de la tasa de activación en un periodo determinado
• Reducción de la mediana del time-to-value
• Mayores tasas de finalización de las onboarding checklists
• Mejor engagement en las primeras sesiones

Intenta ejecutar los experimentos de uno en uno siempre que sea posible, atribuye los cambios a iteraciones concretas y usa onboarding-cro para refinar tu siguiente ronda de tests.

¿Pueden los desarrolladores ampliar o adaptar onboarding-cro?

Sí. Como onboarding-cro está definida en SKILL.md con archivos de apoyo como evals/evals.json y references/experiments.md, los desarrolladores pueden:

• Hacer fork del repositorio coreyhaines31/marketingskills
• Ajustar prompts y assertions de evaluación para alinearlos con sus frameworks internos
• Añadir listas de experimentos o métricas específicas del producto
• Integrar la skill en flujos de trabajo más amplios (p. ej., dashboards de analytics, wikis internos de onboarding)

Esto convierte a onboarding-cro en un playbook reutilizable que puede evolucionar con tu producto y tu equipo.