Communitygithub.com

Penpot Design

Entwirft UI in Penpot über MCP mit Komponentendisziplin, Flex-Ausrichtung, Outside-In-Aufbaureihenfolge, Mockup-/Design-Modi und optionalen Skill-Updates aus Nutzerfeedback. Verwenden für Penpot-Mockups, hochauflösende Designs, Penpot-MCP-Arbeit oder Komponenten-/Varianten-Refaktorisierungen in Penpot.

Was ist Penpot Design?

Dieser Skill ist ein spezialisierter Penpot-Design-Assistent, der über MCP (Model Context Protocol) operiert. Er unterstützt Entwickler und Designer beim Erstellen von UI-Designs in Penpot, wobei klare Trennung zwischen Mockup (schnelle, low-fidelity Validierung) und Design (hochauflösend mit Token, Typografie und Interaktionszuständen) besteht. Der Skill erzwingt Komponentendisziplin: jedes wiederholt verwendete Element wird als Komponente angelegt, Zustände als Varianten; er verwendet Flexbox- und CSS-Grid-Layouts mit einem Material-inspirierten 8-Punkt-Abstandsraster und einem Outside-In-Aufbau (Container → Kind-Schalen → Kind-Elemente). Vor jeder Aktion werden Modus, Anweisungen und Plattform (falls nicht durch Projektregeln vorgegeben) abgefragt. Nach Abschluss kann der Nutzer allgemein gültige Verhaltensregeln in den Skill einfließen lassen, sodass dieser kontinuierlich verbessert wird. Unterstützt werden Penpot MCP, die CLI via npx skills add, und die Arbeit mit Tokens, Atomen und Varianten, bevor Screens zusammengesetzt werden. Der Skill eignet sich für Refaktorisierungen von Komponenten, Design-System-Pflege und schnelle UI-Prototypen ohne HTML/CSS-Nebenarbeit.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Penpot Design?

Nur Penpot MCP — kein paralleles HTML/CSS, außer gefragt. Lies high_level_overview einmal; inspiziere die fokussierte Seite (shapeStructure, Komponenten/Tokens) vor dem Schreiben.

Zuerst fragen

  1. Modus: mockup oder design?
  2. Anweisungen: was zu bauen/ändern ist. Multivariante Alternativen nur wenn gefragt.
  3. Plattform: Projektregeln verwenden, falls gesetzt; sonst fragen. Niemals iOS/Android/Web annehmen.

Stoppen, wenn etwas fehlt.

Modi

Mockup — Low-Fi-Validierung: Struktur, Hierarchie, Ablauf; einfache Füllungen, echte Abstände; keine Verfeinerung, außer gefragt.

Design — Höhere Auflösung: Tokens, Typografie, Zustände, Chrome. Gleiche Komponenten-/Flex-Regeln. Gruppieren → Komponente erstellen → verfeinern gegenüber Neubau bevorzugen.

Regeln

Komponenten: zweimal vorhanden → Komponente/Instanz. Gleiche Basis, anderer Zustand → Varianten (Active, State, Size, …). Struktur auf Mains; Überschreibungen auf Kopien; detach() zum Forken nur. Namen: Toolbar/Button; Ebenen: background, icon, label (stabil über Varianten). Tiefe ≤ 4; keine Mains innerhalb von Mains.

Layout: Flex/Grid; penpotUtils.addFlexLayout falls Kinder vorhanden. Abstände: 8-Punkt-Skala (4 Halbschritt). Steuerelemente: material-alignment.md. Aktiv = Variante/Style, kein Layout-Shift. Z-Reihenfolge: Hintergrund → Inhalt → Overlays.

Aufbaubaum: nur Outside-In: Container (leer + flex) → seine direkten Kind-Schalen (Z-Reihenfolge) → rekursiv in jedes Kind hinein. Niemals vorhandene Blätter einwickeln. Detail: build-order.md.

Prozess: Bibliothek: Tokens → Atome → Varianten. Dann Screens mit dem Aufbaubaum zusammensetzen. Vorhandene Arbeit: gruppieren → createComponent → Duplikate durch Instanzen ersetzen. Mit export_shape überprüfen. Planen vor großen Umschreibungen.

API: penpot-api.md. Tiefer Einstieg: Repo research/penpot-design-practices.md.

Erweiterbarkeit

Wenn Feedback zu einer allgemeinen Penpot-Regel werden könnte (nicht projektspezifisch), frage: "Dies zu penpot-design hinzufügen, nachdem wir fertig sind?"

  • Ja: Formulierung während der Aufgabe notieren; nach Aufgabe erledigt personal-skills/skills/penpot-design/ bearbeiten; neu installieren:
    npx skills add cucoreanu/personal-skills --skill penpot-design
    
    dann bestätigen, was sich geändert hat.
  • Nein: Nur für die Sitzung. Niemals den Skill während einer Aufgabe bearbeiten, außer der Nutzer verlangt es jetzt.

Erledigt

  • Modus, Anweisungen, Plattform (falls nötig) bestätigt
  • Duplikate sind Komponenten; Zustände sind Varianten
  • Flex/Grid + Material-inspirierte Steuerelementausrichtung
  • Canvas Outside-In aufgebaut (Container → Kind-Schalen → verschachtelte Elemente)
  • Mockup Low-Fi / Design Hi-Fi je nach Modus; Export geprüft

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.

Verwandte Skills