penpot-design-md

Extract design system specifications from Penpot files into markdown.

33|3|Updated Jun 18, 2026
One-click install
npx skills add https://github.com/penpot/penpot-ai-kit --skill penpot-design-md
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: penpot-design-md
Source: https://github.com/penpot/penpot-ai-kit/tree/main/skills/penpot-design-md
Command: npx skills add https://github.com/penpot/penpot-ai-kit --skill penpot-design-md

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires shared/penpot-mcp-tool-reference.md, shared/plugin-api-gotchas.md, shared/tokens-schema.json, shared/naming-conventions.md, shared/state-management.md, shared/modes-and-policies.md, shared/visual-self-review.md, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the extraction of design documentation from Penpot files, providing a portable markdown spec for design systems.

Core Features & Use Cases

  • Design Documentation Extraction: Extracts design system specifications, including colors, typography, and components, into a markdown file.
  • Token Mapping: Maps tokens from Penpot files to a consistent format for design system documentation.
  • Use Case: Imagine you have a complex Penpot design system. Use this Skill to automatically generate a comprehensive DESIGN.md file that can be shared with other designers or developers.

Quick Start

Run the penpot-design-md skill to extract the design documentation for your current Penpot file.

Frequently Asked Questions about penpot-design-md

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate design documentation from a Penpot file?▼

You can generate design documentation from a Penpot file by running this Skill to automatically extract design system specifications, including colors, typography, and components, into a portable markdown file.

What is the best way to extract design tokens from Penpot into markdown?▼

Extracting design tokens into markdown is done by this Skill, which maps tokens from your Penpot file into a consistent, portable format for comprehensive design system documentation.

Can I automatically document my design system components from Penpot?▼

Yes, you can automatically document your design system components from Penpot. This Skill extracts component specifications and token mappings directly from your file structure into a portable markdown spec.

Does extracting Penpot design documentation require access to the file's internal structure?▼

Yes, extracting Penpot design documentation requires access to the file's internal structure and content to accurately map tokens and extract component specifications into the markdown output.

How do I share my Penpot design system specifications with developers?▼

You can share Penpot design system specifications with developers by using this Skill to generate a comprehensive, portable DESIGN.md markdown file that documents colors, typography, and components for your team.