Agent skill

Pierre Theming Library

by pierrecomputer in pierrecomputer/pierre

Explains how to use the @pierre/theming package to list, resolve, select, switch and persist themes, with controller, color and React references.

Apache-2.0Auto-check passedFrontend & Design

Install Pierre Theming Library

skills CLI
$ npx skills add pierrecomputer/pierre --skill theming -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install pierrecomputer/pierre theming --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/pierrecomputer/pierre.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/theming .claude/skills/theming && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
theming
GitHub stars
6.2k
Token cost
~661 tokens
SKILL.md length
163 words
Files
10 (incl. references)
Skills in repo
10
Repo updated
First seen
Licence
Apache-2.0

At a glance

Explains how to use the @pierre/theming package to list, resolve, select, switch and persist themes, with controller, color and React references.

  • Adding theme switching with light and dark color modes to an app
  • SKILL.md covers Install, Select an API reference, Select a controller recipe and Select a framework recipe
  • Calls pnpm
  • Persisting the user's selected theme

What it does

The `@pierre/theming` package manages runtime themes and splits the work into theme metadata, theme resolution, selected state and UI color mapping. The skill covers installing it with pnpm and adding optional peer dependencies only for the entry you use: `react` for the React entry, and `@pierre/theme`, `@shikijs/themes` and `shiki` for the themes entry.

Short tables point to the right reference for each need: collections for catalogs and bundled theme sets, the resolver for registering, loading and caching theme objects, the controller for tracking color mode and the selected light and dark themes, the colors API for normalizing workbench colors, and the React API for reading controller state. Recipes show one controller as the default, multiple controllers only when areas need different theme state, and separate setups for vanilla JavaScript and React.

When your agent uses it

  • Adding theme switching with light and dark color modes to an app
  • Persisting the user's selected theme
  • Reading theme state in React components
  • Registering and loading bundled Pierre or Shiki theme collections

Example prompts

  • “Set up @pierre/theming in my React app with one controller shared across the page.”
  • “Give the preview pane its own theme selection separate from the editor using multiple controllers.”
  • “Install the packages needed for the Shiki theme collection.”

Requirements

  • `@pierre/theming`, installed with pnpm
  • `react` for the React entry

What it can do on your machine

Read from SKILL.md and the folder at commit d302ea0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pnpm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pnpm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Pierre Theming Library loads about 661 tokens when it runs, and up to ~5k if it reads all its reference files. Until then it costs about 53 tokens; SKILL.md has 163 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~53
When it runs · the whole SKILL.md, loaded when a task matches
~661
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from pierrecomputer/pierre at commit d302ea0, republished under its Apache-2.0 licence (© pierrecomputer). 163 words, ~661 tokens.

Download SKILL.mdSave it as .claude/skills/theming/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
theming
description
Use when an app uses @pierre/theming to list, resolve, select, switch, persist, or apply themes, including color modes, theme controllers, React state, UI colors, and bundled Pierre or Shiki collections.

@pierre/theming

Use @pierre/theming to manage runtime themes. The package separates theme metadata, theme resolution, selected state, and UI color mapping.

Install

bash
pnpm add @pierre/theming

Install optional peer dependencies only for the selected entry. The React entry needs react. The themes entry needs @pierre/theme, @shikijs/themes, and shiki.

Select an API reference

NeedReference
Create a collection, catalog, descriptor, or bundled theme setCollections API
Register, load, seed, or cache theme objectsResolver API
Track the color mode and selected light and dark themesController API
Normalize workbench colors or derive colorsColors API
Read controller state in ReactReact API

Select a controller recipe

SituationRecipe
One app or page shares one color mode and one light/dark selectionUse one controller
Independent areas need separate selections or separate controller lifecyclesUse multiple controllers

Use one controller by default. Use multiple controllers only when the theme state must differ between areas.

Select a framework recipe

HostRecipe
Vanilla JavaScript or another frameworkUse vanilla JavaScript
ReactUse React

© pierrecomputer, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 9 other files (references) in skills/theming of pierrecomputer/pierre.

  • SKILL.md
  • references/collections.md
  • references/colors.md
  • references/controller.md
  • references/react.md
  • references/recipe-multiple-controllers.md
  • references/recipe-one-controller.md
  • references/recipe-react.md
  • references/recipe-vanilla.md
  • references/resolver.md

Open the folder on GitHubat commit d302ea0

Compare with similar skills

Pierre Theming Library next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Pierre Theming Library compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pierre Theming Library this skillpierrecomputer/pierre6.2k—~661Automated safety check: PassApache-2.0
Golemuigolemui/golemui113—~2.2kAutomated safety check: PassMIT
Pixi Vn UIDRincs-Productions/pixi-vn149—~3.8kAutomated safety check: PassLGPL-2.1
Tailwindcss Developmentanonaddy/anonaddy4.9k10 repos~865Automated safety check: PassMIT
GSAP Core Animationgreensock/gsap-skills16k4 repos~3.7kAutomated safety check: PassMIT
Chakra UI v3 Builderchakra-ui/chakra-ui41k—~3.1kAutomated safety check: PassMIT

