19 Commits

Author SHA1 Message Date
Khanh Le
f984fcd3de
feat: add web map UX guidelines (Maps category) (#581)
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>
2026-11-18 20:15:23 +07:00
Matt Van Horn
b6a79003ad
feat(design-system): export the generated design system as design tokens (#577) 2026-11-16 05:07:39 +07:00
Matt Van Horn
efd9822135
feat(design-system): write a self-contained preview page for the generated system (#576) 2026-11-16 02:05:27 +07:00
조유경 (Cho Yugyeong)
4f2dbb67e6
feat: add IME-safe Enter shortcut guidance (#562)
* 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
2026-11-08 02:05:11 +07:00
SoufianeDev
713eef51b0
feat(search): add RTL compatibility levels and --rtl filter (#553)
* 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.
2026-11-02 23:10:22 +07:00
Walid Khalafi
9a3f14f742
feat: add AutoClaw compatibility (#545)
* 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
2026-10-31 02:08:33 +07:00
Neal Meyer
477bcb28c9
fix: stop Cursor skill pointing at empty Quick Reference (#509)
* 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>
2026-10-03 23:05:26 +07:00
Viet Tran
a38d04c3d5
feat(search): overhaul relevance and curated design data
Overhaul BM25 relevance, reasoning and data-quality contracts; refresh UI styles and framework guidance; add resilient text, chip, badge and micro-interaction guidance; strengthen release, provenance and catalog refresh gates; update bilingual documentation.
2026-08-14 00:08:23 +07:00
Viet Tran
0ed327fc18
fix(cli): generate runnable script paths (#181)
Resolve platform-root-relative script paths for local and global installs, with regression coverage across Claude, Codex, Copilot, and Kiro.
2026-08-12 16:34:27 +07:00
amazscript
1307d97a72
docs: don't hardcode React Native as the project stack (#427)
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>
2026-07-21 22:51:36 +07:00
Abraham040203
0468898265
docs: sync --domain and --stack lists with search.py --help (#411)
- CLAUDE.md: add missing domains (icons, react, web, google-fonts);
  domain list now matches all 12 --help choices (gsap landed via #402,
  stack list already synced by #404)
- README.md / README.zh.md: complete Desktop row in Supported Stacks
  (add WPF, WinUI 3, Avalonia, Uno Platform, UWP); fix stack count
  (13+ -> 22); replace nonexistent --max-length flag with --json in
  Troubleshooting
- templates/base/skill-content.md (+ cli/assets mirror): add
  icons/google-fonts/gsap rows to search tables, drop invalid 'prompt'
  domain, list all 22 stacks instead of 2

Co-authored-by: 文敏華 <guanweijie@wenminhuadeMacBook-Air.local>
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2026-07-13 16:32:25 +07:00
Andras Polgar
3da52ff1ca
security: harden skill against agent-audit risk patterns (#417)
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>
2026-07-10 21:30:06 +07:00
文敏華
6a6167691a Rename motion domain to gsap to avoid collision with PR #296
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>
2026-07-02 23:36:44 +08:00
文敏華
bd9329c9cb Add motion domain and design dials to design-system generator
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>
2026-07-01 22:54:02 +08:00
Alexander
b4d33beada
fix CLI asset sync (#355)
* 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>
2026-06-25 12:54:58 +07:00
youngledo
53d670cd30
feat: add JavaFX enterprise stack guidance (#316) 2026-06-22 12:00:21 +07:00
rianadesigner
5cbdb0ac30 chore: update ui-ux pro max skill for react-native apps
Made-with: Cursor
2026-03-10 11:56:27 +08:00
rianadesigner
2aec7afb93 sync: 161 product types, design system 与 CLI 资产同步,小猫咪预览页
- products.csv: 修复 No.90/No.65 数据,统一 161 产品类型
- colors.csv: 修复 Bitcoin DeFi Mobile 截断,同步 178 色板
- ui-reasoning.csv: 与 products 对齐
- core.py: 扩展 product 域关键词覆盖
- README/SKILL: 更新 161 reasoning rules、178 palettes 等数字
- 移除 stacks 下多框架 CSV,保留 react-native
- 新增 design.csv、_sync_all.py,CLI assets 全量同步
- 新增 preview/xiaomaomi-app.html 小猫咪 App 示例

Made-with: Cursor
2026-03-06 11:03:28 +08:00
Viet Tran
b2a05eceeb
feat: reorganize codebase with single source of truth + merge prompts into styles (#116)
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>
2026-01-22 22:05:41 +07:00