workflow-review

What problem does it solve?

A broken or inefficient design token pipeline (Figma→YAML→CSS→Tailwind→Components) can lead to manual errors, generation failures, and inconsistent outputs. This Skill provides a comprehensive evaluation of your entire design token workflow, ensuring reliability and preventing costly build issues.

Core Features & Use Cases

• Pipeline Integrity Check: Reviews the complete token transformation flow from design-tokens.yml to generated CSS and Tailwind utilities.
• Auto-generation Verification: Ensures generate-theme-css.ts mappings are complete and accurately reflect YAML definitions.
• Manual Edit Detection: Identifies any manual changes in generated CSS files that could be overwritten, flagging potential maintenance traps.
• Validation Coverage Analysis: Pinpoints gaps in existing validation scripts and recommends new ones to enhance quality assurance.
• Build Process Health: Tests and analyzes the health and reliability of all build commands (pnpm build:prepare, pnpm build:prod:app).
• Use Case: Investigate why new design tokens aren't appearing as Tailwind utilities in your components, identifying missing mappings in the generation script or manual edits in generated CSS.

Quick Start

Use the workflow-review skill to audit the token pipeline and build process for the entire design system.