veta-design-md

Generate DESIGN.md from globals.css and layout.tsx token values.

1|Updated Nov 26, 2025
One-click install
npx skills add https://github.com/marcogonzalo/studio-manager --skill veta-design-md
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: veta-design-md
Source: https://github.com/marcogonzalo/studio-manager/tree/main/.agents/skills/veta-design-md
Command: npx skills add https://github.com/marcogonzalo/studio-manager --skill veta-design-md

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents design drift by generating and maintaining Veta’s single source of truth, DESIGN.md, directly from the current CSS variables and typography configuration so the UI matches the intended brand identity.

Core Features & Use Cases

  • Design System Generation: Creates a DESIGN.md file at the project root with YAML tokens (colors, typography, spacing, component styles) plus explanatory rationale.
  • Automatic Regeneration from Source of Truth: Reads src/styles/globals.css and src/app/layout.tsx to extract the latest tokens and font configuration before writing.
  • Update Triggers for Brand/Visual Changes: Refreshes DESIGN.md when typography or palette changes occur, or when users request design documentation updates.

Quick Start

Run the veta-design-md skill to generate DESIGN.md from the current values in globals.css and layout.tsx.

Frequently Asked Questions about veta-design-md

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

FAQPage Schema
How do I generate a design system spec from CSS variables and typography files?

You generate a design system spec by reading `globals.css` and `layout.tsx` to extract tokens, converting oklch values to hex, and writing a structured DESIGN.md file with YAML tokens and rationale.

What is a DESIGN.md file and how does it prevent design drift?

A DESIGN.md file is a single source of truth for brand identity that prevents design drift by documenting color palettes, typography, and spacing directly from current source files. It ensures UI matches the intended brand identity.

How do I convert oklch color values to hex for YAML design tokens?

You convert oklch color values to hex for YAML design tokens by processing the extracted light and dark token values from `globals.css` during the DESIGN.md generation workflow.

Can I update design documentation automatically after changing a color palette?

Yes, you can update design documentation automatically after changing a color palette. The Skill regenerates the DESIGN.md file by re-reading the updated `globals.css` and `layout.tsx` source files to capture the latest token values.

Does this design system generator work without external dependencies?

Yes, this design system generator works without external dependencies. It operates entirely by reading local `src/styles/globals.css` and `src/app/layout.tsx` files to produce the design specification document.

When should I regenerate a design system markdown file?

You should regenerate a design system markdown file when typography or palette changes occur in the source files, or when you need to produce updated design documentation for other agents or developers referencing the brand identity.