How do I install the Test Rig skill?

Run npx skillmds@latest add eron1703/test-rig in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Test Rig safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Test Rig?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Test Rig free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Test Rig?

eron1703 (@eron1703) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Test Rig by eron1703 — Agent Skill

Name: Test Rig
Author: eron1703

File contents

Test-Rig Development

Project: Multi-agent testing orchestration platform (CLI + API server) Location: ~/projects/test-rig/ Tech: TypeScript, Vitest, Playwright, Testcontainers Repos: GitHub (eron1703/test-rig) + GitLab (flow-master/test-rig) Version: 1.0.0 | 29 tests | Quality 7.2/10

Architecture

src/
├── cli/commands/     # CLI commands (setup, generate, run, coverage, analyze, doctor, serve)
├── core/             # Test execution (test-runner, project-detector, framework-installer, config-loader, component-analyzer, spec-generator, coverage-generator, health-checker)
├── agents/           # Multi-agent orchestration (orchestrator, test-generator)
├── server/           # Optional API server (Express + SSE streaming)
├── templates/        # Test templates with {{PLACEHOLDER}} syntax
└── utils/            # Environment detection (CI, Claude agents, non-TTY)

Key Source Files

File	Purpose
src/cli/index.ts	CLI entry point (Commander.js)
src/cli/commands/run.ts	Test execution command
src/core/test-runner.ts	Vitest/Pytest/Playwright execution + JSON output parsing
src/agents/orchestrator.ts	Parallel agent spawning, topological sort, result aggregation
src/agents/test-generator.ts	Test file generation from templates
src/server/index.ts	API server (POST /test/run, GET /test/stream, GET /health)
src/utils/environment.ts	CI/agent detection (CLAUDE_CODE, GITHUB_ACTIONS, etc.)

Development Workflow

# Edit src/ → build → test → lint
npm run build && npm test && npm run lint

# Watch mode for development
npm run test:watch

Agent Rules for This Project

ALL test-rig commands MUST use --headless, --yes, --non-interactive flags
Environment auto-detection: CLAUDE_CODE=true, CI=true, non-TTY
Templates in src/templates/ use {{COMPONENT_NAME}}, {{COMPONENT_PATH}} placeholders
Component specs (YAML) define testable units with dependency ordering
Orchestrator does topological sort for parallel execution without conflicts

Common Dev Tasks

Add new framework: framework-installer.ts → test-runner.ts → template → README Add new template: src/templates/ → test-generator.ts → postbuild copy Add CLI command: src/cli/commands/ → register in src/cli/index.ts Add API endpoint: src/server/index.ts

Quality Gates (Strict on main)

All 29 tests passing
No linting errors
Clean build (npm run build)
Push to BOTH remotes: git push github main && git push gitlab main

---name: test-rigdescription: Test-rig project development context - architecture, source structure, dev workflow (only for ~/projects/test-rig/)---# Test-Rig Development**Project:** Multi-agent testing orchestration platform (CLI + API server)**Location:** ~/projects/test-rig/**Tech:** TypeScript, Vitest, Playwright, Testcontainers**Repos:** GitHub (eron1703/test-rig) + GitLab (flow-master/test-rig)**Version:** 1.0.0 | 29 tests | Quality 7.2/10---## Architecture```src/├── cli/commands/ # CLI commands (setup, generate, run, coverage, analyze, doctor, serve)├── core/ # Test execution (test-runner, project-detector, framework-installer, config-loader, component-analyzer, spec-generator, coverage-generator, health-checker)├── agents/ # Multi-agent orchestration (orchestrator, test-generator)├── server/ # Optional API server (Express + SSE streaming)├── templates/ # Test templates with {{PLACEHOLDER}} syntax└── utils/ # Environment detection (CI, Claude agents, non-TTY)```## Key Source Files| File | Purpose ||---|---|| src/cli/index.ts | CLI entry point (Commander.js) || src/cli/commands/run.ts | Test execution command || src/core/test-runner.ts | Vitest/Pytest/Playwright execution + JSON output parsing || src/agents/orchestrator.ts | Parallel agent spawning, topological sort, result aggregation || src/agents/test-generator.ts | Test file generation from templates || src/server/index.ts | API server (POST /test/run, GET /test/stream, GET /health) || src/utils/environment.ts | CI/agent detection (CLAUDE_CODE, GITHUB_ACTIONS, etc.) |## Development Workflow```bash# Edit src/ → build → test → lintnpm run build && npm test && npm run lint# Watch mode for developmentnpm run test:watch```## Agent Rules for This Project- ALL test-rig commands MUST use `--headless`, `--yes`, `--non-interactive` flags- Environment auto-detection: CLAUDE_CODE=true, CI=true, non-TTY- Templates in src/templates/ use {{COMPONENT_NAME}}, {{COMPONENT_PATH}} placeholders- Component specs (YAML) define testable units with dependency ordering- Orchestrator does topological sort for parallel execution without conflicts## Common Dev Tasks**Add new framework:** framework-installer.ts → test-runner.ts → template → README**Add new template:** src/templates/ → test-generator.ts → postbuild copy**Add CLI command:** src/cli/commands/ → register in src/cli/index.ts**Add API endpoint:** src/server/index.ts## Quality Gates (Strict on main)- All 29 tests passing- No linting errors- Clean build (`npm run build`)- Push to BOTH remotes: `git push github main && git push gitlab main`

Frequently asked questions

Test Rig