check-test-separation

What problem does it solve?

This Skill detects and reports when unit tests and integration tests are improperly mixed in a Python/pytest codebase, helping teams maintain clear test boundaries and reduce flaky or slow test suites.

Core Features & Use Cases

• Validates directory placement under tests/unit/ and tests/integration/ and flags unclassified test files.
• Detects pytest markers (@pytest.mark.unit / @pytest.mark.integration), integration-signaling imports and call patterns, heavy mocking, and problematic conftest fixtures.
• Use cases include pre-commit or CI checks for changed files, local code review of test hygiene, and auditing large repositories for misplaced integration work.

Quick Start

Run the included AST-based checker against changed or specified test files to receive a formatted report of separation violations.