Communitygithub.com

cucoreanu/personal-skills

Diseña interfaces de usuario en Penpot mediante MCP con disciplina de componentes, alineación flex, orden de construcción de afuera hacia adentro, modos de maqueta/diseño y actualizaciones opcionales de la habilidad a partir de comentarios del usuario. Úsalo para maquetas de Penpot, diseños de alta fidelidad, trabajo con MCP de Penpot, o refactorizaciones de componentes/variantes en Penpot.

¿Qué es personal-skills?

Este skill define un flujo de trabajo disciplinado para diseñar interfaces de usuario dentro de Penpot usando exclusivamente el protocolo MCP, sin recurrir a HTML/CSS en paralelo a menos que se solicite explícitamente. Está diseñado para agentes de IA que interactúan con Penpot y necesitan pautas claras sobre cuándo crear componentes, cómo nombrarlos (p. ej., `Toolbar/Button`), cómo estructurar layout con flex/grid siguiendo una escala de 8dp, y cómo construir el árbol visual de afuera hacia adentro: comenzando con contenedores vacíos con flex, luego sus hijos directos en orden z, y finalmente recursivamente cada elemento. Soporta un modo `mockup` para validación de baja fidelidad (estructura, jerarquía, flujo) y un modo `design` para alta fidelidad con tokens, tipografía, estados y cromo. Incluye reglas para convertir duplicados en componentes, usar variantes para estados, y mantener una profundidad máxima de 4 niveles sin mains dentro de mains. También permite que el usuario sugiera mejoras genéricas a las reglas del skill, las cuales se pueden aplicar editando el archivo SKILL.md y reinstalando el skill. Es compatible con las plataformas de Penpot y está orientado a agentes como Claude Code, Cursor o Codex que utilicen MCP.

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

Preguntar en tu IA favorita

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

Documentación

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

  1. Modo: ¿mockup o design?
  2. Instrucciones: qué construir o cambiar. Alternativas de múltiples variantes solo si se pide.
  3. 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:
    npx skills add cucoreanu/personal-skills --skill penpot-design
    
    luego confirma qué cambió.
  • 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

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

Plans and builds UI mockups in Penpot with user-centered workflow, fidelity levels, a six-step process, and outside-in canvas assembly. Use when creating mockups, screen mockups, wireframe-to-mockup work, low/high-fidelity UI, platform-specific layouts, or mockup design best practices 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