Back to Skills

run-tests

verified

Comprehensive test execution with parallel analysis and coverage reporting. Use when running test suites or troubleshooting failures with the run-tests workflow.

View on GitHub

Marketplace

orchestkit

yonatangross/orchestkit

Plugin

orchestkit-complete

development

Repository

yonatangross/orchestkit
33stars

./skills/run-tests/SKILL.md

Last Verified

January 24, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/yonatangross/orchestkit/blob/main/./skills/run-tests/SKILL.md -a claude-code --skill run-tests

Installation paths:

Claude
.claude/skills/run-tests/
Powered by add-skill CLI

Instructions

# Run Tests

Test execution with parallel analysis agents for failures.

## Quick Start

```bash
/run-tests
/run-tests backend
/run-tests frontend
/run-tests tests/unit/test_auth.py
```

## Test Scope

| Argument | Scope |
|----------|-------|
| Empty/`all` | All tests |
| `backend` | Backend only |
| `frontend` | Frontend only |
| `path/to/test.py` | Specific file |
| `test_name` | Specific test |

## Phase 1: Execute Tests

```bash
# Backend with coverage
cd backend
poetry run pytest tests/unit/ -v --tb=short \
  --cov=app --cov-report=term-missing

# Frontend with coverage
cd frontend
npm run test -- --coverage
```

## Phase 2: Failure Analysis

If tests fail, launch 3 parallel analyzers:
1. **Backend Failure Analysis** - Root cause, fix suggestions
2. **Frontend Failure Analysis** - Component issues, mock problems
3. **Coverage Gap Analysis** - Low coverage areas

## Phase 3: Generate Report

```markdown
# Test Results Report

## Summary
| Suite | Total | Passed | Failed | Coverage |
|-------|-------|--------|--------|----------|
| Backend | X | Y | Z | XX% |
| Frontend | X | Y | Z | XX% |

## Status: [ALL PASS | SOME FAILURES]

## Failures (if any)
| Test | Error | Fix |
|------|-------|-----|
| test_name | AssertionError | [suggestion] |
```

## Quick Commands

```bash
# All backend tests
poetry run pytest tests/unit/ -v --tb=short

# With coverage
poetry run pytest tests/unit/ --cov=app

# Quick (no tracebacks)
poetry run pytest tests/unit/ --tb=no -q

# Specific test
poetry run pytest tests/unit/ -k "test_name" -v

# Frontend
npm run test -- --coverage

# Watch mode
npm run test -- --watch
```

## Key Options

| Option | Purpose |
|--------|---------|
| `--maxfail=3` | Stop after 3 failures |
| `-x` | Stop on first failure |
| `--lf` | Run only last failed |
| `-v` | Verbose output |
| `--tb=short` | Shorter tracebacks |

## Related Skills

- `unit-testing` - Unit test patterns and best practices
- `integration-testing` - Integration test patterns for compon

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
2574 chars