skills/ux-test-driven-design/SKILL.md
Phase 7 of Sketch the Solution. Plan user testing sessions and validate designs. Use when asked to 'test design', 'user testing', 'validate UI', 'test driven design', or 'get feedback on design'.
npx skillsauth add arndvs/ctrlshft ux-test-driven-designInstall 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.
Output "Read UX Test Driven Design skill." to chat to acknowledge you read this file.
Pipeline position: /ux-user-stories → /ux-system-map → /ux-flow-diagram → /ux-model-attributes → /ux-screen-requirements → /ux-interface-design → /ux-test-driven-design
Decide what you want to test first. Testing is its own process.
Design is "done" when customer feedback becomes predictable — when you can correctly predict what users will do and say at each step. Until then, iterate.
interface-design.md from Phase 6Invoke /ux-user-testing
Create a structured test plan with per-screen questions. Design the feedback session script.
Invoke /ux-six-mistakes
Apply Amir Khella's "Six Mistakes of User Testing" as a validation checklist against your test plan.
Generate test-plan.md containing:
After completion, offer:
/architect — create implementation plan from validated UX artifacts/do-work — begin building the product/write-a-prd — formalize into a PRD/sketch-the-solution — return to orchestratorIf context is high, follow the standard handoff protocol (@~/dotfiles/instructions/handoff.instructions.md).
development
Use when implementing UI, checking dark/light mode, or validating animations — adds a visual feedback loop via browser screenshots so frontend changes are verified, not assumed.
development
Use when Claude Code sessions had many manual approval ("press 1") prompts or when auditing hook permissions; identifies which Bash commands required approval.
tools
Use after merging a PR or during periodic cleanup to archive plan-mode files by linking them to merged PRs.
testing
Use when stress-testing a plan against the project's domain model — grills the design, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise.