penpot-audit-tokens

Audit Penpot designs for token governance issues and generate severity reports.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the audit of Penpot designs for design-system governance issues, such as hardcoded colors, off-grid spacing, orphan/unresolved/unused tokens, and duplicated values, producing a severity report with suggested semantic-token swaps.

Core Features & Use Cases

  • Design System Governance: Audits Penpot designs for token governance issues, including hardcoded colors, off-grid spacing, orphan/unresolved/unused tokens, and duplicated values.
  • Report Generation: Produces a severity report with suggested semantic-token swaps for hardcoded values and off-grid spacing issues.
  • Use Case: Imagine you have a Penpot design with potential governance issues. Use this Skill to audit the design and receive a report with suggested fixes to ensure design system consistency.

Quick Start

Run the 'penpot-audit-tokens' skill to audit your Penpot design for design system governance issues.

Frequently Asked Questions about penpot-audit-tokens

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

FAQPage Schema
How do I audit Penpot designs for hardcoded colors and off-grid spacing?▼

To audit Penpot designs for hardcoded colors and off-grid spacing, use an automated governance audit tool that scans your files and generates a severity report with suggested semantic-token swaps for unresolved or unused tokens.

What is design system governance in Penpot and how does an audit work?▼

Design system governance in Penpot ensures consistency by managing tokens. An audit mechanism scans designs to identify duplicated values and orphan tokens, producing a severity report with suggested fixes.

Do I need Penpot MCP to run a design token audit?▼

Yes, you need the Penpot MCP to run a design token audit. The process also requires access to your design system tokens and schemas to identify unresolved references and suggest semantic swaps.

How do I fix orphan and unresolved tokens in my Penpot design files?▼

To fix orphan and unresolved tokens in Penpot, run an automated audit that detects these governance issues. The audit generates a severity report with suggested semantic-token swaps to resolve duplicates.

What is the best way to generate a severity report for Penpot design system issues?▼

The best way to generate a severity report for Penpot design system issues is to automate the audit process. This identifies hardcoded colors and spacing issues, providing suggested token swaps directly in the output report.