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>
* 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
* 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.
* 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
* 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>
Step 1 of the workflow told the agent the stack was always React Native
("this project's only tech stack"), a leftover from the skill's origin as
a React Native project. In a generic skill this actively misleads: agents
pick React Native guidance for web, Flutter or desktop work, and skip the
matching `--stack` file entirely.
Replace it with stack inference plus an explicit platform question, and
point at the Available Stacks list so the right rules get loaded.
Also flags that several rule sections are scoped to App UI, so mobile-only
concerns (safe areas, haptics, bottom nav, Dynamic Type) are not applied
to desktop-web work.
Co-authored-by: decilapdenis <decilapdenis@gmail.com>
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Addresses the behavioral patterns that plausibly triggered the Gen
(Agent Trust Hub) High Risk rating on skills.sh, without changing
runtime functionality:
- Prerequisites no longer instruct agents to run sudo/brew/apt/winget
install commands; agents must ask the user to install Python instead
(SKILL.md, skill-content.md template, README.md, README.zh.md)
- Soften coercive invocation language ("Must Use" -> "Primary Use
Cases") and replace keyword-stuffed frontmatter descriptions with
factual ones (SKILL.md, quick-reference.md, claude/droid.json,
plugin.json)
- Remove design.csv, draft.csv and _sync_all.py: unused by the runtime
(not registered in core.py CSV_CONFIG) and containing prompt-shaped
"System Prompt: ... You are ..." blocks that read as injection risk
- Fix path traversal in --persist: new safe_slug() restricts project
and page names to [a-z0-9_-], so ../ in -p/--page can no longer
escape the design-system/ output folder
Verified: validate-csv.py (35 files), smoke-domains (12/12),
smoke-stacks (22/22), check:assets in sync, persist traversal attempt
stays confined.
Co-authored-by: Andras Polgar <5525341+ruredi@users.noreply.github.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
PR #296 (feat/emil-motion-principles) independently registers a "motion"
domain key in CSV_CONFIG/detect_domain for motion-principles.csv (37
design-principle rows). Both PRs adding the same dict key would cause
one to silently overwrite the other's domain registration if merged
independently, per the automated review on this PR.
The two domains are complementary, not duplicate (design principles vs.
ready-to-use GSAP code snippets), so this renames this PR's domain from
"motion" to "gsap" - a more precise name given every row is GSAP-specific
implementation code. The --motion CLI dial and its "Subtle/Standard/
Complex" tiers are unaffected (unrelated to the domain key; only the
`--domain gsap` search endpoint and its internal lookup changed). No
regressions: --design-system output with no dials set remains
byte-identical to before this feature.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Adds a new searchable `motion` domain (motion.csv, 16 GSAP animation
skeletons across hover/scroll-reveal/stagger/page-transition/parallax/
loading, each tagged Subtle/Standard/Complex) plus three optional 1-10
dials on `--design-system` — --variance, --motion, --density — inspired
by taste-skill's DESIGN_VARIANCE/MOTION_INTENSITY/VISUAL_DENSITY sliders.
- --variance biases style search/selection toward centered-minimal (low)
or bold-asymmetric (high) categories
- --motion attaches a matching GSAP snippet (code + framework notes +
do/don't) from motion.csv
- --density overrides the --space-* token scale in ASCII/markdown/MASTER.md
output (spacious <-> dense/dashboard)
All three dials are optional and additive; output with no dials set is
byte-identical to before (verified via regression diff). Synced into
.claude/skills/ui-ux-pro-max and cli/assets alongside src/ui-ux-pro-max
(source of truth) so all three installed copies stay consistent.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
* fix CLI asset sync
* fix(cli): normalize line endings in asset sync/check
check:assets hashed raw bytes, so identical CSV/JSON/py content with
CRLF vs LF (git autocrlf on checkout) was reported as stale drift,
blocking the release guard on Windows/mixed checkouts.
- fileHash now normalizes CRLF->LF before hashing, so check:assets
compares content, not line endings.
- sync:assets writes LF-normalized copies instead of a raw byte copy,
so re-syncing is deterministic across platforms.
All synced assets are text (csv/json/md/py); no binaries affected.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* ci: enforce CLI asset sync on PRs
Adds a Check asset sync workflow that runs `npm run check:assets` on any
PR touching src/ui-ux-pro-max/** or cli/assets/**, so the bundled CLI
assets can't silently drift from the source of truth.
The check uses only node builtins (no install step) and normalizes
line endings before hashing, so it hard-fails on real content drift
without the CRLF/LF soft-fail hack other approaches needed.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
BREAKING CHANGES:
- Moved canonical data/scripts to src/ui-ux-pro-max/
- Removed duplicate folders (.codex/, .gemini/, .trae/, .codebuddy/, .continue/, skills/, .qoder/)
- CLI now uses template system instead of copying pre-built folders
New features:
- Merged prompts.csv into styles.csv with 4 new columns:
- AI Prompt Keywords
- CSS/Technical Keywords
- Implementation Checklist
- Design System Variables
- All 67 styles now have complete prompt data
- Added Astro stack (53 guidelines)
- Added 10 new 2025 UI trend styles
CLI changes:
- New template rendering system (cli/src/utils/template.ts)
- Reduced cli/assets from ~34MB to ~564KB
- Assets now contain only: data/, scripts/, templates/
File structure:
- src/ui-ux-pro-max/ - Single source of truth
- .claude/skills/ - Symlinks to src/ for development
- .shared/ - Symlink to src/ui-ux-pro-max/
Bumped CLI version: 2.1.3 → 2.2.0
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>