ai-ux-reviewlisted
Install: claude install-skill sorawit-w/agent-skills
# AI UX Review
Audit an AI product or feature against a structured set of human-AI design
questions. Each of the seven blocks is a *gap detector*, not a template field —
the value of this skill is whether the elicitation surfaces design decisions the
builder hadn't made yet, not whether the artifact looks complete.
The job is **design-completeness**: *have we designed the human side of this
responsibly?* It covers both the classical human-AI UX surface (user need,
mental models, trust, feedback, errors) and the gen-AI integrity surface that
showed up after 2022 (hallucination handling, verifiability, provenance,
prompt-injection exposure, agent autonomy).
This is not a quality assessment of an AI product's output. It is a structured
review of whether the *design around* that output is intentional.
## What this skill produces
Always produced under the resolved review root (default `docs/ai-ux/`):
1. **`ai-ux-review.md`** — canonical, editable Markdown with one top-level
section per block (seven blocks total), plus a `## Gap Summary` section
listing the design decisions still unmade. Headings are load-bearing for
future composability with a potential `ai-eval-rubric` companion skill.
2. **`ai-ux-review.html`** — single self-contained HTML file rendering the
seven blocks visually, with gap-marker glyphs for blocks where the builder
said "we haven't designed for this yet." Opens in any browser, prints
cleanly to PDF, zero network dependencies.
Both files