test-setup

created	"2025-12-16T00:00:00.000Z"
modified	"2026-05-09T00:00:00.000Z"
reviewed	"2026-04-25T00:00:00.000Z"
allowed-tools	Read, Write, Edit, MultiEdit, Bash(pip install *), Bash(npm install *), Bash(pre-commit *), Bash(pytest *), Bash(npm test *), Bash(git *), TodoWrite, SlashCommand
description	Configure testing infrastructure with CI/CD integration. Use when setting up testing, scaffolding unit/integration/E2E directories, adding pre-commit hooks, GitHub Actions test workflows, Codecov reporting, or coverage badges.
args	[--coverage] [--ci <github|gitlab|circleci>]
argument-hint	[--coverage] [--ci <github|gitlab|circleci>]
name	test-setup

When to Use This Skill

Use this skill when...	Use test-consult instead when...
Scaffolding test directories and pre-commit hooks for a new project	Asking "how should we test X?" before any setup
Wiring up a CI workflow with coverage reporting	Diagnosing flaky tests in an established suite
Adding test/coverage badges to the README	Choosing the right framework for a tech stack
Migrating an existing project to a standard test layout	Running the actual tests (use test-run or test-full)

Context

• Package files: !find . -maxdepth 1 \( -name "package.json" -o -name "pyproject.toml" -o -name "setup.py" -o -name "go.mod" -o -name "Cargo.toml" \) -type f
• Test config: !find . -maxdepth 1 \( -name "pytest.ini" -o -name "jest.config.*" -o -name "vitest.config.*" -o -name ".mocharc.*" \) -type f
• Pre-commit config: !find . -maxdepth 1 -name ".pre-commit-config.yaml" -type f
• GitHub Actions: !find .github/workflows -maxdepth 1 -type f -name "*.yml" -o -name "*.yaml"

Your task

1. Pre-commit Setup

• Install pre-commit if needed: pip install pre-commit
• Create/update .pre-commit-config.yaml with language-specific hooks
• Install hooks: pre-commit install
• Test with: pre-commit run --all-files

2. Test Structure

• Create test directories: tests/unit, tests/integration, tests/e2e
• Write comprehensive tests covering:
  • Unit tests for all functions
  • Integration tests for components
  • Edge cases and error handling
• Use SlashCommand: /test:run to verify test execution
• Use SlashCommand: /lint:check to ensure test code quality

3. GitHub Actions

• Create .github/workflows/tests.yml with matrix testing
• Add coverage reporting with Codecov integration
• Configure GitHub Pages for coverage reports

4. Documentation

• Set up documentation generation (Sphinx/TypeDoc/godoc)
• Create .github/workflows/docs.yml for auto-generation
• Deploy docs to GitHub Pages

5. Badges

• Add test and coverage badges to README