Similar skills

  • Golemui

    golemui/golemui

    Build, validate, and debug GolemUI forms in React, Angular, Vue, Lit, or vanilla JS.

    113 GitHub stars~2.2k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Pixi Vn UI

    DRincs-Productions/pixi-vn

    A skill your agent uses when building game UI (menus, HUD, dialogue box, settings/save screens) on top of Pixi'VN with an external JS framework (React, Vue) or with plain PixiJS components —…

    149 GitHub stars~3.8k tokensUpdated 6 days ago
    Frontend & DesignAuto-check passed
  • Tailwindcss Development

    anonaddy/anonaddy

    Always invoke when the user's message includes 'tailwind' in any form.

    4.9k GitHub starsUsed in 10 repos~865 tokens
    Frontend & DesignAuto-check passed
  • GSAP Core Animation

    greensock/gsap-skills

    Covers the GSAP core API for tweens, easing, staggers, defaults and matchMedia, and when to choose GSAP over CSS animations or other JavaScript animation libraries.

    16k GitHub starsUsed in 4 repos~3.7k tokens
    Frontend & DesignAuto-check passed
  • Chakra UI v3 Builder

    chakra-ui/chakra-ui

    Builds responsive, accessible Chakra UI v3 components and layouts, sets up Chakra in new or existing projects, and designs themes with tokens, semantic tokens and recipes.

    41k GitHub stars~3.1k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • UI UX Pro Max

    saoudi-h/solar-icons

    UI/UX design intelligence for web and mobile. An agent skill from saoudi-h/solar-icons.

    182 GitHub starsUsed in 18 repos~11k tokens
    Frontend & DesignAuto-check: notes

More from pierrecomputer/pierre

All 10 skills in this repo
  • @pierre/diffs Code Rendering

    pierrecomputer/pierre

    Guides an agent through using @pierre/diffs to render syntax-highlighted files and diffs, and to build editing and review surfaces in React or plain JavaScript.

    6.2k GitHub starsUsed in 2 repos~803 tokens
    Auto-check passed
  • Pierre Trees File Tree

    pierrecomputer/pierre

    Use when an app uses @pierre/trees to render or control a file tree, including React, vanilla JavaScript, SSR, web components, selection, search, rename, drag…

    6.2k GitHub stars~473 tokensUpdated yesterday
    Auto-check passed
  • Pierre Highlights

    pierrecomputer/pierre

    Shows how to use @pierre/highlights for syntax-highlighted HTML or tokens, streaming and incremental tokenizing, and Zed-compatible themes with CSS variables.

    6.2k GitHub stars~409 tokensUpdated yesterday
    Auto-check passed
  • Chooses the right verification step after a code change in Pierre's monorepo: format and lint, a typecheck, Bun unit tests, snapshots, or Playwright E2E.

    6.2k GitHub stars~608 tokensUpdated yesterday
    Auto-check passed
  • Pierre Theme Package

    pierrecomputer/pierre

    Shows an agent how to install and use the @pierre/theme package, which ships ten Pierre light and dark color themes for Shiki and VS Code.

    6.2k GitHub stars~352 tokensUpdated yesterday
    Auto-check passed
  • Sets one monorepo's rules for toolchain pins, pnpm package operations, the shared dependency catalog and moon tasks, so the agent adds versions and scripts the right way.

    6.2k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed

Questions about Pierre Theming Library

What does Pierre Theming Library do?

Explains how to use the @pierre/theming package to list, resolve, select, switch and persist themes, with controller, color and React references. The `@pierre/theming` package manages runtime themes and splits the work into theme metadata, theme resolution, selected state and UI color mapping. The skill covers installing it with pnpm and adding optional peer dependencies only for the entry you use: `react` for the React entry, and `@pierre/theme`, `@shikijs/themes` and `shiki` for the themes entry.

When should I use Pierre Theming Library?

Pierre Theming Library fits situations like: adding theme switching with light and dark color modes to an app; persisting the user's selected theme; reading theme state in React components; registering and loading bundled Pierre or Shiki theme collections.

How do I install Pierre Theming Library in Claude Code?

Run `npx skills add pierrecomputer/pierre --skill theming -a claude-code`. Or copy the skill folder (skills/theming in pierrecomputer/pierre) into .claude/skills/theming in your project. Claude Code loads it when a task matches its description.

How do I install Pierre Theming Library in Codex?

Run `npx skills add pierrecomputer/pierre --skill theming -a codex`. Or copy the skill folder (skills/theming in pierrecomputer/pierre) into .agents/skills/theming in your project. Codex loads it when a task matches its description.

Can I use Pierre Theming Library in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pierrecomputer/pierre --skill theming -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/theming, .gemini/skills/theming, .github/skills/theming and .opencode/skills/theming in your project.

What does Pierre Theming Library need to run?

Going by SKILL.md and its folder, Pierre Theming Library needs the command-line tools its instructions call (pnpm). Our summary lists: `@pierre/theming`, installed with pnpm; `react` for the React entry.

Does Pierre Theming Library access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Pierre Theming Library safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Pierre Theming Library use?

Pierre Theming Library is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Pierre Theming Library use?

About 661 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4.4k tokens, read only when the agent opens those files.

What are the alternatives to Pierre Theming Library?

Skills that share tags, products or a category with Pierre Theming Library: Golemui (golemui/golemui, 113 stars), Pixi Vn UI (DRincs-Productions/pixi-vn, 149 stars), Tailwindcss Development (anonaddy/anonaddy, 4.9k stars) and GSAP Core Animation (greensock/gsap-skills, 16k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pierre Theming Library?

pierrecomputer (a GitHub organization) maintains it in pierrecomputer/pierre, which has 6,243 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 6, 2026.

Source: pierrecomputer/pierre on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.