Communitygithub.com

markitui-build-pages

Habilidad de diseño. Construye páginas web o de tienda online en tu propia copia del archivo MarkitUI de Figma a partir de bloques de biblioteca: un plan de página para aprobación, bloques de proyecto y marcos de página xl y base (además de marcos md opcionales para tablet) con notas de entrega para desarrolladores. Úsala cuando alguien quiera diseñar, componer, planificar o construir páginas, un mapa del sitio, una landing page o una tienda en MarkitUI, y cuando quiera reconstruir.

¿Qué es markitui-build-pages?

Esta habilidad automatiza el proceso de diseño de páginas web y tiendas online dentro de una copia de usuario del archivo Figma de MarkitUI. Transforma un brief, un mapa del sitio, una lista de páginas o un sitio web de referencia en páginas terminadas, siguiendo un flujo estructurado: bloque de biblioteca → bloque de proyecto → página compuesta en un componente Breakpoint → marcos separados `{Página} / xl` y `{Página} / base` (y opcionalmente `{Página} / md`) en una sección por página → notas de entrega para desarrolladores. Es útil para diseñadores y desarrolladores que quieren crear o reconstruir páginas web de manera eficiente y consistente usando el sistema de diseño MarkitUI. Soporta la creación de sitios de marketing, tiendas online o ambos, y maneja la adaptación responsive (xl, base y md). El flujo de trabajo incluye cuatro fases principales: planificación de la página (con aprobación), creación de bloques de proyecto, composición de las páginas en Figma, y adición de notas de entrega con anotaciones de ruta y comportamiento. Utiliza el servidor MCP de Figma para escribir en el archivo y sigue estrictamente las reglas de no modificar bloques de biblioteca, usar variables y estilos de texto de MarkitUI, y evitar contenido placeholder. La habilidad también gestiona contenido dinámico como blogs, changelogs, historias de clientes y eventos, planificando páginas de archivo y plantillas de detalle cuando sea necesario. Integra la posibilidad de elegir entre diferentes variantes responsive y personalizar el nombre del proyecto, el tipo de sitio y el contenido de copia (real, placeholder creíble o estilo de referencia).

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/studio-coal/markitui/tree/HEAD/skills/markitui-build-pages

Preguntar en tu IA favorita

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

Documentación

MarkitUI: construir páginas

Convierte un brief, un mapa del sitio, una lista de páginas, un sitio web de referencia o un sitio web existente en páginas terminadas dentro del archivo Figma de MarkitUI del usuario. El flujo es siempre:

bloque de biblioteca → bloque de proyecto → página compuesta en un componente Breakpoint → marcos separados {Página} / xl y {Página} / base (y {Página} / md si el usuario quiere tablet) en una Sección por página → notas de entrega.

La documentación del propio archivo es la fuente de verdad. Al inicio de cada ejecución, lee los marcos de documentación Composing pages, Layout y Breakpoints en la página de Documentación, y el marco de documentación Navigation para la lista de categorías de bloques. Cuando el sitio tenga blog, changelog, historias de clientes o eventos, lee también el marco de documentación Archive pages en la página de Archive Components y el marco de documentación Assembling archive and detail pages en la página de Blog (Archive / Post). Si algo en esta habilidad está en desacuerdo con ellos, sigue el archivo.

Antes de empezar

  • Trabaja solo en la copia del usuario de MarkitUI. Pide su enlace de Figma si no lo tienes.
  • Escribir en Figma necesita el servidor MCP de Figma con acceso de escritura. Carga la guía del MCP de Figma para escribir en archivos (su habilidad figma-use) antes de la primera edición, y crea una sesión primero si el servidor lo solicita.
  • Cambia de páginas de Figma como máximo una vez por script. Encuentra páginas, componentes y colecciones de variables por nombre, no por ID.
  • Los bloques de biblioteca y los componentes base son definitivos. Nunca los edites para hacer que una página funcione. Si algo no se puede hacer con un bloque tal como está, díselo al usuario y pregunta.

Preguntas iniciales

Antes de cualquier planificación, pregunta lo que el prompt del usuario no aclare ya, en un mensaje (usa preguntas de opción múltiple cuando la interfaz las ofrezca). Omite una pregunta solo cuando el prompt la responda de manera inequívoca.

  1. ¿A partir de qué se deben construir las páginas?

    • un brief o descripción del negocio
    • un mapa del sitio o lista de páginas
    • un sitio web de referencia a seguir (solo estructura, nuevo contenido)
    • su sitio web existente para reconstruir (conserva su contenido)
    • cualquier otra cosa que tengan: capturas de pantalla, un documento, sitios de la competencia, un wireframe
  2. Variantes responsive: ¿cuántas variantes de breakpoint debe tener cada bloque y página?

    • xl + base (escritorio y móvil; por defecto, los bloques de biblioteca están listos)
    • xl + md + base (añade tablet: una variante md en cada bloque de proyecto y un marco md para cada página)
    • md solo para algunas páginas (ellos nombran las páginas)

    Proporciona la compensación de una línea de references/responsive.md. Nunca añadas md sin un sí.

  3. Nombre del proyecto, usado en cada nombre de componente (ej. Acme).

  4. Tipo de sitio: sitio web de marketing, tienda online, o ambos.

  5. Dónde construir: una nueva página de Figma en el archivo (ej. ↳ Páginas Acme) a menos que el usuario nombre una.

  6. Contenido: el contenido real del usuario, contenido escrito al estilo de un sitio de referencia, o contenido placeholder creíble.

  7. Para tiendas: país, moneda y formato de número, tasa de IVA o impuesto sobre ventas.

