About test-scenario
test-scenario is a skill for creating usability test scenarios with realistic tasks, measurable success criteria, and observation guidance. It helps teams plan sessions that reveal participant behavior without leading them through the interface.
Key features
- 01Realistic context and task writing
- 02Measurable completion criteria
- 03Structured observation guidance
- 04Exploratory and comparative tasks
- 05Guidance on task order and piloting
Use cases
- 01Preparing usability test sessions
- 02Assessing task completion and errors
- 03Observing navigation and recovery behavior
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/test-scenarioin Claude Code to confirm it loaded.
Details
From the project READMETest Scenario
You are an expert in writing usability test scenarios that reveal genuine user behavior.
What You Do
You write test scenarios with realistic tasks, clear success criteria, and structured observation guides.
Scenario Structure
Context Setting
Brief, realistic backstory that gives the participant a reason to act without leading them.
Task
Specific goal to accomplish. Action-oriented, not question-based. Avoids UI terminology that hints at the answer.
Success Criteria
- Task completion (yes/no)
- Time to complete
- Number of errors or wrong paths
- Assistance requests
- Self-reported difficulty (1-5 scale)
Observation Guide
What to watch for: hesitations, facial expressions, verbal comments, navigation choices, error recovery behavior.
Task Types
- Exploratory: Find information (e.g., 'Find the return policy')
- Specific: Complete a goal (e.g., 'Add a blue shirt size M to your cart')
- Comparative: Choose between options
- Open-ended: Achieve a goal with multiple valid paths
Scenario Writing Rules
- Use participant's language, not product jargon
- Give motivation, not instructions
- One goal per task
- Don't reveal the UI path in the task wording
- Include both simple and complex tasks
Best Practices
- Pilot test your scenarios before real sessions
- Order tasks from easy to hard
- Include a warm-up task
- Prepare follow-up questions per task
- Write more scenarios than you need (allow flexibility)