skills.rest
jeremysball
jeremysballCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

pi-theme-creator

Create, validate, and manage JSON color themes for the Pi coding agent TUI.

Updated Nov 7, 2024
Search Tags:#validation#color palette#json#theme#terminal ui#pi coding agent#tui customization
One-click install
npx skills add https://github.com/jeremysball/dotfiles --skill pi-theme-creator-jeremysball
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pi-theme-creator
Source: https://github.com/jeremysball/dotfiles/tree/main/.pi/skills-archive/pi-theme-creator
Command: npx skills add https://github.com/jeremysball/dotfiles --skill pi-theme-creator-jeremysball

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, imagemagick, and includes scripts (resource) components.

What problem does it solve? Building a custom theme for the Pi coding agent's terminal UI requires defining 51 color tokens across seven categories, and missing or invalid tokens cause broken rendering. This Skill provides scaffolding scripts, validation, previews, and ready-made templates so themes can be created and verified without memorizing the schema. ## Core Features & Use Cases - Theme scaffolding and templates: Generate a complete starter theme with create-theme.sh or install pre-built Catppuccin Mocha, Gruvbox Dark, or Nord palettes with install-template.sh. - Validation and preview: Check a theme file for all 51 required tokens and valid color values with validate-theme.sh, and inspect resolved token values with preview-theme.sh. - Palette extraction: Pull dominant colors from an image with extract-colors.sh to base a new theme on a wallpaper or inspiration image. - Use Case: You want a Nord-style look in Pi. Run the template installer, validate the result, activate it via /settings, then edit the JSON while Pi runs and watch hot reload apply your tweaks live. ## Quick Start Ask the agent to create a new Pi theme named ocean-blue, validate it, and show a preview of its color tokens.

Frequently Asked Questions about pi-theme-creator

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

FAQPage Schema
How do I create a custom theme for the Pi coding agent?▼

Run create-theme.sh with a lowercase hyphenated name to generate a complete starter theme in ~/.pi/agent/themes. Then edit the JSON color tokens, validate with validate-theme.sh, and activate it through /settings in Pi.

How do I validate a Pi theme JSON file?▼

Run validate-theme.sh with the path to your theme file. It checks JSON syntax, verifies all 51 required color tokens exist, and flags invalid color values such as malformed hex codes or unknown variable references.

What color formats does a Pi theme support?▼

Pi themes accept 6-digit hex values like #ff0000, xterm 256-color palette numbers from 0 to 255, references to entries in the theme's vars section, and an empty string for the terminal default color.

Can I extract theme colors from an image?▼

Yes, extract-colors.sh uses ImageMagick to pull dominant colors from an image and suggests accent, background, success, error, and warning candidates. ImageMagick must be installed separately; the other scripts only need jq and python3.

Why is my Pi theme not loading or hot reload not working?▼

Confirm the file is valid JSON with jq, that the theme name is unique, and that all 51 tokens are present. Hot reload only applies to the currently active theme file, so verify the file is saved and selected in /settings.

Related Skills

Explore More Software Engineering Skills→
olafkfreundolafkfreund
21

stylix

Apply unified color palettes and wallpaper-derived themes across NixOS configurations.

Community
Advanced
wcyganwcygan
193

zed-config

Modifies Zed config files to apply themes, fonts, keybindings, and language server settings.

Community
Intermediate
launchapp-devlaunchapp-dev
38

color-system

Generate scalable color palettes with accessibility compliance and dark mode mappings.

Official
Advanced
cromesdkcromesdk

angular-tailwind-theme-design

Implement Angular 20 and Tailwind CSS v4 light/dark theme systems with semantic tokens.

Official
Intermediate