Communitygithub.com

cucoreanu/personal-skills

Planeja e cria mockups de UI no Penpot com fluxo centrado no usuário, níveis de fidelidade, processo de seis etapas e montagem de tela de fora para dentro. Use ao criar mockups, wireframes para mockups, UI de baixa/alta fidelidade, layouts específicos de plataforma ou melhores práticas de design de mockup no Penpot.

O que é personal-skills?

Esta skill fornece uma metodologia completa para design de mockups no Penpot, executada por meio do MCP `penpot-design`. Ela garante um fluxo de trabalho centrado no usuário, começando pela definição de metas e escopo, público-alvo, fidelidade (baixa ou alta) e plataforma. O processo de seis etapas orienta o usuário da estruturação ao refinamento, seguindo a montagem de tela de fora para dentro do Penpot. A skill inclui listas de verificação para evitar armadilhas comuns, como adicionar muitos detalhes cedo demais, e promove práticas de design acessível e consistente. É útil para desenvolvedores e designers que usam o Penpot para criar mockups estáticos visuais, wireframes ou protótipos interativos, garantindo que o design seja escalável e alinhado com as necessidades do usuário.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Penpot Mockup

Metodologia para design de mockups no Penpot. Execute com o MCP do Penpot conforme penpot-design (componentes, flex, API, árvore de fora para dentro). Leia high_level_overview uma vez antes de escrever.

Pergunte primeiro

Pare quando algo estiver faltando:

  1. Meta e escopo — site, aplicativo móvel, desktop ou responsivo? Qual(is) tela(s) ou fluxo?
  2. Público-alvo — quem usa isso? (por exemplo, usuários idosos → fonte maior, navegação mais simples)
  3. Fidelidade — baixa (estrutura, layout, fluxo) ou alta (cor, tipografia, imagens, polimento)?
  4. Plataforma — móvel, web, desktop ou responsivo. Use regras do projeto se definidas; caso contrário, pergunte. Nunca assuma.
  5. Instruções — o que construir/alterar. Alternativas multivariantes somente se solicitado.

Mockup vs wireframe vs protótipo

EstágioPropósitoFoco no Penpot
WireframeLayout, hierarquia, fluxo do usuário — sem polimento visualFormas simples, placeholders, espaçamento real
MockupDesign visual — aparência e sensação, detalhes da UIEsta skill
ProtótipoInteratividade — cliques, fluxos, estadosSomente quando o usuário pedir; use variantes para estados

Padrão: mockups visuais estáticos, a menos que o usuário solicite comportamento interativo/de protótipo.

Fidelidade

Baixa fidelidade — valide estrutura e fluxo rapidamente. Preenchimentos simples, placeholders, layout alinhado à grade. Itere layout e fluxo do usuário antes do polimento. Mapeia para o modo mockup em penpot-design.

Alta fidelidade — pronto para cliente ou entrega para desenvolvimento. Paleta de cores, tipografia, imagens, componentes de marca. Mapeia para o modo design em penpot-design.

Fluxo de trabalho de seis etapas

Trabalhe nesta ordem. Não pule para o polimento antes de a estrutura ser validada.

  1. Definir meta e escopo — propósito, público-alvo, restrições da plataforma.
  2. Wireframe — delineie seções, áreas de conteúdo, navegação, CTAs com placeholders. Foco em hierarquia e fluxo.
  3. Sistema de grade — alinhe elementos; espaçamento consistente (escala 8dp conforme penpot-design). Estabeleça hierarquia visual (título > texto de apoio).
  4. Cor e tipografia — paleta limitada; tipo legível (tamanho, altura da linha, espaçamento entre letras); contraste suficiente. Veja mockup-practices.md.
  5. Componentes da UI — botões, campos de entrada, barras de navegação, ícones. Aparece duas vezes → componente. Estados → variantes. Posicionamento e tamanho importam para usabilidade.
  6. Refinar detalhes — imagens, iconografia, espaçamento, contraste. Exporte com export_shape para verificar.

Montagem da tela (obrigatório)

A metodologia acima é o que decidir. Ao desenhar no Penpot, siga a ordem de fora para dentro do penpot-design — não invente uma sequência de camadas diferente:

  1. Quadro/container da tela (vazio + flex)
  2. Cascas de seções filhas diretas (cabeçalho, corpo, rodapé, …) em ordem z
  3. Componentes de cada seção, depois os elementos desses componentes, recursivamente

Nunca crie folhas primeiro e depois as envolva. Regra completa: ../penpot-design/references/build-order.md.

Melhores práticas

  • Centrado no usuário — projete para metas do usuário; considere personas e pontos de atrito na jornada.
  • Acessibilidade — tipo legível, contraste suficiente, evite significado apenas por cor; estrutura navegável por teclado quando relevante.
  • Consistência visual — um guia de estilo: tipografia, cores, espaçamento, ícones em todas as telas.
  • Mundo real — considere tamanhos e orientações de tela; layouts responsivos quando a plataforma for multi-dispositivo.
  • Feedback iterativo — priorize feedback acionável sobre layout, tipo, cor e fluxo em vez de polimento subjetivo.

Lista de verificação de componentes principais

Cada mockup de tela deve abordar:

  • Layout e composição (grade, alinhamento, hierarquia)
  • Cor e tipografia (paleta, tipo legível)
  • Componentes e ícones da UI (CTAs, campos de entrada, navegação — componentizados)
  • Imagens e mídia (relevantes, sem poluir)
  • Marca (logotipo, cores, tipo consistentes com a marca)

Armadilhas

DesafioResposta
Muito detalhe muito cedoMantenha baixa fidelidade até layout e fluxo serem validados
Restrições (tempo, tecnologia, orçamento)Foco em funcionalidades do MVP; reutilize componentes do sistema de design
Desalinhamento entre partes interessadasApresente a justificativa; conecte decisões às metas do usuário

Referência aprofundada: mockup-practices.md.

Concluído

  • Meta, público, fidelidade, plataforma, instruções confirmados
  • Estrutura antes do polimento (wireframe → grade → tokens → componentes → detalhes)
  • Tela de fora para dentro (container → cascas filhas → elementos aninhados)
  • Centrado no usuário, acessível, visualmente consistente
  • Componentes/variantes conforme penpot-design; exportação 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.

Habilidades Relacionadas