# GGQ UI demos v2: Vercel Skills A/B

Generated (UTC): 2026-01-22T08:06:47Z

Goal
- A) Run Vercel Skills `web-design-guidelines` against the existing GGQ UI demos v2 pack and produce a punch-list (no code changes).
- B) Create a forked “skills” variant (A/B) with layout improvements and publish it separately.

Constraints
- Do not modify the already-published baseline pack (`2026-01-22-v2`).
- Keep work isolated under `/root/tmp/ggq_ui_demos/skills_ab/`.

Baseline
- Published pack: https://infrafabric.io/static/hosted/review/ggq/ui-demos/2026-01-22-v2/index.html
- Local source: `/root/tmp/ggq_ui_demos/2026-01-22-v2/`

\n## Step A1: Install Vercel Skills (isolated HOME)
UTC: 2026-01-22T08:07:13Z
Command:
HOME=/root/tmp/ggq_ui_demos/skills_ab/home npm_config_cache=/root/tmp/ggq_ui_demos/skills_ab/npm-cache npx skills add vercel-labs/agent-skills --list --yes
\nInstalled list output (saved to report/skills_list.txt).
\nCommand:
HOME=/root/tmp/ggq_ui_demos/skills_ab/home npm_config_cache=/root/tmp/ggq_ui_demos/skills_ab/npm-cache npx skills add vercel-labs/agent-skills --skill web-design-guidelines --agent codex --yes --global
\nPinned skill file copied to /root/tmp/ggq_ui_demos/skills_ab/skill_source/SKILL.md
\n## Step A2: Pin the guidelines source (avoid nondeterminism)
UTC: 2026-01-22T08:07:44Z
Source URL:
https://raw.githubusercontent.com/vercel-labs/web-interface-guidelines/main/command.md
 Saved to: /root/tmp/ggq_ui_demos/skills_ab/skill_source/web-interface-guidelines.command.md
 sha256: 551a320891eaf60fa96707091273339211d469d8a8a5b0d8f53feb1204f0d0a1
 bytes: 6835
