Communitygithub.com

cucoreanu/personal-skills

Projeta UI no Penpot via MCP com disciplina de componentes, alinhamento flex, ordem de construção de fora para dentro, modos de rascunho/design e atualizações opcionais de habilidade a partir do feedback do usuário. Use para rascunhos no Penpot, designs de alta fidelidade, trabalho com Penpot MCP ou refatorações de componentes/variantes no Penpot.

O que é personal-skills?

Esta habilidade permite que você projete interfaces de usuário diretamente no Penpot usando o protocolo MCP, seguindo uma disciplina rigorosa de componentes e layout. É especialmente útil para desenvolvedores e designers que trabalham com o Penpot como ferramenta de design e desejam automatizar a criação de componentes, variantes e layouts responsivos com alinhamento baseado em Material Design. A habilidade suporta dois modos principais: 'mockup', para validação rápida de baixa fidelidade, e 'design', para produção de alta fidelidade com tokens, tipografia e estados. O processo de construção segue a ordem de fora para dentro (outside-in), priorizando a criação de contêineres flex first. Componentes que aparecem mais de uma vez são transformados em instâncias, e estados diferentes dão origem a variantes nomeadas (ex.: 'Active', 'State', 'Size'). A habilidade também permite que sugestões de melhoria genéricas sejam incorporadas permanentemente ao seu repositório de skills mediante confirmação do usuário.

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

Perguntar na sua IA favorita

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

Documentação

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

  1. Modo: mockup ou design?
  2. Instruções: o que construir/alterar. Alternativas com múltiplas variantes apenas se solicitado.
  3. 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:
    npx skills add cucoreanu/personal-skills --skill penpot-design
    
    em seguida, confirme o que mudou.
  • 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

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.

Habilidades Relacionadas