debug-tests

Automate debugging of Playwright test failures using fresh sub-agent workers.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/blackgirlbytes/team-starter-repo --skill debug-tests-blackgirlbytes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-tests
Source: https://github.com/blackgirlbytes/team-starter-repo/tree/main/.cursor/skills/audit-skills/debug-tests
Command: npx skills add https://github.com/blackgirlbytes/team-starter-repo --skill debug-tests-blackgirlbytes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the debugging of failing Playwright tests by leveraging fresh sub-agent contexts for each fix attempt, reducing manual debugging time and effort.

Core Features & Use Cases

  • Automated Failure Analysis: Identifies and analyzes failing Playwright tests.
  • Sub-Agent Fixes: Uses independent sub-agents to propose and apply fixes for each failure.
  • Parallel & Sequential Execution: Runs independent failures in parallel and coupled failures sequentially.
  • Dry-Run & Debug Modes: Allows for visibility into the plan and execution details.
  • Use Case: When your CI pipeline fails due to flaky tests, this Skill can automatically attempt to fix them, providing detailed logs and summaries of the fixes applied.

Quick Start

Run the debug-tests skill in interactive mode to start debugging failing Playwright tests.

Frequently Asked Questions about debug-tests

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How can I automate fixing failing Playwright tests in my CI/CD pipeline?

You can automate debugging failing Playwright tests by orchestrating fresh sub-agent workers for each fix attempt. This Skill automatically analyzes failures, proposes fixes, and runs independent failures in parallel while handling coupled failures sequentially.

How does sub-agent debugging handle multiple test failures at once?

Sub-agent debugging handles multiple test failures by assigning a fresh sub-agent to each fix attempt. It executes independent failures in parallel for faster resolution and processes coupled failures sequentially to maintain test stability.

Do I need a specific test runner to use automated sub-agent test debugging?

Yes, you need Playwright as your test runner. The automated sub-agent debugging process requires Playwright for test execution and relies on parsing JSON output to identify and orchestrate fixes for the failing tests.

Can I preview the debugging plan before applying fixes to my tests?

Yes, you can preview the debugging plan using the dry-run mode. This provides visibility into the proposed execution strategy and plan before any actual fixes are applied to your failing Playwright tests.

What is the best way to get detailed logs of automated Playwright test fixes?

The best way to get detailed logs is by using the debug mode. This mode provides deep visibility into the execution details and generates summaries of the fixes applied by the sub-agents to your failing tests.

When should I avoid using parallel execution for debugging flaky tests?

You should avoid parallel execution when dealing with coupled failures. The automated debugging system correctly identifies these interdependent test failures and processes them sequentially to prevent conflicting fix attempts.