skills/ux-user-testing/SKILL.md
Step 7.1 of Sketch the Solution. Create structured user testing session plan with per-screen questions. Use when asked to 'user testing', 'test plan', 'feedback session', 'validate with users', or 'customer feedback'.
npx skillsauth add arndvs/ctrlshft ux-user-testingInstall 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 User Testing skill." to chat to acknowledge you read this file.
Phase: /ux-test-driven-design → Step 1 of 2
Create a structured test plan for live feedback sessions. Design the session script with per-screen questions that probe for benefits, value, and usability issues.
## Test Session Script
### Setup
- **Tool:** Screen share (Zoom, Meet, etc.)
- **Duration:** 30 minutes
- **Recording:** ALWAYS record
### Introduction (2 min)
"Thank you for taking the time. I've put together a rough draft of [product].
Your feedback is the most important thing right now.
This is a very rough draft — anything you see can be changed.
I won't feel bad if you tell me something sucks.
I need to hear it now so it doesn't cost me money later."
### Walkthrough (~20 min)
[Walk through each screen, using the questions below]
### Wrap-up (5 min)
"What was the most helpful part?"
"What would you change first?"
"On a scale of 1-10, how useful would this be?"
### [Screen Name] — Test Questions
1. "What do you think this page is for?"
2. "How would it help you to have this?"
3. "What's the most important thing on this page to you?"
4. "How could it deliver more value?"
5. "Is anything confusing or missing?"
6. "What would you do first on this page?"
## Price Anchor Tracking
| Screen | Hidden Benefit | User Quote | Dollar Value |
|--------|---------------|------------|--------------|
| Dashboard | "Saves me 2 hours/day" | "I currently do this manually in Excel" | ~$50K/year |
| Reports | "Eliminates 1 employee" | "We have someone who just does this" | ~$60K/year |
## Outreach Email
Subject: Quick look at [product] — would love your feedback
Hey [name],
Really exciting news — I finished my first rough draft of [product].
I'd love to show it to you to get your feedback.
It'll take about 30 minutes.
How does your calendar look this week?
[Your name]
Append to test-plan.md: Session script, per-screen questions, price anchor template, outreach email.
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.