# Shard slow pytest suites by historic timings before CI bottlenecks pile up with pytest-split

> Lets an agent split a large pytest suite into timing-balanced shards so parallel CI lanes finish faster and with less variance.

- Skill: `agentskillexchange/shard-slow-pytest-suites-by-historic-timings-before-ci-bottl` (Agent Skill)
- Install (CLI): `npx skillmds@latest add agentskillexchange/shard-slow-pytest-suites-by-historic-timings-before-ci-bottl`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentskillexchange/shard-slow-pytest-suites-by-historic-timings-before-ci-bottl/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: agentskillexchange (https://skillmd.com/u/agentskillexchange)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/agentskillexchange/shard-slow-pytest-suites-by-historic-timings-before-ci-bottl

---


# Shard slow pytest suites by historic timings before CI bottlenecks pile up with pytest-split

Lets an agent split a large pytest suite into timing-balanced shards so parallel CI lanes finish faster and with less variance.

## Prerequisites

Python, pytest, pytest-split

## Installation

Use the upstream install or setup path that matches your environment:
- pip install pytest-split

Requirements and caveats from upstream:
- [![PyPI](https://img.shields.io/pypi/v/pytest-split?style=flat-square)](https://pypi.python.org/pypi/pytest-split/)
- [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pytest-split?style=flat-square)](https://pypi.python.org/pypi/pytest-split/)
- [![PyPI - License](https://img.shields.io/pypi/l/pytest-split?style=flat-square)](https://pypi.python.org/pypi/pytest-split/)

Basic usage or getting-started notes:
- For example, some test suites may be fragile considering the order in which the tests are executed.
- sh
- First we have to store test durations from a complete test suite run.

- Source: https://github.com/jerry-git/pytest-split
- Extracted from upstream docs: https://raw.githubusercontent.com/jerry-git/pytest-split/HEAD/README.md

## Documentation

- https://github.com/jerry-git/pytest-split

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/shard-slow-pytest-suites-by-historic-timings-before-ci-bottlenecks-pile-up-with-pytest-split/)