Refactoring Test Suites

Community

Standardize test suites for reliability.

Authorkynoptic
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill standardizes and cleans up messy test suites by applying project-wide conventions for test naming, structure, parameterization, and classification to improve CI reliability and developer readability across languages.

Core Features & Use Cases

  • Standardize behavioral test naming: Rename tests to describe outcomes rather than implementation details (e.g., test_should_X_when_Y, test_rejects_X_when_Y).
  • Decompose multi-assert tests: Split tests with multiple branches into atomic units with single assertions and concise summaries.
  • Parameterize repeated logic: Consolidate duplicate test structures into parameterized cases (e.g., @pytest.mark.parametrize in Python) and move shared setup to fixtures.
  • Classify and relocate tests: Move files into tests/unit/ or tests/features/ and update runners/imports.
  • Eliminate vanity tests: Remove tests that do not verify meaningful behavior; document rationale.
  • Tag and annotate tests: Add metadata tags like @unit or @integration and normalize inline comments.

Quick Start

Example: Run the Refactoring Test Suites skill on a messy PyTest project to rename tests, split atomic cases, parameterize inputs, and relocate files while applying tags for clear classification.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: Refactoring Test Suites
Download link: https://github.com/kynoptic/markdownlint-trap/archive/main.zip#refactoring-test-suites

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository