Communitygithub.com

cucoreanu/personal-skills

Planifie et construit des maquettes UI dans Penpot avec un flux de travail centré sur l'utilisateur, des niveaux de fidélité, un processus en six étapes et un assemblage de canvas de l'extérieur vers l'intérieur. À utiliser lors de la création de maquettes, de maquettes d'écran, de passage de wireframe à maquette, d'UI basse/haute fidélité, de mises en page spécifiques à une plateforme ou de bonnes pratiques de conception de maquettes dans Penpot.

Qu'est-ce que personal-skills ?

Cette compétence fournit une méthodologie complète pour la conception de maquettes UI dans Penpot. Elle guide l'utilisateur à travers un processus structuré en six étapes, de la définition des objectifs et de la portée jusqu'au raffinement des détails, en insistant sur une approche centrée sur l'utilisateur. Elle prend en charge les maquettes basse et haute fidélité et est conçue pour s'intégrer avec le MCP Penpot (`penpot-design`) pour les opérations de dessin. L'approche garantit que la structure (wireframe) est validée avant l'application du style visuel (couleur, typographie), et que l'assemblage du canvas respecte un ordre de l'extérieur vers l'intérieur (conteneur -> sections -> composants -> éléments). La compétence inclut des bonnes pratiques pour l'accessibilité, la cohérence visuelle et les retours itératifs, et fournit une checklist pour garantir que chaque maquette d'écran est complète.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Maquette Penpot

Méthodologie pour la conception de maquettes dans Penpot. À exécuter avec le MCP Penpot selon penpot-design (composants, flex, API, arbre de l'extérieur vers l'intérieur). Lisez high_level_overview une fois avant les écritures.

Demander d'abord

Arrêtez-vous lorsque l'un des éléments suivants manque :

  1. But & périmètre — site web, application mobile, application de bureau ou responsive ? Quel(s) écran(s) ou flux ?
  2. Public — qui utilise ceci ? (par exemple, utilisateurs âgés → texte plus grand, navigation plus simple)
  3. Fidélité — basse (structure, mise en page, flux) ou haute (couleur, typographie, imagerie, finition) ?
  4. Plateforme — mobile, web, bureau ou responsive. Utilisez les règles du projet si définies ; sinon, demandez. Ne présumez jamais.
  5. Instructions — quoi construire/modifier. Alternatives multi-variantes uniquement si demandé.

Maquette vs wireframe vs prototype

ÉtapeObjectifAxe Penpot
WireframeMise en page, hiérarchie, flux utilisateur — sans finition visuelleFormes simples, espaces réservés, espacement réel
MaquetteConception visuelle — apparence et sensations, détails UICette compétence
PrototypeInteractivité — clics, flux, étatsUniquement lorsque l'utilisateur le demande ; utilisez des variantes pour les états

Par défaut, utilisez des maquettes visuelles statiques sauf si l'utilisateur demande un comportement interactif/de prototype.

Fidélité

Basse fidélité — validez rapidement la structure et le flux. Remplissages simples, espaces réservés, mise en page alignée sur la grille. Itérez sur la mise en page et le flux utilisateur avant la finition. Correspond au mode mockup dans penpot-design.

Haute fidélité — prêt pour le client ou la remise aux développeurs. Palette de couleurs, typographie, imagerie, composants de marque. Correspond au mode design dans penpot-design.

Flux de travail en six étapes

Travaillez dans cet ordre. Ne sautez pas à la finition avant que la structure ne soit validée.

  1. Définir le but & le périmètre — objectif, public cible, contraintes de plateforme.
  2. Wireframe — esquisser les sections, zones de contenu, navigation, appels à l'action avec des espaces réservés. Concentrez-vous sur la hiérarchie et le flux.
  3. Système de grille — aligner les éléments ; espacement cohérent (échelle 8dp selon penpot-design). Établir une hiérarchie visuelle (titre > texte secondaire).
  4. Couleur & typographie — palette limitée ; type lisible (taille, hauteur de ligne, espacement des lettres) ; contraste suffisant. Voir mockup-practices.md.
  5. Composants UI — boutons, champs de saisie, barres de navigation, icônes. Apparaît deux fois → composant. États → variantes. L'emplacement et la taille sont importants pour l'utilisabilité.
  6. Affiner les détails — imagerie, iconographie, espacement, contraste. Exportez avec export_shape pour vérifier.

Assemblage du canvas (obligatoire)

La méthodologie ci-dessus décrit quoi décider. Lors du dessin dans Penpot, suivez l'ordre de l'extérieur vers l'intérieur de penpot-design — n'inventez pas une séquence de couches différente :

  1. Cadre/écran conteneur (vide + flex)
  2. Coquilles de sections enfants directes (en-tête, corps, pied de page, …) dans l'ordre z
  3. Composants de chaque section, puis éléments de ces composants, récursivement

Ne créez jamais les feuilles en premier et ne les enveloppez pas. Règle complète : ../penpot-design/references/build-order.md.

Bonnes pratiques

  • Centré sur l'utilisateur — concevez pour les objectifs des utilisateurs ; tenez compte des personas et des points de friction du parcours.
  • Accessibilité — type lisible, contraste suffisant, évitez les significations basées uniquement sur la couleur ; structure navigable au clavier le cas échéant.
  • Cohérence visuelle — un guide de style : typographie, couleurs, espacement, icônes sur tous les écrans.
  • Contexte réel — tenez compte des tailles et orientations d'écran ; mises en page responsives lorsque la plateforme est multi-appareils.
  • Retours itératifs — privilégiez les retours actionnables sur la mise en page, le type, la couleur et le flux plutôt que la finition subjective.

Liste de vérification des composants essentiels

Chaque maquette d'écran doit aborder :

  • Mise en page & composition (grille, alignement, hiérarchie)
  • Couleur & typographie (palette, type lisible)
  • Composants UI & icônes (appels à l'action, champs de saisie, navigation — sous forme de composants)
  • Imagerie & médias (pertinents, sans encombrement)
  • Image de marque (logo, couleurs, type cohérent avec la marque)

Pièges

DéfiRéponse
Trop de détails trop tôtRestez en basse fidélité jusqu'à ce que la mise en page et le flux soient validés
Contraintes (temps, technique, budget)Concentrez-vous sur les fonctionnalités MVP ; réutilisez les composants du système de design
Désalignement des parties prenantesPrésentez la justification ; liez les décisions aux objectifs des utilisateurs

Référence approfondie : mockup-practices.md.

Terminé

  • But, public, fidélité, plateforme, instructions confirmés
  • Structure avant finition (wireframe → grille → jetons → composants → détails)
  • Canvas de l'extérieur vers l'intérieur (conteneur → coquilles enfants → éléments imbriqués)
  • Centré sur l'utilisateur, accessible, visuellement cohérent
  • Composants/variantes selon penpot-design ; export vérifié

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 associés