Turns test scenarios into actual tasks people can complete without being led to the answer. You get context setting that motivates without hinting, success criteria you can measure (time, errors, completion rate), and observation guides for what to watch. It pushes you away from asking questions and toward action-oriented goals, which is the difference between "How would you find the return policy?" and "Find the return policy." Includes task types from exploratory to open-ended and rules like no product jargon, one goal per task, and ordering easy to hard. Honestly most useful if you're running usability tests and keep accidentally writing tasks that telegraph the UI solution.

skills.sh installs
2.3K
GitHub stars
3.3K
last updated
Aug 21, 2026

Install

$ npx -y skills add owl-listener/designer-skills --skill test-scenario --agent claude-code

Installs into .claude/skills of the current project.

Files

Test 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

Sponsors

Details

Repository
github.com/owl-listener/designer-skills
Category
Testing & QA
First seen
Jun 3, 2026

More from owl-listener/designer-skills

All 68
1vinvcn avatarqavinvcn/mattpocock-skills-zh-cn交互式 QA 会话,用户以对话方式报告缺陷或问题,代理创建 GitHub issues。后台探索代码库以获取上下文和领域语言。适用于用户想报告缺陷、执行 QA、以对话方式提交 issues,或提到 “QA session” 时。2.1Kskills.sh installs
2anthropics avatarinitiating-coverageanthropics/financial-servicesCreate institutional-quality equity research initiation reports through a 5-task workflow. Tasks must be executed individually with verified prerequisites - (1)2Kskills.sh installs
3anthropics avatarcash-flow-snapshotanthropics/knowledge-work-pluginsReads AR/AP, historical cash timing, and known fixed costs from QuickBooks, PayPal, Stripe, or Square — or a CSV upload — and produces a 30/60/90-day cash flow 2Kskills.sh installs
4affaan-m avatarwindows-desktop-e2eaffaan-m/everything-claude-codewindows desktop e2e1.8Kskills.sh installs
5github avatarscaffolding-oracle-to-postgres-migration-test-projectgithub/awesome-copilotScaffolds an xUnit integration test project for validating Oracle-to-PostgreSQL database migration behavior in .NET solutions. Creates the test project, transac1.7Kskills.sh installs
6adobe avatarfind-test-contentadobe/skillsUse this when you need to find existing pages that already use a specific block in an AEM Edge Delivery Services project, for example to locate test content or 1.6Kskills.sh installs