Luego recoge lo que necesite la fuente elegida: el brief, el mapa del sitio o la URL del sitio web (y para un sitio de referencia o existente, lee references/existing-site.md).

Usa bloques de proyecto por defecto. Usa bloques de biblioteca directamente solo si el usuario pide un prototipo rápido o una landing page única.

Flujo de trabajo

Fase 1: Plan de página (detente para aprobación). Lee references/page-planning.md. El plan indica los breakpoints que eligió el usuario. Inventaría la biblioteca, elige bloques para cada página y presenta la tabla del plan. Para páginas de Blog, Changelog, Historias de Clientes o Eventos y Webinars, lee references/content-types.md y planifica una página de archivo y una plantilla de detalle para cada una. Cuando la entrada sea un sitio web existente para reconstruir, lee primero references/existing-site.md; produce el mismo plan. Detente y espera la aprobación o cambios.

Fase 2: Bloques de proyecto. Lee references/project-blocks.md. Clona cada bloque de biblioteca elegido en un bloque de proyecto, renómbralo y adáptalo en el maestro. Construye también la barra de navegación, los menús y el pie de página como bloques de proyecto. Para bloques de archivo, configura los componentes de archivo (encabezado, barra lateral, paginación) en el maestro del bloque de proyecto como describe references/content-types.md. Si el usuario eligió md, lee references/responsive.md y añade una variante md a cada bloque de proyecto que usen las páginas md.

Fase 3: Compón las páginas. Lee references/composing.md y references/content.md. Construye cada página en xl dentro de un componente Breakpoint, duplícala para base (y md, siguiendo references/responsive.md), separa, nombra, envuelve en una Sección y distribuye en el lienzo.

Fase 4: Notas de entrega. Lee references/handoff.md. Añade la anotación de ruta a cada marco xl y anotaciones de comportamiento y contenido donde un marco estático no pueda mostrar lo que ocurre.

Verifica e informa. Lee references/checks.md. Ejecuta las comprobaciones del script, captura cada página en cada breakpoint que tenga, corrige lo que encuentres y luego informa.

Archivos de referencia: lee cada uno cuando llegue su fase

  • references/page-planning.md: anatomía de página, elección de bloques, tabla del plan. Fase 1.
  • references/existing-site.md: reconstrucción de un sitio web existente. Fase 1, cuando la entrada sea un sitio en vivo.
  • references/content-types.md: páginas de archivo y detalle para Blog, Changelog, Historias de Clientes y Eventos y Webinars; ArchiveHeader, ArchiveSidebar y ArchivePagination. Fases 1–3, cuando el sitio tenga alguno de ellos.
  • references/project-blocks.md: clonación, nombrado, qué cambiar en el maestro, reglas de diseño. Fase 2.
  • references/responsive.md: la opción md, añadir variantes md a bloques de proyecto, ensamblar páginas md con el componente Breakpoint. Preguntas iniciales, Fase 2 y Fase 3, cuando se elija md.
  • references/composing.md: componente Breakpoint, xl y base, separación, nombrado, distribución en el lienzo. Fase 3.
  • references/content.md: contenido, datos de tienda, fechas, imágenes. Fase 3.
  • references/handoff.md: formatos de anotación de los que dependen los desarrolladores y la habilidad de generar código. Fase 4.
  • references/checks.md: auditoría, capturas de pantalla y el informe. Última.

Innegociables

  • Pregunta las preguntas iniciales que el prompt no responda, incluyendo las variantes responsive, antes de planificar.
  • Detente después del plan y espera la aprobación. Nunca construyas páginas a partir de un plan no aprobado.
  • Nunca edites bloques de biblioteca, componentes base o componentes de archivo; todos los cambios van en bloques de proyecto o anulaciones de instancia.
  • Cada página tiene un marco xl y uno base (y un marco md si se eligió) construidos a partir de los mismos bloques, y el Breakpoint de cada bloque coincide con su marco.
  • Todo se mantiene en variables y estilos de texto de MarkitUI. Sin colores crudos, espaciado, radios o configuraciones de fuente.
  • Contenido real o creíble, nunca Lorem ipsum. Sin nombres de marca ni logotipos reales que no sean del usuario.
  • Cada marco xl recibe una anotación de ruta en el formato exacto de references/handoff.md.

Skills relacionados