test-scenarios
Scannednpx machina-cli add skill phuryn/pm-skills/test-scenarios --openclawTest Scenarios
Create comprehensive test scenarios from user stories with test objectives, starting conditions, user roles, step-by-step test actions, and expected outcomes.
Use when: Writing QA test cases, creating test plans, defining acceptance test scenarios, or validating user story implementations.
Arguments:
$PRODUCT: The product or system name$USER_STORY: The user story to test (title and acceptance criteria)$CONTEXT: Additional testing context or constraints
Step-by-Step Process
- Review the user story and acceptance criteria
- Define test objectives - What specific behavior to validate
- Establish starting conditions - System state, data setup, configurations
- Identify user roles - Who performs the test actions
- Create test steps - Break down interactions step-by-step
- Define expected outcomes - Observable results after each step
- Consider edge cases - Invalid inputs, boundary conditions
- Output detailed test scenarios - Ready for QA execution
Scenario Template
Test Scenario: [Clear scenario name]
Test Objective: [What this test validates]
Starting Conditions:
- [System state required]
- [Data or configuration needed]
- [User setup or permissions]
User Role: [Who performs the test]
Test Steps:
- [First action and its expected result]
- [Second action and observable outcome]
- [Third action and system behavior]
- [Completion action and final state]
Expected Outcomes:
- [Observable result 1]
- [Observable result 2]
- [Observable result 3]
Example Test Scenario
Test Scenario: View Recently Viewed Products on Product Page
Test Objective: Verify that the 'Recently viewed' section displays correctly and excludes the current product.
Starting Conditions:
- User is logged in or has browser history enabled
- User has viewed at least 2 products in the current session
- User is now on a product page different from previously viewed items
User Role: Online Shopper
Test Steps:
- Navigate to any product page → Section should appear at bottom with previously viewed items
- Scroll to bottom of page → "Recently viewed" section is visible with product cards
- Verify product thumbnails → Images, titles, and prices are displayed correctly
- Check current product → Current product is NOT in the recently viewed list
- Click on a product card → User navigates to the corresponding product page
Expected Outcomes:
- Recently viewed section appears only after viewing at least 1 prior product
- Section displays 4-8 product cards with complete information
- Current product is excluded from the list
- Each card shows "Viewed X minutes/hours ago" timestamp
- Clicking cards navigates to correct product pages
- Performance: Section loads within 2 seconds
Output Deliverables
- Comprehensive test scenarios for each acceptance criterion
- Clear test objectives aligned with user story intent
- Detailed step-by-step test actions
- Observable expected outcomes after each step
- Edge case and error scenario coverage
- Ready for QA team execution and documentation
Source
git clone https://github.com/phuryn/pm-skills/blob/main/pm-execution/skills/test-scenarios/SKILL.mdView on GitHub Overview
This skill guides you to convert user stories into comprehensive test scenarios that include test objectives, starting conditions, user roles, step-by-step actions, and expected outcomes. It aligns with QA test case creation, test plans, acceptance testing, and feature validation by providing structured, ready-to-execute scenarios.
How This Skill Works
Follow the step-by-step process: review the user story and acceptance criteria, define test objectives, establish starting conditions, identify user roles, craft test steps, and specify expected outcomes. Use the provided scenario template to ensure consistency and to cover edge cases. The result is a set of detailed test scenarios ready for QA execution and documentation.
When to Use It
- When validating a new or updated feature against its user story and acceptance criteria
- When writing QA test cases for a feature to be added to a product
- When creating a test plan that covers end-to-end scenario coverage
- When defining acceptance tests to confirm feature validation with stakeholders
- When preparing regression tests to ensure existing behavior remains correct after changes
Quick Start
- Step 1: Review the user story and acceptance criteria
- Step 2: Define test objectives, starting conditions, and user roles
- Step 3: Create test steps and expected outcomes using the template, then add edge cases
Best Practices
- Anchor scenarios to the user story acceptance criteria
- Define clear test objectives and starting conditions
- Specify roles, data, and environment prerequisites
- Break tests into atomic steps with observable outcomes
- Include edge cases, negative tests, and performance considerations
Example Use Cases
- View Recently Viewed Products on Product Page: verifies the section appears after prior views, shows 4-8 cards, excludes the current product, and supports navigation
- Login flow with invalid credentials: ensures proper error messaging and lockout behavior after repeated failures
- Checkout process with empty cart: validates error handling and should-guide prompts when attempting purchase with no items
- Search feature with no results: confirms user feedback, suggestions, and graceful handling of empty results
- Profile update with invalid email formats: checks validation messages and prevents saving invalid data