\n## Step A3: Skills audit (apply Vercel web-interface-guidelines locally)
UTC: 2026-01-22T08:11:18Z
Scope: GGQ UI demos v2 (static HTML/CSS/JS)
 \nFindings (excerpt):
 ## demo-01/article.html
 
 demo-01/article.html:17 - img missing explicit width+height (CLS risk)
 demo-01/article.html:27 - search input missing aria-label
 demo-01/article.html:36 - img missing explicit width+height (CLS risk)
 demo-01/article.html:49 - img missing explicit width+height (CLS risk)
 demo-01/article.html:82 - img missing explicit width+height (CLS risk)
 
 ## demo-01/destination.html
 
 demo-01/destination.html:17 - img missing explicit width+height (CLS risk)
 demo-01/destination.html:27 - search input missing aria-label
 demo-01/destination.html:36 - img missing explicit width+height (CLS risk)
 demo-01/destination.html:63 - img missing explicit width+height (CLS risk)
 demo-01/destination.html:64 - img missing explicit width+height (CLS risk)
 demo-01/destination.html:80 - img missing explicit width+height (CLS risk)
 
 ## demo-01/index.html
 
 demo-01/index.html:17 - img missing explicit width+height (CLS risk)
 demo-01/index.html:27 - search input missing aria-label
 demo-01/index.html:36 - img missing explicit width+height (CLS risk)
 demo-01/index.html:102 - img missing explicit width+height (CLS risk)
 
 ## demo-01/map.html
 
 demo-01/map.html:24 - img missing explicit width+height (CLS risk)
 demo-01/map.html:34 - search input missing aria-label
 demo-01/map.html:56 - img missing explicit width+height (CLS risk)
 demo-01/map.html:71 - img missing explicit width+height (CLS risk)
 
 ## demo-02/article.html
 
 demo-02/article.html:17 - img missing explicit width+height (CLS risk)
 demo-02/article.html:27 - search input missing aria-label
 demo-02/article.html:36 - img missing explicit width+height (CLS risk)
 demo-02/article.html:49 - img missing explicit width+height (CLS risk)
 demo-02/article.html:82 - img missing explicit width+height (CLS risk)
 
 ## demo-02/destination.html
 
 demo-02/destination.html:17 - img missing explicit width+height (CLS risk)
 demo-02/destination.html:27 - search input missing aria-label
 demo-02/destination.html:36 - img missing explicit width+height (CLS risk)
 demo-02/destination.html:63 - img missing explicit width+height (CLS risk)
 demo-02/destination.html:64 - img missing explicit width+height (CLS risk)
 demo-02/destination.html:80 - img missing explicit width+height (CLS risk)
 
 ## demo-02/index.html
 
 demo-02/index.html:17 - img missing explicit width+height (CLS risk)
 demo-02/index.html:27 - search input missing aria-label
 demo-02/index.html:36 - img missing explicit width+height (CLS risk)
 demo-02/index.html:102 - img missing explicit width+height (CLS risk)
 
 ## demo-02/map.html
 
 demo-02/map.html:24 - img missing explicit width+height (CLS risk)
 demo-02/map.html:34 - search input missing aria-label
 demo-02/map.html:56 - img missing explicit width+height (CLS risk)
 demo-02/map.html:71 - img missing explicit width+height (CLS risk)
 
 ## demo-03/article.html
 
 demo-03/article.html:17 - img missing explicit width+height (CLS risk)
 demo-03/article.html:27 - search input missing aria-label
 demo-03/article.html:36 - img missing explicit width+height (CLS risk)
 demo-03/article.html:49 - img missing explicit width+height (CLS risk)
 demo-03/article.html:82 - img missing explicit width+height (CLS risk)
 
 ## demo-03/destination.html
 
 demo-03/destination.html:17 - img missing explicit width+height (CLS risk)
 demo-03/destination.html:27 - search input missing aria-label
 demo-03/destination.html:36 - img missing explicit width+height (CLS risk)
 demo-03/destination.html:63 - img missing explicit width+height (CLS risk)
 demo-03/destination.html:64 - img missing explicit width+height (CLS risk)
 demo-03/destination.html:80 - img missing explicit width+height (CLS risk)
 
 ## demo-03/index.html
 
 demo-03/index.html:17 - img missing explicit width+height (CLS risk)
 demo-03/index.html:27 - search input missing aria-label
 demo-03/index.html:36 - img missing explicit width+height (CLS risk)
 demo-03/index.html:102 - img missing explicit width+height (CLS risk)
 
 ## demo-03/map.html
 
 demo-03/map.html:24 - img missing explicit width+height (CLS risk)
 demo-03/map.html:34 - search input missing aria-label
 demo-03/map.html:56 - img missing explicit width+height (CLS risk)
 demo-03/map.html:71 - img missing explicit width+height (CLS risk)
 
 ## demo-04/article.html
 
 demo-04/article.html:17 - img missing explicit width+height (CLS risk)
 demo-04/article.html:27 - search input missing aria-label
 demo-04/article.html:36 - img missing explicit width+height (CLS risk)
 demo-04/article.html:49 - img missing explicit width+height (CLS risk)
 demo-04/article.html:82 - img missing explicit width+height (CLS risk)
 
 ## demo-04/destination.html
 
 demo-04/destination.html:17 - img missing explicit width+height (CLS risk)
 demo-04/destination.html:27 - search input missing aria-label
 demo-04/destination.html:36 - img missing explicit width+height (CLS risk)
 demo-04/destination.html:63 - img missing explicit width+height (CLS risk)
 demo-04/destination.html:64 - img missing explicit width+height (CLS risk)
 demo-04/destination.html:80 - img missing explicit width+height (CLS risk)
 
 ## demo-04/index.html
 
 demo-04/index.html:17 - img missing explicit width+height (CLS risk)
 demo-04/index.html:27 - search input missing aria-label
 demo-04/index.html:36 - img missing explicit width+height (CLS risk)
 demo-04/index.html:102 - img missing explicit width+height (CLS risk)
 
 ## demo-04/map.html
 
 demo-04/map.html:24 - img missing explicit width+height (CLS risk)
Fork created: /root/tmp/ggq_ui_demos/skills_ab/site_v2_skills
\n## Step B1: Apply skills-driven fixes to fork (no baseline edits)
UTC: 2026-01-22T08:15:40Z
Actions:
- Add aria-label/name to search inputs
- Add width/height to <img> based on intrinsic dimensions
- Honor prefers-reduced-motion for carousel scroll
- Add focus-visible styles and text-wrap: balance
\nAudit count (baseline vs skills fork):
- baseline findings: 95
- after findings: 5
\nAudit count (baseline vs skills fork) [post-fix]:
- baseline findings: 95
- after findings: 0
