La skill flow-audit responde una sola pregunta sobre un flow: ¿está listo para producción? Apunta tu herramienta de IA a un flow y esta leerá la configuración a través de la Adapty CLI, la comprobará con tu catálogo de productos y emitirá un veredicto, sin dejarte una lista que tengas que interpretar tú mismo.

Un flow puede superar todas las validaciones de publicación existentes y aun así no ser seguro para mostrárselo a los usuarios. Las comprobaciones de publicación del propio Flow & Paywall Builder y flows config validate se preguntan “¿es este documento correcto formalmente?” — ninguna de las dos pregunta “¿un usuario real podría quedarse bloqueado, o ver algo falso?” Un flow en estado publication_failed puede superar ambas comprobaciones; flow-audit es lo que detecta el resto.

Instalar el skill

flow-audit forma parte del plugin adapty-skills.

Para instalar el plugin, ejecuta en tu terminal:

npx adapty skills install

Reinicia tu agente para cargar los skills. Para otros métodos de instalación, consulta el README del plugin.

Claude Code no actualiza el plugin por sí solo. Para obtener nuevos skills a medida que se publican, en Claude Code ejecuta /plugin, abre Marketplaces, selecciona adapty y elige Enable auto-update. Para el comando de actualización en otros agentes, consulta el README del plugin.

Luego pregunta, por ejemplo, “Antes de publicar este flow, ¿me falta algo?” Indica el nombre del flow, o deja que liste tus flows y pregunta cuál quieres revisar.

Cómo funciona

Cinco fases, todas de solo lectura:

1. Resolución y autenticación. Confirma que la CLI es lo suficientemente reciente y que tu sesión de Adapty es válida.
2. Selección del flow. Lista tus flows (adapty flows list) y pregunta cuál quieres comprobar.
3. Obtención de datos. Descarga la configuración del flow y tu catálogo de productos — el snapshot contra el que se ejecutan todas las comprobaciones.
4. Ejecución de comprobaciones. Cada comprobación se ejecuta únicamente contra ese snapshot.
5. Informe. Un veredicto, no una lista.

Qué comprueba

• Disparadores: Un elemento cuyo texto promete una acción pero no tiene ninguna interacción en toda su cadena de ancestros. Se muestra exactamente igual que un control funcional y no hace nada.
• Cumplimiento de la store: Una acción de restauración accesible en algún punto del flow, un enlace a tus términos, un enlace a tu política de privacidad y una forma de que el usuario abandone un paywall sin comprar.
• Productos: Un producto vinculado que falta en tu catálogo, un producto sin vínculo a la store, una tarjeta que indica un período de facturación que el producto no tiene, o un precio fijo donde debería ir una variable de precio.
• Variables: Una variable que el flow define pero nunca lee, de modo que una pantalla recoge una respuesta que nada utiliza.
• Localización: Traducciones vacías, valores sin traducir y cobertura por idioma.
• Marcadores de posición: Texto que nunca se terminó — Lorem ipsum, TODO, Your headline here — y un flow que sigue llamándose Untitled.

Gravedad

Cada hallazgo recibe uno de tres niveles:

Nivel	Qué significa
Bloqueante	El flow no funcionará para un usuario real, o le mostrará algo falso — un precio inventado puede renderizarse perfectamente y aun así mentir.
Riesgo	Funciona, pero probablemente no es lo que nadie pretendía: textos de relleno, un valor idéntico al del locale predeterminado, una variable que nadie lee.
Pregunta	No es posible decidir con los datos disponibles. El informe indica qué vio, a qué no pudo acceder, y la única cosa que verificar — en lugar de adivinar.

Ejemplo de informe

Flow: Nimbus onboarding  ·  publication_failed
7 screens · 3 locales · 2 products

NOT READY FOR PRODUCTION — 2 blockers: no restore action, no way off the paywall

BLOCKERS

1. This row is dead text.
   scr_paywall / el_089T reads "Restore purchase · Terms · Privacy" and carries no
   interaction at all. It renders exactly like a working row, and none of the following work:
     · no restorePurchases action anywhere in the flow    → App Store 3.1.1
     · no link to terms/EULA                              → App Store 3.1.2
     · no link to a privacy policy                        → App Store 3.1.2

2. a user who does not buy cannot leave this screen: no closeFlow or navigateBack is
   reachable from it.

El estado de este flow es publication_failed, y tanto las comprobaciones de publicación del Flow & Paywall Builder como flows config validate ya lo aprobaron — ninguno lee el texto de una pantalla ni recorre sus interacciones. El informe comienza con el veredicto, seguido de una lista numerada de bloqueantes con el elemento exacto y la pantalla que hay que abrir.

El veredicto de un flow limpio dice READY FOR PRODUCTION, sin nada añadido después. Si flow-audit no encontró bloqueantes ni riesgos pero aún tiene preguntas abiertas, el veredicto dice READY, PENDING n CHECKS I CANNOT MAKE en lugar de certificar algo que no pudo verificar.

Qué no puede verificar

flow-audit no puede indicarte si el flow está vinculado a un placement. adapty flows get solo devuelve el id, el name, el status y el updated_at del flow, y la CLI no dispone de ningún comando que liste los placements en los que aparece un flow. Este es un recordatorio fijo en todos los informes, nunca una comprobación: confirma el placement tú mismo en la página Placements o consulta Crear placement.

Quién arregla qué

Cada informe termina con su propia sección WHAT TO DO NEXT, dividida según quién realiza el trabajo: qué puede cambiar un agente en el flow, qué solo tú puedes cambiar en el Adapty Dashboard, y qué debes confirmar tú mismo antes de publicar.

flow-audit no realiza ninguno de esos cambios por sí mismo — es de solo lectura por diseño, así que un flow que falla permanece exactamente como lo dejaste. Pasa el informe al skill flow-generator, que se encarga de la copia de seguridad, tu aprobación y la escritura real.