qa-test-planner

Generate comprehensive test plans, manual test cases, regression test suites, and bug reports for QA engineers. Includes Figma MCP integration for design validation.

By softaworks · 4,221 installs

npx skills add softaworks/agent-toolkit --skill qa-test-planner

Source repository · Upstream listing

QA Test Planner A comprehensive skill for QA engineers to create test plans, generate manual test cases, build regression test suites, validate designs against Figma, and document bugs effectively. Activation: This skill is triggered only when explicitly called by name (e.g., /qa test planner , qa test planner , or use the skill qa test planner ). Quick Start Create a test plan: Generate test cases: Build regression suite: Validate against Figma: Create bug report: Quick Reference Task What You Get Time Test Plan Strategy, scope, schedule, risks 10 15 min Test Cases Step by step instructions, expected results 5 10 min each Regression Suite Smoke tests, critical paths, execution order 15 20 min Figma Validation Design implementation comparison, discrepancy list 10 15 min Bug Report Reproducible steps, environment, evidence 5 min How It Works Commands Interactive Scripts Script Purpose Usage ./scripts/generate test cases.sh Create test cases interactively Step by step prompts ./scripts/create bug report.sh Generate bug reports Guided input collection Natural Language Request Output "Create test plan for {feature}" Complete test plan document "Generate {N} test cases for {feature}" Numbered test cases with steps "Build smoke test suite" Critical path tests "Compare with Figma at {URL}" Visual validation checklist "Document bug: {description}" Structured bug report Core Deliverables 1. Test Plans Test scope and objectives Testing approach and strategy Environment requirements Entry/exit criteria Risk assessment Timeline and milestones 2. Manual Test Cases Step by step instructions Expected vs actual results Preconditions and setup Test data requirements Priority and severity 3. Regression Suites Smoke tests (15 30 min) Full regression (2 4 hours) Targeted regression (30 60 min) Execution order and dependencies 4. Figma Validation Component by component comparison Spacing and typography checks Color and visual consistency Interactive state validation 5. Bug Reports Clear reproduction steps Environment details Evidence (screenshots, logs) Severity and priority Anti Patterns Avoid Why Instead Vague test steps Can't reproduce Specific actions + expected results Missing preconditions Tests fail unexpectedly Document all setup requirements No test data Tester blocked Provide sample data or generation Generic bug titles Hard to track Specific: "[Feature] issue when [action]" Skip edge cases Miss critical bugs Include boundary values, nulls Verification Checklist Test Plan: [ ] Scope clearly defined (in/out) [ ] Entry/exit criteria specified [ ] Risks identified with mitigations [ ] Timeline realistic Test Cases: [ ] Each step has expected result [ ] Preconditions documented [ ] Test data available [ ] Priority assigned Bug Reports: [ ] Reproducible steps [ ] Environment documented [ ] Screenshots/evidence attached [ ] Severity/priority set References [Test Case Templates](references/test case templates.md) Standard formats for all test types [Bug Report Templates](references/bug report templates.md) Documentation templates [Regression Testing Guide](references/regression testing.md) Suite building and execution [Figma Validation Guide](references/figma validation.md) Design implementation validation <details <summary <strong Deep Dive: Test Case Structure</strong </summary Standard Test Case Format Test Types Type Focus Example Functional Business logic Login with valid credentials UI/Visual Appearance, layout Button matches Figma design Integration Component interaction API returns data to frontend Regression Existing functionality Previous features still work Performance Speed, load handling Page loads under 3 seconds Security Vulnerabilities SQL injection prevented </details <details <summary <strong Deep Dive: Test Plan Template</strong </summary Test Plan Structure </details <details <summary <strong Deep Dive: Bug Reporting</strong </summary Bug Report Template Severity Definitions Level Criteria Examples Critical (P0) System crash, data loss, security Payment fails, login broken High (P1) Major feature broken, no workaround Search not working Medium (P2) Feature partial, workaround exists Filter missing one option Low (P3) Cosmetic, rare edge cases Typo, minor alignment </details <details <summary <strong Deep Dive: Figma MCP Integration</strong </summary Design Validation Workflow Prerequisites: Figma MCP server configured Access to Figma design files Figma URLs for components/pages Process: 1. Get Design Specs from Figma 2. Compare Implementation 3. Create Bug if Mismatch What to Validate Element What to Check Tool Colors Hex values exact Browser color picker Spacing Padding/margin px DevTools computed styles Typography Font, size, weight DevTools font panel Layout Width, height, position DevTools box model States Hover, active, focus Manual interaction Responsive Breakpoint behavior DevTools device mode Example Queries </details <details <summary <strong Deep Dive: Regression Testing</strong </summary Suite Structure Suite Type Duration Frequency Coverage Smoke 15 30 min Daily Critical paths only Targeted 30 60 min Per change Affected areas Full 2 4 hours Weekly/Release Comprehensive Sanity 10 15 min After hotfix Quick validation Building a Regression Suite Step 1: Identify Critical Paths What can users NOT live without? What generates revenue? What handles sensitive data? What's used most frequently? Step 2: Prioritize Test Cases Priority Description Must Run P0 Business critical, security Always P1 Major features, common flows Weekly+ P2 Minor features, edge cases Releases Step 3: Execution Order 1. Smoke first if fails, stop and fix build 2. P0 tests next must pass before proceeding 3. P1 then P2 track all failures 4. Exploratory find unexpected issues Pass/Fail Criteria PASS: All P0 tests pass 90%+ P1 tests pass No critical bugs open FAIL (Block Release): Any P0 test fails Critical bug discovered Security vulnerability Data loss scenario CONDITIONAL: P1 failures with workarounds Known issues documented Fix plan in place </details <details <summary <strong Deep Dive: Test Execution Tracking</strong </summary Test Run Report Template Coverage Tracking </details <details <summary <strong QA Process Workflow</strong </summary Phase 1: Planning [ ] Review requirements and designs [ ] Create test plan [ ] Identify test scenarios [ ] Estimate effort and timeline [ ] Set up test environment Phase 2: Test Design [ ] Write test cases [ ] Review test cases with team [ ] Prepare test data [ ] Build regression suite [ ] Get Figma design access Phase 3: Execution [ ] Execute test cases [ ] Log bugs with clear steps [ ] Validate against Figma (UI tests) [ ] Track test progress [ ] Communicate blockers Phase 4: Reporting [ ] Compile test results [ ] Analyze coverage [ ] Document risks [ ] Provide go/no go recommendation [ ] Archive test artifacts </details <details <summary <strong Best Practices</strong </summary Test Case Writing DO: Be specific and unambiguous Include expected results for each step Test one thing per test case Use consistent naming conventions Keep test cases maintainable DON'T: Assume knowledge Make test cases too long Skip preconditions Forget edge cases Leave expected results vague Bug Reporting DO: Provide clear reproduction steps Include screenshots/videos Specify exact environment details Describe impact on users Link to Figma for UI bugs DON'T: Report without reproduction steps Use vague descriptions Skip environment details Forget to assign priority Duplicate existing bugs Regression Testing DO: Automate repetitive tests when possible Maintain regression suite regularly Prioritize critical paths Run smoke tests frequently Update suite after each release DON'T: Skip regression before releases Let suite become outdated Test everything every time Ignore failed regression tests </details Examples <details <summary <strong Example: Login Flow Test Case</strong </summary </details <details <summary <strong Example: Responsive Design Test Case</strong </summary </details "Testing shows the presence, not the absence of bugs." Edsger Dijkstra "Quality is not an act, it is a habit." Aristotle