theme

What This Skill Does

The theme skill is a powerful command-line interface (CLI) utility designed for seamless UI color management. It enables developers and designers to create, preview, modify, and export complete color themes. By leveraging a centralized JSONL data store located at ~/.theme/data.jsonl, the skill ensures persistence across sessions. It supports advanced features such as automatic dark/light mode conversion, harmonious palette generation, and multi-format exports including CSS, SCSS, JSON, and Tailwind configurations. This tool bridges the gap between raw color values and production-ready design tokens.

Installation

To integrate this skill into your environment, use the OpenClaw agent installer:

clawhub install openclaw/skills/skills/bytesagain/theme

Ensure you have Python 3.8+ installed on your system, as the underlying scripts utilize standard Python libraries for color manipulation and file handling.

Use Cases

• Rapid Prototyping: Quickly generate random themes or derive complementary palettes to iterate on UI designs without manually calculating hex codes.
• Design Systems: Maintain consistency by defining primary, secondary, and functional colors, then exporting them directly into your project's CSS or Tailwind configuration files.
• Accessibility Compliance: Use the tool to generate high-contrast light or dark mode variants from a base theme, ensuring your applications remain accessible in different environments.
• Theme Management: Keep track of multiple variations of a branding kit within one standardized workflow, using the CLI to preview or apply them globally.

Example Prompts

1. "Create a new light mode theme named 'corporate' with primary color #2D3436 and secondary #0984E3, then export it as a Tailwind configuration file."
2. "Generate a triadic color palette based on #6C5CE7 and save the resulting colors into a new theme called 'triadic-test'."
3. "List all saved themes in table format, filter for only dark mode variants, and generate an HTML preview for the 'midnight' theme."

Tips & Limitations

• Backups: Since the skill writes to ~/.theme/data.jsonl, it is recommended to periodically back up this file to prevent data loss.
• Scope: The skill is designed for programmatic UI color management. While it excels at theme generation, it does not apply these themes to live browser UIs or desktop environments directly without custom integration via the 'apply' command.
• Dependencies: The scripts/script.sh wrapper is essential for executing the underlying Python logic. Ensure the script has execute permissions (chmod +x scripts/script.sh) in your environment.