Diseño en Penpot
Solo MCP de Penpot — nada de HTML/CSS en paralelo a menos que se pida. Lee high_level_overview una vez; inspecciona la página enfocada (shapeStructure, componentes/tokens) antes de escribir.
Preguntar primero
- Modo: ¿
mockupodesign? - Instrucciones: qué construir o cambiar. Alternativas de múltiples variantes solo si se pide.
- Plataforma: usa las reglas del proyecto si están definidas; si no, pregunta. Nunca asumas iOS/Android/web.
Detente cuando falte alguno.
Modos
Mockup — validación de baja fidelidad: estructura, jerarquía, flujo; rellenos simples, espaciado real; sin pulir a menos que se pida.
Design — mayor fidelidad: tokens, tipografía, estados, cromo. Mismas reglas de componente/flex. Prefiere agrupar → componentizar → refinar en lugar de reconstruir.
Reglas
Componentes: aparece dos veces → componente/instancia. Misma base, estado diferente → variantes (Activo, Estado, Tamaño, …). Estructura en los principales; anulaciones en las copias; detach() solo para bifurcar. Nombres: Toolbar/Button; capas: background, icon, label (estables entre variantes). Profundidad ≤ 4; sin principales dentro de principales.
Layout: flex/grid; penpotUtils.addFlexLayout si hay hijos. Espaciado: escala de 8dp (4 medio paso). Controles: material-alignment.md. Activo = variante/estilo, no cambio de layout. Orden Z: fondo → contenido → superposiciones.
Árbol de construcción: solo de afuera hacia adentro — contenedor (vacío + flex) → sus caparazones hijos directos (orden Z) → recurre en los elementos de cada hijo. Nunca envuelvas hojas existentes. Detalle: build-order.md.
Proceso: librería: tokens → átomos → variantes. Luego ensambla pantallas con el árbol de construcción. Trabajo existente: agrupa → createComponent → reemplaza duplicados con instancias. Verifica con export_shape. Planifica antes de grandes reescrituras.
API: penpot-api.md. Inmersión profunda: repositorio research/penpot-design-practices.md.
Extensibilidad
Si un comentario podría convertirse en una regla genérica de Penpot (no específica del proyecto), pregunta: "¿Añadimos esto a penpot-design después de terminar?"
- Sí: anota la redacción durante la tarea; después de terminar la tarea edita
personal-skills/skills/penpot-design/; reinstala:
luego confirma qué cambió.npx skills add cucoreanu/personal-skills --skill penpot-design - No: solo durante la sesión. Nunca edites el skill a mitad de una tarea a menos que el usuario lo pida ahora.
Hecho
- Modo, instrucciones, plataforma (si es necesario) confirmados
- Duplicados son componentes; estados son variantes
- Flex/grid + alineación de controles inspirada en Material
- Lienzo construido de afuera hacia adentro (contenedor → caparazones hijos → elementos anidados)
- Maqueta de baja fidelidad / diseño de alta fidelidad según el modo; exportación verificada