Generates comprehensive, workable unit tests for any programming language using a multi-agent pipeline. Use when asked to generate tests, write unit tests, improve test coverage, add test coverage, create test files, or test a codebase. Supports C#, TypeScript, JavaScript, Python, Go, Rust, Java, and more. Orchestrates research, planning, and implementation phases to produce tests that compile, pass, and follow project conventions.
An AI-powered skill that generates comprehensive, workable unit tests for any programming language using a coordinated multi-agent pipeline.
Use this skill when you need to:
This skill coordinates multiple specialized agents in a Research → Plan → Implement pipeline:
┌─────────────────────────────────────────────────────────────┐
│ TEST GENERATOR │
│ Coordinates the full pipeline and manages state │
└─────────────────────┬───────────────────────────────────────┘
│
┌─────────────┼─────────────┐
▼ ▼ ▼
┌───────────┐ ┌───────────┐ ┌───────────────┐
│ RESEARCHER│ │ PLANNER │ │ IMPLEMENTER │
│ │ │ │ │ │
│ Analyzes │ │ Creates │ │ Writes tests │
│ codebase │→ │ phased │→ │ per phase │
│ │ │ plan │ │ │
└───────────┘ └───────────┘ └───────┬───────┘
│
┌─────────┬───────┼───────────┐
▼ ▼ ▼ ▼
┌─────────┐ ┌───────┐ ┌───────┐ ┌───────┐
│ BUILDER │ │TESTER │ │ FIXER │ │LINTER │
│ │ │ │ │ │ │ │
│ Compiles│ │ Runs │ │ Fixes │ │Formats│
│ code │ │ tests │ │ errors│ │ code │
└─────────┘ └───────┘ └───────┘ └───────┘
Make sure you understand what user is asking and for what scope. When the user does not express strong requirements for test style, coverage goals, or conventions, source the guidelines from unit-test-generation.prompt.md. This prompt provides best practices for discovering conventions, parameterization strategies, coverage goals (aim for 80%), and language-specific patterns.
Start by calling the polyglot-test-generator agent with your test generation request:
Generate unit tests for [path or description of what to test], following the [unit-test-generation.prompt.md](unit-test-generation.prompt.md) guidelines
The Test Generator will manage the entire pipeline automatically.
The polyglot-test-researcher agent analyzes your codebase to understand:
Output: .testagent/research.md
The polyglot-test-planner agent creates a structured implementation plan:
Output: .testagent/plan.md
The polyglot-test-implementer agent executes each phase sequentially:
polyglot-test-builder subagent to verify compilationpolyglot-test-tester subagent to verify tests passpolyglot-test-fixer subagent if errors occurpolyglot-test-linter subagent for code formattingEach phase completes before the next begins, ensuring incremental progress.
All pipeline state is stored in .testagent/ folder:
| File | Purpose |
|---|---|
.testagent/research.md | Codebase analysis results |
.testagent/plan.md | Phased implementation plan |
.testagent/status.md | Progress tracking (optional) |
Generate unit tests for my Calculator project at C:\src\Calculator
Generate unit tests for src/services/UserService.ts
Add tests for the authentication module with focus on edge cases
| Agent | Purpose | Tools |
|---|---|---|
polyglot-test-generator | Coordinates pipeline | runCommands, codebase, editFiles, search, runSubagent |
polyglot-test-researcher | Analyzes codebase | runCommands, codebase, editFiles, search, fetch, runSubagent |
polyglot-test-planner | Creates test plan | codebase, editFiles, search, runSubagent |
polyglot-test-implementer | Writes test files | runCommands, codebase, editFiles, search, runSubagent |
polyglot-test-builder | Compiles code | runCommands, codebase, search |
polyglot-test-tester | Runs tests | runCommands, codebase, search |
polyglot-test-fixer | Fixes errors | runCommands, codebase, editFiles, search |
polyglot-test-linter | Formats code | runCommands, codebase, search |
The polyglot-test-fixer agent will attempt to resolve compilation errors. Check .testagent/plan.md for the expected test structure.
Review the test output and adjust test expectations. Some tests may require mocking dependencies.
Specify your preferred framework in the initial request: "Generate Jest tests for..."