CommunityProgramación y desarrollogithub.com

React a Phoenix LiveView

Porta páginas o componentes de React a Phoenix LiveView y HEEx con estilo fiel, comportamiento responsivo e interacciones. Útil para migraciones de React a LiveView, conversiones de JSX a HEEx o inspección de una interfaz React antes de reconstruirla en Phoenix.

¿Qué es React a Phoenix LiveView?

Este skill permite a un agente de IA traducir interfaces de usuario de React a Phoenix LiveView y HEEx, preservando fielmente el diseño visual, el comportamiento responsivo y las interacciones. Está diseñado para desarrolladores que migran aplicaciones React a Phoenix, necesitan convertir componentes JSX a HEEx, o desean inspeccionar una interfaz React antes de reconstruirla con LiveView. El skill se basa en inspeccionar primero la fuente React para extraer una 'hoja de ruta de migración' (mapeo de componentes, estados y tokens), luego implementar la interfaz en Phoenix siguiendo las convenciones de LiveView y HEEx, y finalmente revisar y entregar los cambios. Soporta múltiples plataformas de agentes (Claude Code, Cursor, Codex) y se enfoca en la fidelidad visual y de comportamiento, no en una traducción mecánica de sintaxis. Incluye pautas para manejar el alcance, la autorización, los estados (carga, vacío, error, etc.), y la integración con assets y hooks existentes.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Uzski-Corp/agent-skills/tree/HEAD/skills/react-to-liveview-port

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

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

Documentación

¿Qué hace React a Phoenix LiveView?

Reproduce la interfaz de React solicitada integrándola con la arquitectura de la aplicación de destino. Trata la fuente como referencia visual y de comportamiento; sigue los requisitos explícitos del destino cuando difieran. Descubre las convenciones del código en lugar de asumir un framework de React, sistema CSS, biblioteca de componentes o versión de Phoenix.

Establecer alcance y convenciones

  • Lee las instrucciones del repositorio aplicables y la documentación relevante de ambos proyectos. Localiza el punto de entrada de React, la aplicación de destino y la ruta o componente solicitados. Los proyectos pueden ser repositorios separados o compartir un espacio de trabajo.
  • Inspecciona los manifiestos y las implementaciones existentes para identificar estilos, componentes, fuentes, temas, assets, enrutamiento, autenticación, acceso a datos e integración de JavaScript. Verifica si existe una ruta, un puerto parcial, un componente o un hook antes de crear uno nuevo.
  • Mantén el alcance limitado a la interfaz asignada y al comportamiento requerido. Un mockup estático no requiere nuevas funcionalidades de backend; una migración funcional requiere integraciones reales o brechas explícitamente reveladas.
  • Respeta las pruebas y los permisos de herramientas del usuario. La inspección de la fuente, la inspección de referencias, la preparación de previsualizaciones, las pruebas automatizadas y el QA del navegador son actividades distintas; no asumas que todas están autorizadas.

1. Inspeccionar la fuente

Lee css-extraction.md. Rastrea la página, los hijos visualmente significativos, los estilos, las variantes de componentes, los assets y la lógica de estado. Establece:

  • Diseño, reglas responsivas, tipografía, temas, imágenes y animación.
  • Estilos efectivos después de los valores predeterminados de la biblioteca, las sobrescrituras locales, las props condicionales y la cascada CSS.
  • Navegación, formularios, superposiciones, carga, permisos, mutaciones, persistencia y rutas de recuperación relevantes para el alcance.

Registra un mapa de migración compacto: componente fuente → componente destino, dato/acción fuente → contexto/evento destino, token fuente → equivalente destino. Separa el comportamiento observado de las suposiciones y los valores en tiempo de ejecución no resueltos.

Para una solicitud de análisis, entrega los hallazgos y detente. Para una implementación autorizada, menciona brevemente las brechas o desviaciones materiales y continúa. Pregunta solo cuando una elección no resuelta cambie materialmente el alcance, el comportamiento o la fidelidad; no requieras una confirmación separada para decisiones de traducción rutinarias.

2. Implementar en Phoenix

Lee liveview-conventions.md. Reutiliza componentes, diseños, contextos, autorización, tokens, assets y hooks del destino donde reproduzcan el resultado requerido.

  • Traduce la salida renderizada y el comportamiento, no la sintaxis de React o los nombres de componentes mecánicamente.
  • Preserva los valores visuales, las reglas responsivas, los estados y la semántica. No sustituyas una fuente, icono, componente o animación vagamente similar sin justificación.
  • Aplica los requisitos explícitos del destino de manera consistente y explica las desviaciones visibles. Nunca traslades las restricciones de fuente, el proveedor de almacenamiento, la estructura de rutas o los nombres de otro proyecto al puerto.
  • Mantén el estado propiedad del servidor en LiveView y contextos; usa CSS o mecanismos existentes del cliente para el comportamiento visual local. Agrega hooks solo para capacidades del navegador que los necesiten.
  • Completa los estados aplicables de carga, vacío, validación, pendiente, éxito, fallo, reintento, permiso y recuperación. Preserva la entrada del usuario en caso de fallo y evita que acciones repetidas corrompan datos.

3. Revisar y entregar

Revisa los cambios contra el mapa de migración, incluyendo variantes responsivas/de tema, autorización, manejo de eventos, accesibilidad y limpieza del ciclo de vida. Verifica que los assets requeridos y los componentes referenciados existan.

Usa los comandos de verificación del proyecto y las herramientas en tiempo de ejecución solo cuando esté permitido. Prepara una vista previa en vivo cuando esté autorizado. Nunca afirmes verificación en tiempo de ejecución, visual o de pruebas basada solo en la inspección de la fuente.

Entrega brevemente: qué se portó, desviaciones materiales, mocks o integraciones faltantes, verificación realizada u omitida, y los estados que el usuario debería probar. Si una dependencia bloquea la finalización, identifícala concretamente y completa el trabajo independiente dentro del alcance.

Skills relacionados