Pytest Code Review

A structured review process for pytest test files that forces you to work through five gates before flagging issues: scoping which test files you're looking at, identifying async versus sync patterns, checking fixture usage, validating mock and patch locations, and finally documenting specific findings with line numbers. It's opinionated about the order you review things, which is either helpful discipline or annoying process depending on whether you usually skip straight to nitpicking parametrize usage before confirming the async tests are even using AsyncMock correctly. The gate system prevents generic advice and makes you cite actual file paths and test node IDs. Best when you're reviewing pull requests with test changes and want to avoid the usual back and forth about whether fixtures are cleaned up or mocks are patched at the call site.

skills.sh installs: 232
GitHub stars: 87
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add existential-birds/beagle --skill pytest-code-review --agent claude-code

Installs into .claude/skills of the current project.

Files

Pytest Code Review

Quick Reference

Issue Type	Reference
async def test_*, AsyncMock, await patterns	references/async-testing.md
conftest.py, factory fixtures, scope, cleanup	references/fixtures.md
@pytest.mark.parametrize, DRY patterns	references/parametrize.md
AsyncMock tracking, patch patterns, when to mock	references/mocking.md