Communitygithub.com

cucoreanu/personal-skills

Planifica y construye maquetas de UI en Penpot con un flujo centrado en el usuario, niveles de fidelidad, un proceso de seis pasos y ensamblaje de lienzo de afuera hacia adentro. Úsalo al crear maquetas, maquetas de pantalla, trabajo de wireframe a maqueta, UI de baja/alta fidelidad, diseños específicos de plataforma o mejores prácticas de diseño de maquetas en Penpot.

¿Qué es personal-skills?

Este skill automatiza el diseño de maquetas de interfaz de usuario en Penpot siguiendo una metodología estructurada y centrada en el usuario. Es útil porque guía al agente de IA a través de un flujo de trabajo completo de seis pasos, desde la definición de objetivos hasta el refinamiento de detalles, utilizando el sistema de diseño de componentes y el orden de ensamblaje de lienzo de afuera hacia adentro definidos en `penpot-design`. Soporta tanto maquetas de baja fidelidad (para validar estructura y flujo rápidamente) como de alta fidelidad (listas para entrega a cliente o desarrollo), y se adapta a diferentes plataformas (web, móvil, escritorio, responsive). El skill funciona leyendo primero una visión general de alto nivel y luego aplicando las reglas de Penpot MCP para crear componentes, usar flexbox, llamar a la API y construir el lienzo en el orden correcto, evitando errores comunes como añadir demasiados detalles prematuramente.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cucoreanu/personal-skills/tree/HEAD/skills/penpot-mockup

Preguntar en tu IA favorita

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

Documentación

Maqueta en Penpot

Metodología para el diseño de maquetas en Penpot. Ejecutar con Penpot MCP según penpot-design (componentes, flex, API, árbol de afuera hacia adentro). Leer high_level_overview una vez antes de escribir.

Preguntar primero

Detenerse si falta algo:

  1. Objetivo y alcance — ¿sitio web, aplicación móvil, aplicación de escritorio o responsive? ¿Qué pantalla(s) o flujo?
  2. Audiencia — ¿quién lo usa? (ej. usuarios mayores → tipo de letra más grande, navegación más simple)
  3. Fidelidad — baja (estructura, diseño, flujo) o alta (color, tipografía, imágenes, pulido)?
  4. Plataforma — móvil, web, escritorio o responsive. Usar reglas del proyecto si están definidas; si no, preguntar. Nunca asumir.
  5. Instrucciones — qué construir/cambiar. Variantes multi-alternativa solo si se pide.

Maqueta vs wireframe vs prototipo

EtapaPropósitoEnfoque en Penpot
WireframeDiseño, jerarquía, flujo de usuario — sin pulido visualFormas simples, placeholders, espaciado real
MaquetaDiseño visual — apariencia y sensación, detalles de UIEste skill
PrototipoInteractividad — clics, flujos, estadosSolo cuando el usuario lo pida; usar variantes para estados

Por defecto, realizar maquetas visuales estáticas a menos que el usuario solicite comportamiento interactivo o de prototipo.

Fidelidad

Baja fidelidad — validar estructura y flujo rápidamente. Rellenos simples, placeholders, diseño alineado a cuadrícula. Iterar diseño y flujo de usuario antes del pulido. Se asigna al modo mockup en penpot-design.

Alta fidelidad — lista para cliente o entrega a desarrollo. Paleta de colores, tipografía, imágenes, componentes de marca. Se asigna al modo design en penpot-design.

Flujo de trabajo de seis pasos

Trabajar en este orden. No saltar al pulido antes de validar la estructura.

  1. Definir objetivo y alcance — propósito, audiencia objetivo, restricciones de plataforma.
  2. Wireframe — delinear secciones, áreas de contenido, navegación, CTAs con placeholders. Enfocarse en jerarquía y flujo.
  3. Sistema de cuadrícula — alinear elementos; espaciado consistente (escala de 8dp según penpot-design). Establecer jerarquía visual (título > texto de apoyo).
  4. Color y tipografía — paleta limitada; tipo de letra legible (tamaño, altura de línea, espaciado entre letras); contraste suficiente. Ver mockup-practices.md.
  5. Componentes de UI — botones, campos de entrada, barras de navegación, iconos. Aparece dos veces → componente. Estados → variantes. La ubicación y el tamaño importan para la usabilidad.
  6. Refinar detalles — imágenes, iconografía, espaciado, contraste. Exportar con export_shape para verificar.

Ensamblaje del lienzo (obligatorio)

