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.