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.