AThevon/genjutsu / skills/_jutsu/ui-ux-pro-max
ui-ux-pro-max
UnverifiedUI/UX design-system intelligence - 84 styles, 192 palettes, 74 font pairings, 25 charts, 99 UX guidelines across 22 stacks (searchable dataset + CLI). Internal genjutsu module: loaded by /genjutsu:cast and /genjutsu:paint, not invoked directly.
UPSTREAM.md
View on GitHub# Upstream: ui-ux-pro-max
The `ui-ux-pro-max` sub-skill's dataset, references and search engine are **vendored**
from an external open-source project.
- **Source**: [nextlevelbuilder/ui-ux-pro-max-skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill),
in that repo at `.claude/skills/ui-ux-pro-max/`.
- **License**: MIT, Copyright (c) 2024 Next Level Builder. Their permission notice is
vendored at [`LICENSE-upstream.txt`](./LICENSE-upstream.txt) and is referenced from the
repository root `LICENSE`. It covers the vendored `data/`, `scripts/` and `references/`.
- **Synced to**: upstream **v2.11.1**, verified 2026-09-08 by comparing git blob hashes
file by file, not by reading a version string.
## What "v2.11.1" means, precisely
Every vendored file - `data/` (all CSVs), `scripts/` (`core.py`, `design_system.py`,
`search.py`, `validate_data.py`, `tests/`) and `references/` (`pro-rules.md`,
`quick-reference.md`) - matches upstream's blob at tag v2.11.1.
Two things follow, and both correct what this file used to claim:
- It is **not** v2.11.0. That tag has no `references/`, no `validate_data.py` and no
`tests/`; all three arrived in v2.11.1. A sync described as v2.11.0 would have deleted
them.
- Those same blobs are **unchanged upstream through v2.14.0**. So despite the tag gap,
the vendored tree is not drifting: v2.15.0 is the first release that actually diverges.
## Divergence as of 2026-09-08 (upstream is at v2.15.0)
| Upstream change | Landed in |
|---|---|
| `core.py` grows 464 -> 993 lines | v2.15.0 |
| New `scripts/reasoning_contract.py`, imported by the other scripts | v2.15.0 |
| New data files: `catalog-summary.json`, `data-provenance.json`, `google-font-licenses.json`, `phosphor-icons-upstream.json` | v2.15.0 |
A sync is therefore a single jump from v2.11.1 to v2.15.0, and it is an engine rewrite rather
than a data refresh.
**Settled on 2026-09-08: this sub-skill is load-bearing, and the sync is worth taking when
someone has an afternoon.** It used to be an open question, because `paint` Phase 3 only loaded
this `SKILL.md` and the script ran solely if the model chose to follow the workflow described in
it. Phase 3 now invokes `search.py --design-system -f markdown` directly, with the validated
visual thesis as the query. The output was checked by hand: a coherent palette with role and CSS
variable names, a font pairing with a ready Google Fonts URL, an effects note and a list of
anti-patterns. That is real input to a design system, so the 1.8 MB this directory costs (55% of
the tracked repo) is earned rather than dead weight.
Two consequences. The eight out-of-scope stack CSVs stay: slimming them would save 184 KB and
break the clean-mirror property that makes a sync a copy instead of a merge. And a sync now has
a functional test rather than a vibe check - run the smoke test below and read the output.
`google-fonts.csv` is 728 KB, 22% of the whole repo on its own. It is a real search domain in
`core.py`, read on demand, so it costs disk and clone time rather than context. Left alone.
## Vendored vs genjutsu-authored
- **Vendored verbatim**: `data/`, `scripts/`, `references/`, `LICENSE-upstream.txt`.
- **genjutsu-authored, never overwrite on a sync**: `SKILL.md` (rewritten for genjutsu:
voice, "internal module" framing, orchestrator path resolution, no agent-run install
commands) and this file. `SKILL.md`'s dataset counts are kept in sync with the vendored
data by hand.
## Notes
- The `--persist` path-traversal hardening is upstream's `safe_slug()` (upstream PR #417).
It supersedes genjutsu's earlier standalone `safe_path_component()` fix (v3.0.2, thanks
@reevesc88, still credited in the CHANGELOG). Both close the same arbitrary-write vector.
- Eight vendored stacks (WPF, WinUI, UWP, JavaFX, Avalonia, Uno, Laravel, Angular) sit
outside genjutsu's creative-coding focus of Web / Compose / SwiftUI. They are kept so
this stays a clean mirror; the orchestrators only load this sub-skill for
design-intelligence lookups, never for per-stack detection.
## Re-syncing later
1. `gh api repos/nextlevelbuilder/ui-ux-pro-max-skill/contents/.claude/skills/ui-ux-pro-max?ref=<tag>`
to see the tree, then copy its `data/`, `scripts/` and `references/` over this folder.
2. Copy its `LICENSE` to `LICENSE-upstream.txt` as well - it can change.
3. Keep genjutsu's `SKILL.md`; update the dataset counts in its frontmatter and body
(plus `motion-principles`, and the module pages of genjutsu.athevon.dev, which live in the
site's own repository) to match the new data.
4. Verify the sync by hash rather than by tag name:
`git hash-object scripts/core.py` against
`gh api .../scripts/core.py?ref=<tag> --jq .sha`.
5. Smoke-test: `python3 scripts/validate_data.py`, then
`python3 -m unittest discover -s scripts/tests`, then
`python3 scripts/search.py "test query" --design-system`.
6. Update the "Synced to" line above with the tag and the date you verified it.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |