test-scenarios
phuryn/pm-skills
Generate comprehensive test scenarios from user stories with objectives, conditions, steps, and expected outcomes.
What is test-scenarios?
Creates detailed QA test scenarios from user stories, including test objectives, starting conditions, user roles, step-by-step actions, and expected outcomes. Use this when writing test cases, building test plans, defining acceptance tests, or preparing feature validation.
- Define test objectives aligned with user story intent
- Establish starting conditions and system state requirements
- Identify user roles performing test actions
- Break down interactions into step-by-step test actions
- Specify observable expected outcomes after each step
- Cover edge cases and boundary conditions
How to install test-scenarios
npx skills add https://github.com/phuryn/pm-skills --skill test-scenariosHow to use test-scenarios
- 1.Provide the user story title and acceptance criteria
- 2.Supply product or system name and testing context
- 3.Review the generated test scenarios for completeness
- 4.Adapt scenario template with specific test objectives
- 5.Document starting conditions and required data setup
- 6.Execute step-by-step test actions in order
- 7.Verify observable outcomes match expected results
Use cases
- Writing QA test cases from acceptance criteria
- Creating comprehensive test plans for feature releases
- Defining acceptance test scenarios for validation
- Preparing test documentation for QA team execution
- Validating user story implementations before deployment
- QA engineers and testers
- Product managers defining test requirements
- Developers preparing acceptance tests
- Test leads creating test plans
- Quality assurance teams
test-scenarios FAQ
Provide the user story title, acceptance criteria, and any specific business rules or constraints that affect testing.
Create at least one scenario per acceptance criterion, plus additional scenarios for edge cases and error conditions.
Yes, the detailed step-by-step format and expected outcomes can be translated into automated test scripts.
Break complex workflows into multiple test scenarios, each focusing on a specific user path or acceptance criterion.
Yes, include performance expectations (load times, response times) in the expected outcomes when relevant to the feature.
Full instructions (SKILL.md)
Source of truth, from phuryn/pm-skills.
name: test-scenarios description: "Create comprehensive test scenarios from user stories with test objectives, starting conditions, user roles, step-by-step actions, and expected outcomes. Use when writing QA test cases, creating test plans, defining acceptance tests, or preparing for feature validation."
Test 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
Related skills
More from phuryn/pm-skills and the wider catalog.

user-personas
Generate 3 research-backed user personas with jobs-to-be-done, pain points, and behavioral insights.

user-segmentation
Segment users from feedback data into 3+ distinct behavioral groups based on jobs-to-be-done and needs.

user-stories
Create well-structured user stories following 3 C's and INVEST criteria with acceptance criteria and design links.

value-prop-statements
Generate targeted value proposition statements for marketing, sales, and onboarding messaging.

value-proposition
Design compelling value propositions using a 6-part JTBD template for clarity and market fit.

wwas
Create structured product backlog items in Why-What-Acceptance format with strategic context and testable outcomes.