La metodología anterior define qué decidir. Al dibujar en Penpot, seguir el orden de afuera hacia adentro de penpot-design — no inventar una secuencia de capas diferente:

  1. Tablero/contenedor de pantalla (vacío + flex)
  2. Capas de sección hijas directas (encabezado, cuerpo, pie de página, …) en orden z
  3. Componentes de cada sección, luego los elementos de esos componentes, recursivamente

Nunca crear hojas primero y envolverlas. Regla completa: ../penpot-design/references/build-order.md.

Mejores prácticas

  • Centrado en el usuario — diseñar para los objetivos del usuario; considerar personas y puntos de fricción en el recorrido.
  • Accesibilidad — tipo de letra legible, contraste suficiente, evitar significado solo con color; estructura navegable por teclado cuando corresponda.
  • Consistencia visual — una guía de estilo: tipografía, colores, espaciado, iconos en todas las pantallas.
  • Mundo real — considerar tamaños y orientaciones de pantalla; diseños responsive cuando la plataforma sea multi-dispositivo.
  • Retroalimentación iterativa — priorizar retroalimentación procesable sobre diseño, tipo de letra, color y flujo por encima del pulido subjetivo.

Lista de verificación de componentes principales

Cada maqueta de pantalla debe abordar:

  • Diseño y composición (cuadrícula, alineación, jerarquía)
  • Color y tipografía (paleta, tipo de letra legible)
  • Componentes de UI e iconos (CTAs, campos de entrada, navegación — componentizados)
  • Imágenes y medios (relevantes, sin saturar)
  • Marca (logotipo, colores, tipo de letra consistentes con la marca)

Dificultades

DesafíoRespuesta
Demasiado detalle demasiado prontoMantenerse en baja fidelidad hasta que el diseño y el flujo estén validados
Limitaciones (tiempo, tecnología, presupuesto)Enfocar funcionalidades MVP; reutilizar componentes del sistema de diseño
Desalineación con interesadosPresentar justificación; vincular decisiones a objetivos del usuario

Referencia detallada: mockup-practices.md.

Hecho

  • Objetivo, audiencia, fidelidad, plataforma, instrucciones confirmados
  • Estructura antes que pulido (wireframe → cuadrícula → tokens → componentes → detalles)
  • Lienzo de afuera hacia adentro (contenedor → capas hijas → elementos anidados)
  • Centrado en el usuario, accesible, visualmente consistente
  • Componentes/variantes según penpot-design; exportación verificada

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

cucoreanu/personal-skills

Interviews the user one decision at a time about adapting an existing iPhone app to iPhone Duo and writes an adaptation decision record only after they confirm a shared understanding. Use when the user is designing or adapting an app for iPhone Duo, a folding iPhone, outer and inner displays, or side-placed controls.

cucoreanu/personal-skills

Monitor one GitHub PR for new review feedback, implement only meaningful fixes, and answer reviewers with evidence, friendly wit, and pushback on unrealistic or overly defensive comments. Use when the user asks to babysit, watch, or monitor Codex/reviewer comments on a PR.

cucoreanu/personal-skills

Agent-only. After the user asks to create a PR for a new or updated skill under skills/ (never this skill), check project install vs source with scripts/diff-install.mjs; if missing or stale, ask to install locally via relative symlinks. Use when authoring or changing skills in this repo, opening a skill PR, or finishing skill work.

cucoreanu/personal-skills

Designs UI in Penpot via MCP with component discipline, flex alignment, outside-in build order, mockup/design modes, and optional skill updates from user feedback. Use for Penpot mockups, high-fidelity designs, Penpot MCP work, or component/variant refactors in Penpot.

cucoreanu/personal-skills

Creates and reschedules macOS Reminders (fast nudges) and private Calendar events (time blocks). Attaches user-provided files to Calendar events the same way Calendar.app does. Default schedule: next free day starting tomorrow unless the user names an exact time. Never shares calendars or invites to anyone. Use when the user says \"remind me\", \"add a reminder\", \"move reminder\", \"reschedule reminder\", \"push that reminder to\", \"put this on my calendar\", \"schedule this\", \"block time\", \"don't let me forget\", or asks to attach an image/file to a reminder event.

cucoreanu/personal-skills

Proofreads messages and teaches reusable writing patterns. Use when the user pastes a work message, Slack draft, status update, or asks for proofreading, tone, clarity, grammar, flow, or constructive feedback on writing they will send at work.

Skills relacionados