iwana-identity-ui-review

Audits and aligns UI screens against iWana brand tokens, primitives, and accessibility rules.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/SleyiW/iWana-neXt --skill iwana-identity-ui-review-sleyiw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: iwana-identity-ui-review
Source: https://github.com/SleyiW/iWana-neXt/tree/main/.agents/skills/iwana-identity-ui-review
Command: npx skills add https://github.com/SleyiW/iWana-neXt --skill iwana-identity-ui-review-sleyiw

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? UI screens in the iWana portal and backoffice drift away from the corporate design system: untokenized brand hex values, forbidden dark-mode grays, lime color misused for urgency, and generic template-looking layouts. This Skill enforces the iWana visual identity with verifiable rules, real tokens, and a mechanical audit script so every screen is recognizable as iWana and passes basic WCAG AA checks. ## Core Features & Use Cases - Design mode playbook: Classifies the screen type, applies canonical component recipes (KPI cards, data tables, panels, empty states, forms), and requires at least two signature brand elements with real function before delivery. - Review mode with P0-P3 findings: Produces a standardized audit report with evidence (file:line), severity, impact, effort, quick wins, and a computed score from 0-100. - Mechanical audit script: Runs scripts/audit-ui.mjs to detect deterministic violations (dark:bg-gray-*, tailwind.config presence, raw brand hex, z-index wars) and heuristic flags requiring manual confirmation. - Use Case: Before shipping a new dashboard, run the audit script on the touched files, apply the component recipes from the references, and verify lime usage, focus visibility, and dark-surface tokens against the hard rules table. ## Quick Start Ask the agent to review the UI of a specific screen or component against the iWana identity and run the audit script on its files.

Frequently Asked Questions about iwana-identity-ui-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit a UI screen against the iWana design system?

Run the audit-ui.mjs script on the screen's files for deterministic violations, then evaluate the seven dimensions (identity, usability, UX, accessibility, visual design, responsive, frontend engineering). Report findings with file:line evidence in the standard P0-P3 format.

How do I run the iWana UI audit script?

Execute node .agents/skills/iwana-identity-ui-review/scripts/audit-ui.mjs with optional file paths and a --json flag. Without paths it scans apps/portal/src, apps/web/src, and packages/ui/src, exiting with code 1 when blocking P0/P1 findings exist.

What design tokens does the iWana identity use in Tailwind?

Tokens live in packages/ui/src/styles/globals.css as a Tailwind v4 CSS-first @theme: iwana-primary (night blue #17163A), iwana-secondary (lime #A5C330), iwana-surface-soft, dark-surface-1..4, and shadow-iwana-soft/active. A tailwind.config.js file is forbidden by ADR.

Why is lime text failing accessibility contrast checks?

The default lime #A5C330 does not pass WCAG AA on white backgrounds. Use text-iwana-secondary-700 (#6A7A1C, 6.2:1 contrast) for any lime text on light surfaces, as documented in globals.css.

When should I not use this UI review skill?

Delegate deep WCAG audits to wcag-audit-patterns, new visual direction proposals to senior-ui-systems-designer, and copy or vocabulary issues to system-vocabulary-review. Pure backend or API contract work without visual surface is out of scope.

Can I use dark:bg-gray-800 in new iWana components?

No. ADR-056 section 2 prohibits dark:bg-gray-{700,800,900,950} in new code. Use the dark-surface-{1..4} and dark-border tokens defined in globals.css lines 121-124 instead.