Design no Penpot
Apenas Penpot MCP — sem HTML/CSS paralelo, a menos que seja solicitado. Leia high_level_overview uma vez; inspecione a página focada (shapeStructure, componentes/tokens) antes de escrever.
Pergunte primeiro
- Modo:
mockupoudesign? - Instruções: o que construir/alterar. Alternativas com múltiplas variantes apenas se solicitado.
- Plataforma: use as regras do projeto se definidas; senão, pergunte. Nunca presuma iOS/Android/web.
Pare quando algum item estiver faltando.
Modos
Mockup — validação de baixa fidelidade: estrutura, hierarquia, fluxo; preenchimentos simples, espaçamento real; sem polimento a menos que solicitado.
Design — alta fidelidade: tokens, tipografia, estados, cromo. Mesmas regras de componente/flex. Prefira agrupar → componentizar → refinar em vez de reconstruir.
Regras
Componentes: aparece duas vezes → componente/instância. Mesma base, estado diferente → variantes (Ativo, Estado, Tamanho, …). Estrutura nos principais; substituições nas cópias; detach() para bifurcar apenas. Nomes: BarraFerramentas/Botão; camadas: fundo, ícone, rótulo (estáveis entre variantes). Profundidade ≤ 4; sem principais dentro de principais.
Layout: flex/grid; penpotUtils.addFlexLayout se houver filhos. Espaçamento: escala de 8dp (meio passo de 4). Controles: material-alignment.md. Ativo = variante/estilo, não deslocamento de layout. Ordem Z: fundo → conteúdo → sobreposições.
Árvore de construção: somente de fora para dentro — contêiner (vazio + flex) → suas cascas filhas diretas (ordem Z) → recorrer nos elementos de cada filho. Nunca envolva folhas existentes. Detalhe: build-order.md.
Processo: biblioteca: tokens → átomos → variantes. Depois monte as telas com a árvore de construção. Trabalho existente: agrupar → createComponent → substituir duplicatas por instâncias. Verifique com export_shape. Planeje antes de grandes reescritas.
API: penpot-api.md. Aprofundamento: repositório research/penpot-design-practices.md.
Extensibilidade
Se um feedback puder se tornar uma regra genérica do Penpot (não específica do projeto), pergunte: "Adicionar isto ao penpot-design após terminarmos?"
- Sim: anote a redação durante a tarefa; após a tarefa concluída, edite
personal-skills/skills/penpot-design/; reinstale:
em seguida, confirme o que mudou.npx skills add cucoreanu/personal-skills --skill penpot-design - Não: apenas na sessão. Nunca edite a habilidade no meio da tarefa, a menos que o usuário peça agora.
Feito
- Modo, instruções, plataforma (se necessário) confirmados
- Duplicatas são componentes; estados são variantes
- Flex/grid + alinhamento de controle inspirado no Material
- Tela construída de fora para dentro (contêiner → cascas filhas → elementos aninhados)
- Mockup baixa fidelidade / design alta fidelidade conforme o modo; exportação verificada