# Valaxy Theme

Create or evolve a runnable Valaxy theme from a design brief, reference site, or UI...

- Repository: https://github.com/YunYouJun/valaxy (1131 stars)
- Category: Design
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add YunYouJun/valaxy --skill valaxy-theme -g -a claude-code -y`
Codex: `npx skills add YunYouJun/valaxy --skill valaxy-theme -g -a codex -y`
Cursor: `npx skills add YunYouJun/valaxy --skill valaxy-theme -g -a cursor -y`
Gemini CLI: `npx skills add YunYouJun/valaxy --skill valaxy-theme -g -a gemini-cli -y`

## Description

Create or evolve a runnable Valaxy theme from a design brief, reference site, or UI library. Use for valaxy-theme-* packages, AI theme generation, theme starter customization, or adapting AK UI to a Valaxy blog. Covers theme contracts, demo content, packaging, SSR and browser verification. Use the general valaxy Skill for site configuration or article editing without theme development.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Valaxy theme authoring

Turn the user's visual direction into a source-distributed theme and a working demo. Read [the theme contract](references/theme-contract.md) before changing rendering or package entrypoints. Read [the AK UI recipe](references/ak-ui.md) only when the user chooses AK UI or an Arknights-inspired theme.

## Skill and brief have different roles

This Skill supplies reusable framework knowledge and the development/verification workflow. The user's brief supplies this task's theme name, audience, visual direction, required pages and constraints. A brief generated by the docs is ordinary task input: preserve its choices, without treating its preset as a mandatory theme architecture. Do not ask the user for a second, full engineering prompt when this Skill is available.

For a new theme, establish the package/demo baseline and implement the reading experience. For an existing theme, inspect the requested change and preserve unrelated behavior, package identity and content. Do not re-run initialization or regenerate the whole theme for an iteration. Scale validation to what changed: style edits need affected-page checks; rendering, dependencies or exports need the corresponding build/package checks.

## Establish the baseline

The rest: https://github.com/YunYouJun/valaxy/blob/HEAD/skills/valaxy-theme/SKILL.md