theo-ui

Audit, migrate, and catalog React projects using @theokit/ui components.

Updated May 13, 2026
One-click install
npx skills add https://github.com/usetheodev/theo-ui --skill theo-ui
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: theo-ui
Source: https://github.com/usetheodev/theo-ui/tree/main/skills/theo-ui
Command: npx skills add https://github.com/usetheodev/theo-ui --skill theo-ui

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Library-enabled UI design governance: ensures design tasks use the official theo-ui library, enforcing token-based styling and library composites over hand-rolled UI.

Core Features & Use Cases

  • Library-aware design: uses @theokit/ui primitives and composites to assemble UIs that conform to Violet Forge tokens.
  • Verbs: audit, migrate, catalog — enabling code audits, migrations, and component discovery across projects.
  • Safety and governance: enforces design-system rules, accessibility, responsive constraints, and the 32-gate slop-test before handoff.
  • Cross-surface compatibility: works across agent-chat, cloud-dashboard, settings-form, marketing, and auth surfaces, using shared references and design-system sources.

Quick Start

Install the theo-ui Skill and run it in a project that uses @theokit/ui to begin designing components with library-aware primitives.

Frequently Asked Questions about theo-ui

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

FAQPage Schema
How do I enforce design token fidelity when building React UI components?

You enforce design token fidelity in React UI components by using library-aware governance that audits outputs against official token systems. This skill validates that components use library primitives and Violet Forge tokens instead of hand-rolled styling.

What is a slop-test and how does it validate React component handoffs?

A slop-test is a 32-gate validation process that checks React component outputs for accessibility, responsiveness, and token compliance before handoff. It ensures assembled UIs meet design-system standards and library composite rules.

How do I migrate a React project to use a token-based component library?

To migrate a React project to token-based components, use audit and migrate workflows that identify non-compliant UI code and replace it with official library composites. This enforces design-system rules while maintaining cross-surface compatibility.

Can I use this design-system governance skill for auth and settings surfaces?

Yes, this design-system governance skill works across agent-chat, cloud-dashboard, settings-form, marketing, and auth surfaces. It uses shared references and design-system sources to ensure consistent library composites and token fidelity across all UI surfaces.

Do I need @theokit/ui installed to run component audits and catalog workflows?

Yes, you need a React project referencing @theokit/ui to use this skill effectively. The audit, migrate, and catalog workflows depend on library-aware primitives and composites from @theokit/ui to enforce token-based styling and design-system rules.

Why should I use library composites instead of custom React components?

Using library composites instead of custom React components ensures token fidelity, accessibility compliance, and responsive constraints. This approach passes a 32-gate slop-test and guarantees UI outputs conform to design-system rules before handoff, reducing maintenance overhead.