home / skills / laurigates / claude-plugins / test-full

This skill delegates running a complete test suite to a test-runner agent, executing unit, integration, and E2E tests with optional coverage and reports.

npx playbooks add skill laurigates/claude-plugins --skill test-full

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
3.0 KB
---
model: haiku
created: 2025-12-16
modified: 2026-02-05
reviewed: 2025-12-16
allowed-tools: Task, TodoWrite
argument-hint: "[--coverage] [--parallel] [--report]"
description: Complete test suite including integration and E2E tests
name: test-full
---

## Context

- Project files: !`find . -maxdepth 1 \( -name 'pyproject.toml' -o -name 'package.json' -o -name 'Cargo.toml' -o -name 'go.mod' \) 2>/dev/null`
- Test directories: !`find . -type d \( -name "test*" -o -name "__tests__" \) 2>/dev/null`
- E2E setup: !`find . -maxdepth 1 \( -name 'playwright.config.*' -o -name 'cypress.config.*' \) 2>/dev/null`
- CI environment: !`echo "CI=$CI GITHUB_ACTIONS=$GITHUB_ACTIONS"`

## Parameters

- `--coverage`: Generate coverage report
- `--parallel`: Force parallel execution
- `--report`: Generate detailed HTML report

## Your task

**Delegate this task to the `test-runner` agent.**

Use the Task tool with `subagent_type: test-runner` to run the complete test suite. Pass all the context gathered above and specify **All Tiers** execution.

The test-runner agent should:

1. **Run tests in pyramid order** (fail fast):
   - **Tier 1 - Unit tests** first (fastest feedback)
   - **Tier 2 - Integration tests** (component interactions)
   - **Tier 3 - E2E tests** (full user flows)

2. **Apply options**:
   - If `--coverage`: Enable coverage reporting for all tiers
   - If `--parallel`: Run tests in parallel where safe
   - If `--report`: Generate HTML report

3. **Stop on failure** at any tier (don't waste time on later tiers)

4. **Provide pyramid summary**:
   ```
   ## Full Test Suite: [PASSED|FAILED]

   | Tier        | Passed | Failed | Duration |
   |-------------|--------|--------|----------|
   | Unit        | X      | Y      | Zs       |
   | Integration | X      | Y      | Zs       |
   | E2E         | X      | Y      | Zs       |

   Coverage: XX% (target: 80%)

   ### Failures
   [Grouped by tier with file:line references]

   ### Recommended Actions
   - [Specific next steps]
   ```

5. **Post-action guidance**:
   - All pass: Ready to commit/PR
   - Unit failures: Fix immediately, use `/test:quick` for iteration
   - Integration failures: Check service boundaries
   - E2E failures: Check selectors/timing
   - Coverage gaps: Use `/test:consult coverage`

Provide the agent with:
- All context from the section above
- The parsed parameters
- **Explicit instruction**: Run all tiers in order

The agent has expertise in:
- Full test pyramid execution
- Coverage analysis and reporting
- E2E test frameworks (Playwright, Cypress)
- CI/CD integration

## Agent Teams (Optional)

For large test suites, spawn teammates for parallel test execution:

| Teammate | Focus | Value |
|----------|-------|-------|
| Unit test runner | Fast unit tests | Quick feedback loop, fail-fast |
| Integration test runner | Component interactions | Service boundary validation |
| E2E test runner | Full user flows | End-to-end verification |

Each teammate runs its tier independently and reports results via the shared task list. This is optional — the skill runs tiers sequentially without agent teams.

Overview

This skill delegates and orchestrates a complete test suite run across the full test pyramid: unit, integration, and E2E. It coordinates fail-fast execution, optional coverage, parallelism, and HTML reporting, then returns a concise pyramid summary and actionable next steps. Use it to get reliable, CI-ready test results before committing or opening a PR.

How this skill works

The skill gathers repository test context (project files, test directories, Playwright/Cypress configs and CI flags) and passes that plus parsed CLI parameters to a specialized test-runner agent. The test-runner executes tiers in pyramid order (unit → integration → E2E), applies --coverage, --parallel, and --report options, stops on the first failing tier, and produces a structured summary with coverage and grouped failures. It can optionally spawn tier-specific teammates for parallel execution in large suites.

When to use it

  • Before merging or opening a PR to validate full test pyramid
  • When you need an automated fail-fast test run in CI or locally
  • To generate coverage reports and HTML test artifacts
  • When validating E2E flows after integration changes
  • During release gating to ensure all tiers pass

Best practices

  • Run locally with --coverage to verify instrumentation before CI runs
  • Use --parallel only when tests are isolated and do not share state
  • Fail fast: address unit test failures immediately before higher-tier runs
  • Keep E2E selectors and timing stable to minimize flaky tests
  • Set a coverage target (e.g., 80%) and treat regressions as blockers

Example use cases

  • CI job that runs the full pyramid with --coverage and --report before merging
  • Local pre-commit check that runs only Tier 1 fast unit tests (fail fast)
  • Nightly job that runs all tiers in sequence and uploads HTML reports
  • Debugging a flaky E2E by reproducing the exact sequence using the test-runner agent
  • Large repo: spawn teammate runners for each tier to speed up overall execution

FAQ

What parameters can I pass to the skill?

Supported flags: --coverage (enable coverage for all tiers), --parallel (force parallel execution where safe), --report (generate detailed HTML report).

Will the runner continue if a tier fails?

No. The runner stops on the first failing tier and returns a pyramid summary so you can fix issues before proceeding to slower tiers.