theming

Generate and apply OKLCH color themes with WCAG AA contrast compliance.

Updated Jan 17, 2026
One-click install
npx skills add https://github.com/PerceptLabs/wiggum --skill theming-perceptlabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: theming
Source: https://github.com/PerceptLabs/wiggum/tree/main/apps/ide/src/skills/theming
Command: npx skills add https://github.com/PerceptLabs/wiggum --skill theming-perceptlabs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the creation and application of sophisticated color themes using the OKLCH color model, ensuring design consistency and accessibility across your project.

Core Features & Use Cases

  • Theme Generation: Create custom themes from scratch using presets, sacred geometry patterns, or mood-based briefs.
  • Design Token Management: Generates a structured .ralph/tokens.json file with all design variables, contrast ratios, and personality data.
  • Use Case: Quickly apply a "retro-arcade" theme to your web application, ensuring all colors, fonts, and shadows align with the chosen aesthetic, and then easily modify it to fit your brand's specific needs.

Quick Start

Apply the 'retro-arcade' preset theme to your project.

Frequently Asked Questions about theming

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

FAQPage Schema
How do I generate OKLCH color themes for a web project?

You can generate OKLCH color themes using presets, sacred geometry patterns, or mood-based briefs. The system outputs a structured tokens file containing all design variables, contrast ratios, and personality data for direct application to your web project.

Does this theming tool work with Tailwind CSS v4?

Yes, this approach integrates with Tailwind CSS v4 to enable dynamic theming. It automatically applies generated OKLCH color palettes to your project, managing design tokens, font pairings, shadow profiles, and radius settings directly within the framework.

How are WCAG AA contrast ratios handled when generating design tokens?

WCAG AA contrast compliance is ensured automatically during the OKLCH theme generation process. The system calculates and embeds specific contrast ratios within the structured design tokens file, verifying foreground and background colors meet accessibility standards.

What is the best way to manage design tokens for multiple UI components?

Managing design tokens is best handled by generating a centralized `.ralph/tokens.json` file. This file consolidates all design variables, font pairings, shadow profiles, radius settings, and contrast ratios to maintain visual consistency across multiple UI components.

Can I customize an existing preset theme to fit my brand's specific needs?

Yes, you can apply a preset theme and easily modify it to fit your brand's specific needs. You can use mood-based customization and CLI commands to adjust colors, fonts, and shadows until the aesthetic aligns with your requirements.

How do I perform detailed design analysis on my generated CSS theming configuration?

Perform detailed design analysis on your CSS theming configuration using dedicated CLI commands. These commands evaluate your generated OKLCH color themes, design tokens, and overall aesthetic alignment to provide actionable feedback on your project.