Map products had no matching product type: "GIS dashboard web map"
routed to Analytics Dashboard, "geospatial analytics platform" to
Podcast Platform, and "satellite imagery earth observation viewer"
returned nothing, so --design-system fell back to a landing-page
pattern for a map tool.
Add two product types with matching rows in products.csv, colors.csv
and ui-reasoning.csv (No 193-194):
- GIS / Web Map Dashboard: map-first layout with layer panel and linked
list, muted basemap, one UI accent, colorblind-safe data ramps.
- Earth Observation / Satellite Imagery Viewer: imagery-first layout,
neutral dark-grey chrome so imagery colors read true, date timeline,
before/after compare, perceptual index ramps.
Reasoning rows require map attribution, a legend and a text
alternative, and list rainbow ramps, hidden attribution, glass panels
over the map and raw-count choropleths as anti-patterns, in line with
the Maps rows in ux-guidelines.csv. Color tokens pass the existing
contrast contract. Provenance records cover both reasoning rows.
The product, palette and reasoning sets grow from 192 to 194, so the
row-count contract in validate_data.py, test_data_contracts.py and the
published counts move to 194. Neighbouring product queries (analytics
dashboard, delivery tracking, public transit, drone fleet, podcast
platform) keep their product type; relevance metrics are unchanged.
Co-authored-by: Khanhle19 <201531944+Khanhle19@users.noreply.github.com>
Add ten sourced guidelines for web maps (MapLibre, Mapbox GL, Leaflet,
OpenLayers) to ux-guidelines.csv, rows 121-130:
- Map Attribution Visible (Critical)
- Map Text Alternative (Critical)
- Map Keyboard and Non-Drag Navigation (High)
- Map Symbology Not Color Alone (High)
- Normalized Choropleth Map (High)
- Perceptual Map Color Ramps (High)
- Safe Map Popup Content (High)
- Cluster Dense Map Points (Medium)
- Large Geodata as Vector Tiles (Medium)
- Map Camera Reduced Motion (Medium)
The Geographic Data chart row now asks for normalized choropleths,
proportional symbols for totals, colorblind-safe ramps and visible
attribution. Provenance records cite OSMF, Mapbox, MapLibre, Leaflet,
W3C WCAG 2.2, ColorBrewer, Esri, NASA Earth Observatory and OWASP; the
map publishers are added to the official source hosts.
Generic queries ("color alone", "keyboard navigation", "reduced motion",
"dragging movements") still return the generic rows first; relevance
metrics are unchanged. UX guideline count 120 -> 130.
Distilled from the MIT-licensed gis-ui-ux-pro skill.
Co-authored-by: Khanhle19 <201531944+Khanhle19@users.noreply.github.com>
render-html.py and generate.py print emoji. With stdout or stderr on a cp1252 pipe or file (Windows without PYTHONUTF8) they raise UnicodeEncodeError. Reconfigure both streams to UTF-8, mirror the change into cli/assets via sync-assets, and add a regression test.
* test: verify IME retrieval and Enter shortcut example
* test: verify IME retrieval and Enter shortcut example
* docs: explain IME-safe Enter shortcuts and verification
* test: verify IME retrieval and Enter shortcut example
* chore: update UX guideline count in .claude/skills/ui-ux-pro-max/SKILL.md
* chore: update UX guideline count in .claude/skills/ui-ux-pro-max/data/catalog-summary.json
* feat: add IME composition Enter guidance
* chore: refresh runtime fingerprint for IME guidance
* chore: update UX guideline count in README.ko.md
* chore: update UX guideline count in README.md
* chore: update UX guideline count in README.zh.md
* chore: update UX guideline count in cli/assets/data/catalog-summary.json
* feat: add IME composition Enter guidance
* chore: refresh runtime fingerprint for IME guidance
* chore: update UX guideline count in cli/assets/templates/platforms/agent.json
* chore: update UX guideline count in cli/assets/templates/platforms/amazonq.json
* chore: update UX guideline count in cli/assets/templates/platforms/augment.json
* chore: update UX guideline count in cli/assets/templates/platforms/autoclaw.json
* chore: update UX guideline count in cli/assets/templates/platforms/claude.json
* chore: update UX guideline count in cli/assets/templates/platforms/codebuddy.json
* chore: update UX guideline count in cli/assets/templates/platforms/codewhale.json
* chore: update UX guideline count in cli/assets/templates/platforms/codex.json
* chore: update UX guideline count in cli/assets/templates/platforms/continue.json
* chore: update UX guideline count in cli/assets/templates/platforms/copilot.json
* chore: update UX guideline count in cli/assets/templates/platforms/cursor.json
* chore: update UX guideline count in cli/assets/templates/platforms/droid.json
* chore: update UX guideline count in cli/assets/templates/platforms/gemini.json
* chore: update UX guideline count in cli/assets/templates/platforms/kilocode.json
* chore: update UX guideline count in cli/assets/templates/platforms/kimi.json
* chore: update UX guideline count in cli/assets/templates/platforms/kiro.json
* chore: update UX guideline count in cli/assets/templates/platforms/openclaw.json
* chore: update UX guideline count in cli/assets/templates/platforms/opencode.json
* chore: update UX guideline count in cli/assets/templates/platforms/qoder.json
* chore: update UX guideline count in cli/assets/templates/platforms/roocode.json
* chore: update UX guideline count in cli/assets/templates/platforms/trae.json
* chore: update UX guideline count in cli/assets/templates/platforms/universal.json
* chore: update UX guideline count in cli/assets/templates/platforms/warp.json
* chore: update UX guideline count in cli/assets/templates/platforms/windsurf.json
* chore: update UX guideline count in cli/assets/templates/platforms/zcode.json
* chore: update UX guideline count in src/ui-ux-pro-max/data/catalog-summary.json
* feat: add IME composition Enter guidance
* chore: refresh runtime fingerprint for IME guidance
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/agent.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/amazonq.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/augment.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/autoclaw.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/claude.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/codebuddy.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/codewhale.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/codex.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/continue.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/copilot.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/cursor.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/droid.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/gemini.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/kilocode.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/kimi.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/kiro.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/openclaw.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/opencode.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/qoder.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/roocode.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/trae.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/universal.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/warp.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/windsurf.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/zcode.json
* docs: record official sources for IME guidance
* feat: add IME composition Enter guidance
* chore: refresh runtime fingerprint for IME guidance
* test: verify IME retrieval and Enter shortcut example
* chore: update UX guideline count in README.az.md
* chore: update UX guideline count in README.id.md
* chore: update UX guideline count in README.ja.md
* chore: update UX guideline count in README.vi.md
* docs: record official sources for IME guidance
* feat: add IME composition Enter guidance
* chore: refresh runtime fingerprint for IME guidance
* test: verify IME retrieval and Enter shortcut example
* test: align platform query contract with UX count
* docs: explain IME-safe Enter shortcuts and verification
* chore: update UX guideline count in skill.json
* docs: record official sources for IME guidance
* feat: add IME composition Enter guidance
* chore: refresh runtime fingerprint for IME guidance
* test: verify IME retrieval and Enter shortcut example
* chore: update UX guideline count in stack/README.md
* chore: update UX guideline count in stack/docs/STACK.md
* feat: add IME composition Enter guidance
* docs: include IME Enter guidance in quick reference
* chore: refresh runtime fingerprint for IME guidance
* test: verify IME retrieval and Enter shortcut example
* feat: add IME composition Enter guidance
* chore: refresh runtime fingerprint for IME guidance
* test: verify IME retrieval and Enter shortcut example
* docs: include IME Enter guidance in quick reference
* test: align platform query contract with UX count
* docs: explain IME-safe Enter shortcuts and verification
* feat: add IME composition Enter guidance
* chore: refresh runtime fingerprint for IME guidance
* test: verify IME retrieval and Enter shortcut example
* docs: include IME Enter guidance in quick reference
html-token-validator.py crashed with UnicodeDecodeError on UTF-8 HTML that
contains bytes cp1252 cannot decode, and generate-slide.py --json turned
non-ASCII text into mojibake, because open()/read_text()/write_text() used the
locale codec (cp1252 on Windows). Pass encoding="utf-8" at every text I/O
call in the sub-skill scripts, add regression tests, and mirror to
cli/assets/skills.
* feat(data): add rtl_level to styles and products
Classify every style and product row for right-to-left interfaces:
full (mirrors unchanged), partial (mirrors with per-component work),
caveats (layout encodes reading direction).
One column is appended per row; existing fields, column order and LF
line endings are untouched. Mirrors under cli/assets and .claude are
synced with npm run sync:assets.
* feat(search): add --rtl filter to style and product searches
search() accepts rtl="all|full|partial|caveats" and projects the new
rtl_level column, so filtered rows still carry their compatibility
level. Without that projection the filter saw None and dropped every
row, which is what broke the earlier attempt.
The filter runs after BM25 scoring but before max_results truncation.
Filtering the corpus before indexing shifted IDF and made calibrated
searches abstain incorrectly (dashboard --domain style --rtl=partial
returned nothing); scoring first keeps the corpus and thresholds
stable while still preventing -n 1 from hiding a matching row.
--rtl requires an explicit style/product domain, and is rejected with
--design-system and --stack.
relevance thresholds: runtimeFingerprint refreshed; every metric is
identical to the committed baseline.
* test: cover rtl data contract and filter ordering
Pin the behaviour the RTL filter depends on:
- rtl_level is projected, not a search signal;
- every row in both CSVs carries a supported level;
- known layouts keep their curated level;
- filtering happens before max_results truncation (saas --domain
product -n 1 with --rtl=full returns Micro SaaS, while the unfiltered
top hit is a partial row);
- omitting --rtl keeps previous results;
- unsupported domains raise ValueError and exit non-zero through the
CLI.
* docs: document the rtl compatibility filter
Explain the three levels, the CLI flag and its domain restriction in
the README, CLAUDE.md, the generated skill content and the
hand-authored Claude skill. The agent guidance tells the skill to add
--rtl for Arabic, Hebrew, Persian and Urdu work and to respect the
returned level instead of silently mirroring a caveats layout.
* Add Nuxt UI 4.12.0 guidance
Add rows 77-83 to the nuxt-ui stack:
- UChart usage, categories and colors, donut data shape
- UApp automatic locale with @nuxtjs/i18n
- UCheckboxGroup max and UFileUpload reject event
- Security upgrade note for 4.11.3 (set/setAtPath prototype
pollution, ChatPrompt GET leak)
Existing rows are unchanged. Mirrored copies synced with
npm run sync:assets.
* Fix Nuxt UI 4.12.0 data gate
Move the nuxt-ui current target from 4.11.1 to 4.12.0 so the new rows
pass validation:
- Update the pin in core.py and test_web_stack_freshness.py.
- Retag the 76 existing rows to nuxt-ui 4.12.0. Verified At stays
unchanged. The 4.11.2 to 4.12.0 release notes list no breaking
changes.
- Use an official ui.nuxt.com URL for row 83 (High severity).
- Regenerate catalog-summary.json for the new row count.
- Refresh the relevance threshold runtimeFingerprint. Relevance
metrics are identical to the committed baseline.
* feat: add AutoClaw compatibility
- Add root SKILL.md following the open SKILL.md standard
- Add 'autoclaw' to skill.json#platforms
- Add AutoClaw install instructions to README
- Add docs/autoclaw-install.md with detailed install guide
AutoClaw is Z.ai's official general-purpose AI agent (https://autoclaw.z.ai),
part of the GLM Coding Plan family alongside ZCode and OpenClaw. This PR
adds first-class AutoClaw support without changing any existing platform
install paths.
Verified SKILL.md compliance with AutoClaw/ZCode spec:
- name and description in frontmatter (required)
- description < 1024 chars
- body < 100KB
- explicit trigger phrases in description
* text feat(cli): add AutoClaw platform support
- Register 'autoclaw' in AIType, AI_TYPES, and AI_FOLDERS configuration.
- Update SKILL.md to fix broken search script paths and incorrect folder layout documentation.
- Synchronize CLI assets to ensure platform configuration and script paths are correctly bundled.
* fix(cli): install AutoClaw skills where AutoClaw actually loads them
AutoClaw does not scan `.autoclaw`; it reads workspace `skills/` plus the
shared `~/.openclaw-autoclaw/skills` directory. Point the platform config at
those roots so `uipro init --ai autoclaw` produces a skill that AutoClaw
discovers without extra configuration.
- register `autoclaw` in AI_TO_PLATFORM and add templates/platforms/autoclaw.json
with root `skills` and globalRoot `.openclaw-autoclaw/skills`
- detect AutoClaw from `.autoclaw` or an installed `skills/ui-ux-pro-max/SKILL.md`
and add its CLI description
- sync cli/assets, including the packaged autoclaw.json
- restore the `## Using the Search Script (CLI)` section in the canonical skill
template, keep the explanatory paragraph as body text, and remove the
source-repo path from generated content
- make search.py add its own directory to sys.path so sibling imports work on
embedded Python builds whose `._pth` omits the script directory (AutoClaw's
bundled runtime)
- remove the hand-maintained root SKILL.md; templates/base/skill-content.md is
the single source of truth
- rewrite docs/INSTALL.md around the verified local and global CLI workflows
- update e2e coverage for the new platform count, detection, and script paths
Validated with npm run check:assets, npm run typecheck, 49 Playwright tests,
164 Python tests, and local/global installs whose generated search script runs
successfully from the installed skill directory.
* Update search.py
The version pattern in _stack_query_requests_legacy had no trailing
boundary, so 'react 3d ...' parsed as React 3 and the query got only
deprecated rows (or none, for stacks without legacy guidance).
Fixes#547
* feat(cli): add Kimi Code platform (--ai kimi)
Kimi Code discovers skills as SKILL.md folders (name + description frontmatter) in .kimi-code/skills/ (project) and ~/.kimi-code/skills/ (user). Add a kimi platform template, register the type, detect an existing .kimi-code folder, and document it in the README.
Tests: add kimi to the dry-run and script-path e2e specs. check:assets, typecheck and those specs pass; init --ai kimi was run in an empty repo. Kimi Code itself was not run.
Refs #455.
* test(cli): add kimi install and detection specs
Cover the rendered SKILL.md frontmatter, a real install into .kimi-code/skills (skill, data, scripts and sub-skills), and detection of a .kimi-code folder. Refs #455.
* fix(scripts): expect 24 platform configs in validate-agent-guide
Adding the kimi platform template raises the config count from 23 to 24. Keep the check strict and update the expected count. Refs #455.
* test(cli): expect 24 platform configs in agent-query-contract
The kimi platform raises the platform config count from 23 to 24. Refs #455.
uipro init --ai copilot wrote .github/prompts/ui-ux-pro-max.prompt.md,
a prompt file that Copilot does not discover as a skill. It now installs
.github/skills/ui-ux-pro-max/SKILL.md with name/description frontmatter,
the data and scripts in the same folder and the sub-skills next to it,
which is where Copilot loads project skills. --global installs to
~/.copilot/skills/, Copilot's personal skills folder, through a new
optional folderStructure.globalRoot.
init and update remove the .github/prompts/ install they replace: the
prompt file, its data folder and the bundled sub-skills there. Other
files in .github/prompts/ are kept. uninstall removes both layouts.
Copilot is now detected from Copilot files (copilot-instructions.md,
instructions/, prompts/, agents/, skills/ or hooks/ under .github, or
~/.copilot/skills) instead of from any .github folder.
Closes#454
Co-authored-by: Jul11us <233702296+Jul11us@users.noreply.github.com>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
The logo and CIP scripts wrote whatever image Gemini returned under a
.png name. Nano Banana Pro returns JPEG, so --pro produced JPEG files
named .png. Both now take the extension from inline_data.mime_type, and
logo prints the path it actually wrote. Nothing is re-encoded.
The logo, CIP and icon scripts printed an error and exited 0 when a
request failed. They now exit 1 when nothing was generated: a failed
single request, or a batch, set or size set where every item failed. A
partial batch exits 0, since its summary already reports n/m.
--pro used gemini-3-pro-image-preview, which is past its listed
shutdown date. It now uses gemini-3-pro-image, and the model ids can be
overridden with GEMINI_FLASH_IMAGE_MODEL and GEMINI_PRO_IMAGE_MODEL.
Fixes#529
Co-authored-by: Jul11us <233702296+Jul11us@users.noreply.github.com>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
* feat: add OpenClaw platform support
Add OpenClaw as an install target so the skill can be installed with
`uipro init --ai openclaw` and removed via `uipro uninstall`.
OpenClaw discovers AgentSkills-format skills from `.agents/skills` in the
agent workspace and from `~/.agents/skills` (personal library on the default
state dir), so the platform config reuses the `.agents` layout already used
by the universal/codex targets with its own display name, detection entry,
and docs.
- new platform config src/ui-ux-pro-max/templates/platforms/openclaw.json
(synced to cli/assets via sync:assets)
- register 'openclaw' in AIType, AI_TYPES, AI_FOLDERS, AI_TO_PLATFORM
- detect the shared .agents workspace directory and describe the platform
- keep the .agents-family suggestion on codex when all four .agents
consumers are detected (length 2-3 -> 2-4)
- cover openclaw in the dry-run, template-script-paths, and
agent-query-contract e2e specs
- document OpenClaw in README and cli/README
* chore: bump version to 2.15.0 in skill metadata files
Aligns skill.json, marketplace.json, and plugin.json with the latest
v2.15.0 release; main was still at 2.13.0. CLI package version stays on
its own npm release track.
* fix: cover OpenClaw in offline validator and detection regression
- bump scripts/validate-agent-guide.py PLATFORM_COUNT 21 -> 23 (main
already had 22 configs with a stale count of 21; OpenClaw widens the
gap to 23, so update the gate and keep it meaningful)
- add e2e regression: a sole .agents directory detects all four
consumers (antigravity, codex, universal, openclaw) and still
suggests codex rather than all
* fix(design): keep icon generator from corrupting SVGs or truncating output
apply_viewbox_size rewrote every width/height attribute in the document,
including stroke-width and child elements, and only handled double quotes.
Restrict it to the root <svg> tag and set width and height independently.
generate_icon capped output at 4096 tokens, which truncates detailed icons.
Raise it to 16384 and report finish_reason MAX_TOKENS separately from
empty or malformed output.
Fixes#525
* fix(design): apply the response guard and MAX_TOKENS diagnosis to icon batch
generate_batch still indexed candidates[0].content.parts unguarded and
printed a bare "No valid SVGs generated." Share the response-text
extraction and the no-SVG diagnosis with generate_icon, treat text=None
as an empty response, and warn when a batch is cut off at MAX_TOKENS
after returning fewer icons than requested.
Refs #525
* fix(design): match only real root attributes when sizing icon SVGs
_set_root_attr searched the root tag with a regex, so width= or height=
text inside another quoted attribute value (aria-label="height='2'") was
rewritten and the output stopped being valid XML. Walk the tag's
attributes instead, consuming each quoted value whole, and only replace
an attribute whose name is exactly width or height.
Refs #525
The overwrite guard added in #501 scans a hardcoded list of CSS entry points
for `:root` custom properties and Tailwind v4 `@theme` blocks. The list only
held the plural `globals.css` spellings, so a project whose entry point is
`src/styles/global.css` — one letter apart — was never scanned. The guard
silently passed and `assets/design-tokens.{json,css}` was generated alongside
an existing palette, leaving two competing token systems and no warning.
Copying the same file to `src/index.css` made the guard fire correctly, which
confirms the detection logic was fine and only its candidate set was too narrow.
Widen the list with the singular spellings and `main.css` / `app.css`, then
shallow-scan a set of conventional style directories for any `*.css` so the
guard no longer depends on an exact filename. Detection itself is unchanged, so
the existing false-positive behaviour still holds: stylesheets with no custom
properties, commented-out `:root` blocks, and properties outside `:root` do not
block a sync.
Co-authored-by: Varrunan Projects <200937066+Varrunan-bit@users.noreply.github.com>
Co-authored-by: Claude <noreply@anthropic.com>
* feat: add Amazon Q Developer platform support
Add Amazon Q Developer as an install target so the skill can be installed
with `uipro init --ai amazonq` and removed via `uipro uninstall`.
Amazon Q loads every Markdown file under .amazonq/rules/ (recursively) as
always-on chat context, so only the rendered rule file goes there
(.amazonq/rules/ui-ux-pro-max.md). Data, scripts and the bundled
sub-skills go to .amazonq/skills/ via dataPath, the same split copilot
uses, so their reference docs are not pulled into every chat.
- new platform config src/ui-ux-pro-max/templates/platforms/amazonq.json
(synced to cli/assets via sync:assets)
- register 'amazonq' in AIType, AI_TYPES, AI_FOLDERS, AI_TO_PLATFORM
- detect .amazonq workspace directories and describe the platform
- cover amazonq in the dry-run and template-script-paths e2e specs
- document Amazon Q Developer in README and cli/README
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
* docs: note that Amazon Q only auto-loads the rule file
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
* fix: stop Cursor skill pointing at empty Quick Reference
Platforms that set quickReference to false omitted the inlined
reference but still told the agent to use "the Quick Reference
sections above." Resolve QR/NOQR variants so Cursor (and other
non-inlined platforms) follow the existing search flow instead.
Claude and Codex keep the inlined reference wording.
Co-authored-by: Neal Meyer <ngmeyer@users.noreply.github.com>
* fix: accept 21 platform configs after ZCode
ZCode landed on main without updating the agent-guide validator
or the platform-count e2e assertion. This branch did not add a
platform; the stale expected count of 20 was failing CI.
Co-authored-by: Neal Meyer <ngmeyer@users.noreply.github.com>
* fix: refresh stale relevance runtime fingerprint
verify:data would fail next on evaluate:relevance because main's
threshold manifest still hashed the pre-#500 runtime. Metrics are
unchanged; only the fingerprint now matches current scripts/data.
Co-authored-by: Neal Meyer <ngmeyer@users.noreply.github.com>
---------
Co-authored-by: Cursor Agent <cursoragent@cursor.com>
Co-authored-by: Neal Meyer <ngmeyer@users.noreply.github.com>
The Three.js stack claims `threejs 0.185.1` but several rows still
recommend APIs that 0.185.1 deprecates and warns about at runtime:
- THREE.Clock (deprecated since r183) -> THREE.Timer with
timer.update(timestamp) once per frame, getDelta()/getElapsed(),
and timer.connect(document) to avoid a huge delta after a hidden tab.
Rows 13, 31, 34, 45. Row 45 also stops calling getElapsedTime()
per vertex (Clock.getElapsedTime() calls getDelta() internally).
- THREE.PCFSoftShadowMap (deprecated since r182, WebGLShadowMap warns
and falls back to PCFShadowMap) -> PCFShadowMap, with shadow.radius /
VSMShadowMap noted for softer edges. Rows 22, 23.
- GLTFLoader imported from three/examples/jsm -> three/addons, matching
the rest of the file. Row 52.
Bump Verified At on touched rows, extend the freshness test's
forbidden-token list (three.clock, clock.getdelta,
clock.getelapsedtime, pcfsoftshadowmap, three/examples/jsm/) and add a
positive Timer lookup, refresh the relevance runtime fingerprint and
baseline, and re-sync mirrored assets.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Add ZCode as a first-class install target so the skill can be installed
with `uipro init --ai zcode` (workspace) or `uipro init --ai zcode --global`
(~/.zcode/skills/), and removed via `uipro uninstall` auto-detection.
- new platform config src/ui-ux-pro-max/templates/platforms/zcode.json
(synced to cli/assets via sync:assets)
- register 'zcode' in AIType union, AI_TYPES, AI_FOLDERS, AI_TO_PLATFORM
- detect .zcode workspace directories and describe the platform in CLI prompts
- cover zcode in the dry-run and template-script-paths e2e specs
- document ZCode in README install/usage sections
Co-authored-by: Dmso <22094486+dmsobtl@users.noreply.github.com>
Reverify the full stack catalog against Nuxt UI 4.11.1 and correct stale API examples. Add Splitter, ProgressGroup, motion, Vite detection, and CommandPalette security guidance.
Co-authored-by: Ray <ray.tien@cloudeep.com.tw>
Squash-merged by github-maintain cron after maintainer approval (review 2026-06-20 by @mrgoonie) and conflict resolution (rebase to head 4bd45ba5, all checks green).
- Mode Support no longer reads "Dark supported" next to an AVOID list that
says "Dark mode". Light results now print "Dark supported, but avoid for
this product" (the light-side counterpart of #428).
- ASCII box: long single-line fields (conversion, CTA, perf/a11y, Google
Fonts URL, motion) now wrap, over-long tokens split, section headers and
the CSS Import line were one char too wide, and the colour label column
fits "Muted Foreground:".
- MASTER.md buttons: .btn-primary used hard-coded white text, below 4.5:1
on the accent in 137/192 palettes; it now uses the palette's On Accent.
.btn-secondary text falls back to Foreground when Primary is below 4.5:1
on Background (94/192 palettes).
Adds regression tests for all three.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
* fix(design): make workflows self-contained, add bundled-skill contract (#474 finding 2)
The design skill's banner and social-photos workflows named skills the plugin
does not ship (frontend-design, ai-artist, ai-multimodal, chrome-devtools,
project-management, assets-organizing) and claudekit command namespaces
(/ckm:brand, /ck:ui-ux-pro-max), so those steps fail or force the agent to
improvise under a plugin or CLI install. Rewrite them after the pattern of
#473: bundled skills stay referenced by name, optional tooling becomes an
optional runtime capability, unbundled steps are implemented inline or
dropped. The same references sat in references/social-photos-design.md, so
the fix covers the skill directory, not just SKILL.md; the CLI copy is synced.
check-asset-sync.yml gains a bundled-skill contract over both skill trees:
no /ck: or /ckm: namespace, every "`name` skill" reference must be a
directory under .claude/skills, and none of the claudekit-only names above
in any spelling.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
* fix(design): address review - list-aware skill grep, case-insensitive denylist, banner intro, report naming
- contract grep 2 walks comma/and/or lists so every member is checked, not
only the last one, and accepts the sub-skill and bold forms; grep 3 matches
case-insensitively; the step comment states what is not covered
- banner intro no longer claims "no sibling skills" while step 2 names the
bundled ui-ux-pro-max skill
- social-photos report name stated inline instead of "naming pattern from
session hooks" (a claudekit convention nothing in the bundle provides);
"persistent" dropped from the task-list step; device-scale note scoped to
tools that support it
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
* fix(ci): match wrapped skill lists - read each file as one record in the bundled-skill contract
A Markdown list wrapped over two lines ("`playwright-mcp`,\n`brand`, and
`ui-ux-pro-max` skills") passed the line-oriented allowlist grep. Read the
file as one record (-z, separators as \s+) so wrapped lists are still lists;
a hit now names the file and the name instead of the line. grep's own exit
status is taken inside the substitution so an unreadable file still fails the
step under plain bash -e, pipefail or not.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
---------
Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
adjustBrightness() added/subtracted a flat 255*percent to every RGB
channel. For a dark base color (channels already close to 0), darkening
by -0.3/-0.45/-0.6 clamped every channel to 0, so shades 700, 800, and
900 all came back as the identical, useless #000000 instead of a graded
dark scale -- reproducible with any sufficiently dark brand primary
(e.g. #4A3228), not just an edge case.
Blend each channel proportionally toward white (percent > 0) or black
(percent < 0) instead, so the shift scales with how much headroom the
channel actually has.
Adds a regression test that syncs a dark brand color and asserts the
700/800/900 shades stay distinct and non-black.
Claude-Session: https://claude.ai/code/session_01MmtTPnoqMrjjhKjod9VTzr
Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>
Refs #474 (finding 1 follow-up to #476, which rewrote design/SKILL.md
and added a contract that grepped only */SKILL.md; the same defect one
level down survived).
- 29 home-rooted paths (~/.claude/skills/design/scripts/...) in
design/references/{cip,icon,logo}-design.md -> scripts/... (27 at
review time, two more added by #470); the printed
hint in design/scripts/cip/generate.py now derives the absolute path
from __file__
- 19 project-rooted invocations (.claude/skills/<skill>/scripts/...) in
brand/, slides/ and design/ references -> scripts/... (own skill) or
../<skill>/scripts/... (sibling sub-skill; sub-skills are installed
side by side in every layout)
- brand/scripts/sync-brand-to-tokens.cjs resolved its sibling script from
process.cwd(), silently skipping CSS regeneration under plugin and
--global installs; now resolved from __dirname, with a warning when
the sibling skill is missing; regression test asserts the regeneration
- brand/scripts/extract-colors.cjs: tool-neutral hint instead of a
project-rooted path into a skill this plugin does not ship
- "Script Paths" section in the five sub-skills that invoke scripts:
script path from the skill directory, working directory at the
project root
- new test_skill_script_paths.py (src, mirrored to both scripts/tests
copies): every python/node/bash invocation in every shipped skill
markdown must be skill-relative and name a file that ships
- check-asset-sync.yml: contract covers every file under both skill
trees and home-/project-/variable-rooted forms; ${CLAUDE_PLUGIN_ROOT}
allowed only in the plugin-only core SKILL.md; LC_ALL=C + -I for the tracked
.coverage binary; grep errors fail instead of passing; push filter
includes the workflow and sync-assets.mjs
- CLI copy regenerated via sync-assets.mjs
Co-authored-by: notbucki <daniel@buckenmaier.xyz>
Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
* fix(data): regenerate stale catalog-summary snapshot hashes
catalog-summary.json was not regenerated after google-fonts.csv,
google-font-licenses.json, icons.csv and phosphor-icons-upstream.json
changed, so `npm --prefix cli run verify:data` fails on a clean
checkout of main:
validate:semantic 4 stale snapshot errors
validate:catalog-summary "catalog-summary.json is stale"
test:python 1 failure / 153
check:assets 2 files out of sync
Regenerated with the existing --verified-at 2026-08-26: only the four
sha256 fields change. The date is a human attestation that the font
catalog was checked against the upstream google/fonts repository, so it
is deliberately left untouched -- no such verification was performed
here.
verify:data now exits 0.
Note: prepublishOnly runs sync:assets before verify:data, which
regenerates the snapshot at publish time. That is why released packages
are unaffected and the drift stayed invisible on main.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015UidECV1wVBD8SW6Abuj71
* fix(data): make catalog snapshot hashes line-ending independent
Root cause of the stale snapshot restored in the previous commit.
bd19ab9 (#462) regenerated catalog-summary.json from a CRLF checkout.
Every recorded sha256 was the CRLF hash of its source file, so the
check failed on every LF platform. The four committed values are
exactly sha256(crlf_bytes):
google-fonts.csv committed d03194d2… = CRLF hash
google-font-licenses.json committed 7c35e410… = CRLF hash
icons.csv committed 272ccf0e… = CRLF hash
phosphor-icons-upstream.json committed 81c37fb3… = CRLF hash
Two conditions had to combine: the digest hashed raw bytes, and no
.gitattributes pinned these files to LF, so Windows checkouts get CRLF
by default. Restoring the hashes alone would let the next contributor
on Windows reproduce the same commit.
Three changes:
- normalize line endings in generate-catalog-summary.py's digest(), so
the snapshot no longer depends on the checkout
- apply the same normalization in validate_data.py, which independently
recomputes the hashes and has to agree with the generator
- add .gitattributes pinning src/ui-ux-pro-max/data/*.{csv,json} to LF,
so a Windows checkout matches the committed bytes in the first place
sync-assets.mjs already normalizes to LF, so this only extends an
existing project convention to the two places that were missing it.
Adds test_catalog_summary_line_endings.py: LF and CRLF inputs must
digest identically, the committed snapshot must match the normalized
sources, and a simulated CRLF checkout must still produce the recorded
hashes. The third case fails against the pre-fix digest.
verify:data exits 0; the Python suite goes from 153 to 156 tests.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015UidECV1wVBD8SW6Abuj71
---------
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
* fix(design-system): resolve project root from cwd, not __file__
fetch-background.py and html-token-validator.py derived PROJECT_ROOT with five
.parent hops, which only reaches the project root when the skill is vendored at
<project>/.claude/skills/design-system/scripts/. Installed at user level
(~/.claude/skills/) or as a plugin, PROJECT_ROOT pointed outside the project, so
both scripts silently ran against no tokens at all.
Resolve from the working directory instead, matching generate-tokens.cjs and
validate-tokens.cjs which already use process.cwd(). DESIGN_SYSTEM_PROJECT_ROOT
overrides it when the project root cannot be inferred.
slide_search_core.py is left alone: it resolves skill-relative data, which is
the correct use of __file__.
Refs #459
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* fix(design-system): stop findProjectRoot from hanging on Windows
embed-tokens.cjs walked up the tree with `while (dir !== '/')`. On Windows the
filesystem root is 'C:\', so that condition is never true, and path.dirname('C:\')
returns 'C:\' unchanged -- the loop spins forever at 100% CPU instead of erroring
out, whenever assets/design-tokens.css is not found above the cwd.
Stop when dirname stops changing, which terminates on every platform.
Refs #459
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* fix(design-system): force UTF-8 stdout so emoji output works on cp1252 consoles
search-slides.py --context and html-token-validator.py print emoji. On a Windows
console the default encoding is cp1252, so the first emoji raises
UnicodeEncodeError and the command dies with a traceback instead of output --
this takes out --context, the entry point of the contextual slide system.
Reuse the guard already shipped in src/ui-ux-pro-max/scripts/search.py.
Refs #459
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* test(design-system): decode subprocess output as UTF-8 in validate-tokens tests
test_validate_tokens.py drives validate-tokens.cjs through subprocess.run with
text=True but no explicit encoding, so Python decodes the pipe with the locale
codec. On Windows (cp1252) the validator's emoji output raises UnicodeDecodeError
inside the reader thread, result.stdout comes back as None, and the assertion
fails with a confusing `TypeError: argument of type 'NoneType' is not a
container` -- this suite cannot pass on Windows at all today.
Pin the pipe and the fixture write to UTF-8. The validator itself was never at
fault: run by hand it flags the hardcoded hex correctly.
Note: brand/scripts/tests/test_sync_brand_to_tokens.py uses the same
text=True-without-encoding pattern and is one emoji away from failing the same
way. Left alone to keep this PR scoped to design-system.
Refs #459
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
Replace all 22 hard-coded ~/.claude/skills/design/scripts/... invocations
in the design skill with skill-relative paths (python3 scripts/...), the
same convention the brand and design-system sub-skills already use. The
user-level path only works in one install context: under a marketplace/
plugin install the skill lives in the plugin cache, and under project-level
CLI installs there is no ~/.claude/skills/design/ either.
Edited .claude/skills/design/SKILL.md (source of truth) and regenerated
the CLI copy with cli/scripts/sync-assets.mjs; --check passes.
Adds a path-contract step to check-asset-sync.yml that fails if any
SKILL.md (either copy) reintroduces a ~/.claude/skills/ invocation, and
widens the workflow's path filters to .claude/skills/** so the contract
actually fires on sub-skill edits.
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
Remove references to tools and sibling skills that are not bundled with banner-design. Add plugin, asset, and Claude CLI installation path-contract coverage.
test_sync_brand_to_tokens.py drives sync-brand-to-tokens.cjs through
subprocess.run with text=True but no explicit encoding, so Python decodes the
pipe with the locale codec. Three of the script's messages carry emoji whose
UTF-8 bytes land on cp1252's undefined slots: 0x8F in the "no base hex found"
warning (sync-brand-to-tokens.cjs:132), 0x9D in the "brand guidelines not found"
error (:198), and 0x8F in the dry-run notice (:223). Decoding then raises inside
subprocess's reader thread, the stream comes back as None, and any assertion
against it fails with `TypeError: argument of type 'NoneType' is not a
container` -- which hides the real result behind an unrelated error.
The existing test passes today only because the bundled starter fixture happens
to take none of those three paths.
Pin the pipe to UTF-8, extracted into a shared _run helper to match the idiom in
design-system's test module, and add a regression test for the missing-guidelines
path -- the default state of any project that has not run the brand skill yet.
That test fails without the encoding fix (stderr is None) and passes with it.
Follow-up to #460
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* feat(cli): add --global flag to update command and support --ai universal (#435, #436)
* fix(cli): support dist package.json resolution in update command
* fix(copilot): generate .prompt.md file for VS Code Copilot slash commands
VS Code Copilot requires reusable prompts to be files named
`<name>.prompt.md` directly in `.github/prompts/`. The previous
config generated `.github/prompts/ui-ux-pro-max/PROMPT.md` (a folder
with PROMPT.md inside), which is not recognized as a slash command.
Changes:
- copilot.json: set skillPath to 'prompts', filename to
'ui-ux-pro-max.prompt.md', add dataPath for data/scripts location
- copilot.json: use 'mode: agent' frontmatter (VS Code format) instead
of 'name' field
- template.ts: add dataPath support so data/scripts go to a separate
directory from the prompt file when configured
- template.ts: rewrite hardcoded script paths to platform-specific
scriptPath for platforms that differ from the default
- uninstall.ts: handle copilot-specific file layout during uninstall
After this fix, `uipro init --ai copilot` produces:
.github/prompts/ui-ux-pro-max.prompt.md (slash command file)
.github/prompts/ui-ux-pro-max/data/ (search database)
.github/prompts/ui-ux-pro-max/scripts/ (search engine)
* fix(copilot): apply prompt-file layout fix to canonical source template
Address review feedback on PR #328:
- Update src/ui-ux-pro-max/templates/platforms/copilot.json (source of
truth) with the same .prompt.md layout fix that was previously applied
only to the packaged CLI asset copy
- Sync cli/assets/templates/platforms/copilot.json byte-for-byte from
the source template (also fixes stale '15 technology stacks' count;
there are 16 stack CSVs)
Smoke check (uipro init --ai copilot --offline):
.github/prompts/ui-ux-pro-max.prompt.md (slash command, mode: agent)
.github/prompts/ui-ux-pro-max/data/ (search database)
.github/prompts/ui-ux-pro-max/scripts/ (search engine)
uninstall --ai copilot removes both the prompt file and data directory.
---------
Co-authored-by: vkayata <volkan.kayatas@mercedes-benz.com>