reversa-design-system

Extract design tokens from CSS and theme files into categorized markdown documentation.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/afsjr/secretaria_escola_csm --skill reversa-design-system-afsjr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reversa-design-system
Source: https://github.com/afsjr/secretaria_escola_csm/tree/main/.agents/skills/reversa-design-system
Command: npx skills add https://github.com/afsjr/secretaria_escola_csm --skill reversa-design-system-afsjr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the uncertainty of how the legacy project’s UI was styled by automatically extracting and documenting design tokens from available source styles and visual evidence.

Core Features & Use Cases

  • Design token extraction: Extracts colors, typography, spacing, radii, shadows, z-index, transitions, and easing from CSS/theme files and token artifacts.
  • Multi-source reconciliation: Uses configuration files (e.g., Tailwind theme) and UI theme definitions (e.g., MUI/Chakra/Mantine) and can optionally corroborate with screenshots.
  • Project-ready outputs: Generates structured markdown deliverables such as color palette, typography, spacing, and consolidated design-system documentation in the configured output folder.

Quick Start

Use the reversa-design-system skill to generate the design-system documentation in your configured output folder based on the legacy project’s available CSS and theme sources.

Frequently Asked Questions about reversa-design-system

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

FAQPage Schema
How do I extract design tokens from a legacy CSS project?

To extract design tokens from a legacy CSS project, this Skill reads available style files and theme definitions to pull colors, typography, spacing, radii, shadows, z-index, transitions, and easing into structured markdown documentation.

Can I generate design system documentation from Tailwind or MUI theme files?

Yes, you can generate design system documentation from Tailwind, MUI, Chakra, or Mantine theme files. The Skill reconciles multiple configuration sources and optionally corroborates the extracted tokens with project screenshots.

What is the best way to document a legacy UI color palette and typography?

The best way to document a legacy UI color palette and typography is to automatically extract CSS variables and theme configurations, mapping the design primitives into categorized markdown deliverables in your output folder.

Does design token extraction work without source code if I only have screenshots?

Design token extraction primarily requires source style files or theme definitions to function accurately. Screenshots are used optionally to corroborate visual evidence alongside the extracted CSS variables and UI theme definitions.

How do I consolidate CSS variables into a unified design token table?

You can consolidate CSS variables into a unified design token table by running this Skill, which reads your configured output folder from state.json and maps design primitives into palettes, typography, spacing, and a consolidated table.