create-ui-theme
/create-ui-theme
Create a new drop-in UI theme skill (e.g. Material 3, Fluent 2, visionOS, a brand's own design system) using the same structure as the macOS Liquid Glass theme - researched specs file, token + component CSS, optional behaviour script, live gallery, theme.json manifest and installer. Use when the user wants a new theme, a new design-system skill, or to turn an existing look into a reusable theme.
- Author
- dayztoolsforu ↗
- Repository
- ui-themes ↗
- Licence
- MIT
- Last repository change
- 03.11.2026
Assessment and security
- Files in this package
- 8
- Scripts
- 1
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 03.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 1 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: template/scripts/apply-theme.mjs
What it does and when to use it
Create a new drop-in UI theme skill (e.g. Material 3, Fluent 2, visionOS, a brand's own design system) using the same structure as the macOS Liquid Glass theme - researched specs file, token + component CSS, optional behaviour script, live gallery, theme.json manifest and installer. Use when the user wants a new theme, a new design-system skill, or to turn an existing look into a reusable theme.
Original author description
Create a new drop-in UI theme skill (e.g. Material 3, Fluent 2, visionOS, a brand's own design system) using the same structure as the macOS Liquid Glass theme - researched specs file, token + component CSS, optional behaviour script, live gallery, theme.json manifest and installer. Use when the user wants a new theme, a new design-system skill, or to turn an existing look into a reusable theme.
How it works
- Steps
- Lessons from building Liquid Glass
SKILL.md preview
--- name: create-ui-theme description: Create a new drop-in UI theme skill (e.g. Material 3, Fluent 2, visionOS, a brand's own design system) using the same structure as the macOS Liquid Glass theme - researched specs file, token + component CSS, optional behaviour script, live gallery, theme.json manifest and installer. Use when the user wants a new theme, a new design-system skill, or to turn an existing look into a reusable theme. --- # Create a UI theme skill Every theme in this plugin has the same shape, so it can be applied with one command and judged against one gallery. `macos-liquid-glass` (sibling skill) is the reference build — read it when unsure how something is done. ``` skills/<theme-id>/ SKILL.md when to use it, how to apply it, the platform's rules theme.json id, class prefix, drop-in files, init call assets/<id>.css tokens (light / dark / increased contrast) + every component assets/<id>.js optional: behaviour the CSS can't do (optics, morphing, physics) assets/gallery.html every component, live, with theme + background switches references/specs.md researched values, each marked V (stated by the source) or E (estimate) references/frameworks.md wiring for HTML, React, Vue, Svelte, Electron scripts/apply-theme.mjs installer (copy unchanged from template/) ``` ## Steps 1. **Name it.** Pick `id` (kebab-case) and a 2–3 letter class prefix that no other theme uses (`lg-` is Liquid Glass). Copy `template/` to `skills/<id>/`, rename `SKILL.template.md` to `SKILL.md` and fill the placeholders. 2. **Research before drawing.** Read the platform's own design guidance and API docs (for JS-rendered doc sites, fetch the data/JSON endpoints the pages load). Run independent topics in parallel subagents: typography, colour + materials, geometry + controls, motion + interaction. Use official sample code and design kits when the user can supply them — they hold the exact numbers that prose docs leave out. Write everything into `references/specs.md`, marking each value **V** or **E**. Never put an unmarked number in the CSS. 3. **Tokens first.** In `assets/<id>.css`, define every colour, type style, size, radius, shadow and motion curve as a `--<prefix>` token: light values on `:root`, dark under `prefers-color-scheme` *and* `[data-theme="dark"]`, increased contrast under `prefers-contrast: more`. Springs become CSS `linear()` curves sampled from the platform's spring parameters, paired with their settle time. 4. **Components.** Build each one from tokens only: window/shell, navigation, toolbar, buttons in every size and role, inputs, selection controls, menus, popovers, dialogs, lists, cards. Class names `.<prefix>-<thing>`, modifiers `--<variant>`. Respect reduced motion, reduced transparency and increased contrast in the same file. 5. **Behaviour script only if needed.** If the platform has effects CSS can't express, put them in `assets/<id>.js` behind one global (`window.<Name>`) with `init(root)` that is safe to call twice. Listen on the real event source, fade with `opacity`/`transform`, and keep per-frame work proportional to what is moving. 6. **Gallery.** Every component, live and interactive, over backgrounds that show the material off, with theme (auto/light/dark) switches and an autoplay for animations. Behave like an app: no text selection or dragging outside inputs. 7. **Verify** with a headless Chromium: light + dark, 1× + 2×, an on-page error overlay, and crops of each section. Capture animations mid-motion as well as at rest. Fix, then look once more. 8. **Ship.** Fill `theme.json`, copy `scripts/apply-theme.mjs` and test it on an empty folder, bump the plugin version in `.claude-plugin/plugin.json` and `marketplace.json`, run `claude plugin validate .` at the plugin root, and add the theme to the README. ## Lessons from building Liquid Glass - Prose docs rarely give pixel values; say which numbers are estimates instead of guessing silently. - The OS accessibility settings change what you see: Windows "Transparency effects" off reports `prefers-reduced-transparency`. Give previews an explicit override attribute; never ship it on. - Don't transition registered custom properties for visible effects; they can stall at their start value. Animate `opacity` and `transform` instead. - Never lower the output resolution of masks or highlights mid-animation: edges go fuzzy and pop when they sharpen again. Sample the shape coarser instead and interpolate. - Never rebuild raster maps (canvas + PNG data URLs) per frame: trace animated outlines to vector paths and use them as an SVG mask; clip-path clips ackdrop-filter only to its bounding box in Chromium. - A material can't see through another: `backdrop-filter` makes an element the backdrop for its children, so never nest translucent surfaces (menus inside toolbar groups); hang them off a common parent. - No plates under icons on a material: hover/press as light fading to transparent. - Refraction maps must never fold: keep |d(shift)/d(distance)| < 1 (scale the lens to the bezel) and cap the shift in corners by the edge's local curvature radius, or corners and edges smudge. A strict physical profile is too steep. - A pseudo-element that switches role when JS loads (rim fallback → glow) must not inherit a fade during the switch; enable the transition a frame after. - Shapes that warp need room: draw them in an overhanging box so bulges and overshoot aren't clipped. - Animate sizes through springs on the shape, not CSS width/height on the element, when the platform's material is meant to deform. - Headless screenshots: blank frames after scripted scrolling or in short windows, frozen `performance.now()` under virtual time, and slow `requestAnimationFrame`. Use tall windows and crop; judge timing in a real browser. - Platform fonts (SF Pro, Segoe UI Variable, Roboto Flex) have their own licences: use system font stacks, never embed a font the licence doesn't allow. - Don't imitate the platform owner's branding: no logos, trademarked icon sets or pixel copies of their apps. The theme is "in the style of".
Files in this package (8)
- SKILL.md 6 KB
- template/SKILL.template.md 2 KB
- template/theme.json 1 KB
- template/assets/gallery.html 2 KB
- template/assets/theme.css 3 KB
- template/references/frameworks.md 1 KB
- template/references/specs.md 1 KB
- template/scripts/apply-theme.mjs 3 KB
Versions
The database has no other skills named create-ui-theme.
Database snapshot: 13.11.2026 · package version 7747aa0b8e3e (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 85design-add-theme
Add one new theme (a light+dark pair) to a finished design system: optionally distill fresh references, seed a complete token strawman via the theme-drafter subagent (kept a deliberate sibling of the existing themes), refine Socratically with prototype loops, write the two theme… - 90macos-liquid-glass
Drop-in macOS 26 "Liquid Glass" theme for web UI (HTML/CSS/JS, React, Vue, Electron) - floating translucent toolbars, sidebars, capsule buttons, menus, popovers, sheets, window chrome, macOS text styles and system colours, real edge refraction, rim highlights, pointer glow, and… - 100apex-theme-material
Restyle an Oracle APEX app to look like the Setproduct Material Design System kit (classic Material Design (material.io): Roboto + Red Hat Display, elevation shadows, 4px radii) using native Universal Theme components plus a drop-in CSS file. Use when the user asks for the… - 100apex-theme-material-you
Restyle an Oracle APEX app to look like the Setproduct Material You kit (Material Design 3 with Tailwind palette and Readex Pro: tonal surfaces, pill buttons) using native Universal Theme components plus a drop-in CSS file. Use when the user asks for the Material You… - 10021st-design-sync
Look at the current project's design (its shadcn / Tailwind CSS variables and color tokens) and publish it to the 21st.dev community as a shareable theme, using `21st publish-theme`. Use when the user says "publish my theme", "share our design as a 21st theme", "sync my design… - 95preline-theme-generator
Generate, preview, save, or validate Preline theme CSS using the bundled local generator in this skill. Use when the user asks to create a new Preline theme, match a brand color, translate a mood into a theme, generate light and dark theme CSS, preview theme output without…