penpot-foundations

Manage and infer token systems for Penpot design foundations.

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

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, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a foundation for building and governing the token + library foundation of a Penpot design system. It helps manage primitive, semantic, and component token tiers, themes (light/dark), and inferring a token system from an existing hardcoded design.

Core Features & Use Cases

  • Token Management: Create, manage, and organize tokens across primitive, semantic, and component levels.
  • Theme Development: Build and maintain light and dark mode themes.
  • Inference from Hardcoded Designs: Automatically infer token systems from existing hardcoded designs.
  • Use Case: If you have a design with hardcoded values and want to transition to a token-based system, this Skill can help you automate the process of inferring and organizing tokens.

Quick Start

To get started, execute the penpot-foundations Skill and follow the workflow outlined in the documentation.

Frequently Asked Questions about penpot-foundations

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

FAQPage Schema
How do I transition a hardcoded Penpot design to a token-based system?

You can transition a hardcoded Penpot design to a token-based system by using the inference feature to automatically infer and organize primitive, semantic, and component tokens from existing design values. This automates extracting hardcoded styling and mapping it to structured token tiers.

How do I manage primitive, semantic, and component tiers in a design system?

Managing primitive, semantic, and component tiers in a design system involves creating and organizing tokens across these three distinct levels. This Skill provides the framework to structure these tiers systematically, ensuring scalable token architecture governance within Penpot.

Can I build light and dark mode themes using Penpot tokens?

Yes, you can build and maintain light and dark mode themes using Penpot tokens. The Skill supports theme development by mapping semantic and component tokens to different theme contexts, allowing consistent UI adaptation across light and dark modes.

What is the best way to infer a design system from existing hardcoded values?

Inferring a design system from existing hardcoded values is best handled by automatically detecting hardcoded styling properties and mapping them to primitive, semantic, and component token tiers. This establishes a structured token foundation without manual token creation.

Do I need shared references to govern a Penpot design system foundation?

Yes, governing a Penpot design system foundation requires shared references like the penpot-mcp-tool-reference, plugin-api-gotchas, tokens-schema, naming-conventions, and state-management to ensure proper execution and structural integrity.

Are there limitations when inferring tokens from hardcoded designs in Penpot?

When inferring tokens from hardcoded designs in Penpot, limitations may arise from complex or undocumented styling structures that do not cleanly map to primitive, semantic, and component token tiers, requiring manual adjustment to achieve a coherent token system.