penpot-design-md

Installation
SKILL.md

penpot-design-md — Extract a DESIGN.md spec from a Penpot file

1. Title + How it works

This skill turns a Penpot file into a DESIGN.md: a single, portable markdown document that lets any human or LLM reproduce the design system without opening Penpot — YAML frontmatter carrying the token maps (colors, typography, rounded, spacing, components) plus prose sections that explain how the system behaves (Overview, per-domain sections, Do's & Don'ts, Iteration Guide, Known Gaps). Every mutation goes through execute_code; validate visually with export_shape; read structure with penpotUtils.shapeStructure (full tool surface: shared/penpot-mcp-tool-reference.md) — but this skill performs no canvas mutation at all: it only reads (tokens, library assets, sampled component styles, exported images) and writes one local markdown file on the agent's filesystem. It is multimodal by design: the aesthetic prose (frontmatter description, Overview, Do's & Don'ts) must be written after looking at real exports, not from token names alone.


Installs
56
GitHub Stars
76
First Seen
Jul 9, 2026
penpot-design-md — penpot/penpot-ai-kit