skills/product-usability-qa/SKILL.md
Use this when QA is piloting product goals, golden paths, simulator flows, or workflow-scale usability for a real user persona.
npx skillsauth add robertmsale/.codex product-usability-qaInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Completion is not enough.
A story passes only when a real target user can complete it with reasonable effort, obvious navigation, clear state, and no inappropriate developer knowledge.
Simple tasks: 3-5 expected, >7 usability bug, 10+ severe usability.
Medium tasks: 6-12 expected, >15 usability bug, 20+ severe usability.
Complex tasks: 15-30 allowed only when guided, previewable where applicable, recoverable, and appropriate for advanced configuration.
AI assist is appropriate for advanced configuration, rules, workflow design, package/interface generation, marketing copy, complex automation, and import/mapping.
AI assist is not acceptable for basic operational tasks such as creating records, adding contacts, finding records, editing basic info, assigning people, sending items, approving or rejecting items, or marking work complete.
If a simple task appears to require AI assistance, report Severe Usability.
Use assets/product-usability-pilot-report.md when a full report artifact is requested.
Every pilot report must include:
Use references/product-usability-task-classes.md when task class or AI-assistance suitability is unclear.
Score each 0-3:
0-4 acceptable. 5-8 needs polish. 9-14 usability bug cluster. 15+ severe usability failure.
Do not say "passed" merely because the task eventually succeeded.
If the task took unreasonable effort, report PASS WITH USABILITY BUGS or FAIL - SEVERE USABILITY.
testing
Use for screenshot-driven Flutter design work that must prove visual quality through Requirements-native claims, sanctioned Design Lab capture, and anti-slop evidence. [skill-hash:7b1c9e3]
content-media
Ran into a sandbox issue, approval request, or privileged-exec rejection? Use this skill immediately for the sanctioned resolution path. [skill-hash:b8f4a20]
development
Use this when a designer needs to pilot an ad-hoc iOS simulator directly, launch Flutter from their own worktree in tmux, or trigger hot reload without the broker/device-harness path.
tools
Use Robdex communication via `robdex`, including role-scoped Requirements workflows. Role behavior lives in the base instructions. [skill-hash:8f2c6a9]