python-tdd-with-uv

Q: How do I install python-tdd-with-uv?

Run npx skills add https://github.com/spencerpauly/awesome-cursor-skills --skill python-tdd-with-uv in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/python-tdd-with-uv/ (personal) or .claude/skills/python-tdd-with-uv/ (project).

by spencerpaulyTesting & QA

Test-driven development in Python using uv as the package manager. Covers the red-green-refactor cycle, vertical slicing, and uv project setup.

Installs: 412
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/spencerpauly/awesome-cursor-skills --skill python-tdd-with-uv

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads python-tdd-with-uv automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Python TDD with uv

Write Python code test-first using uv for fast dependency and environment management.

Setting Up the Project

Check if uv is installed: uv --version
If the project doesn't have a pyproject.toml, initialize:
```
uv init
```
Add pytest as a dev dependency:
```
uv add --dev pytest pytest-cov
```
Confirm the test runner works:
```
uv run pytest --co
```

TDD Workflow — Vertical Slicing

Work in small cycles. Never write more than one failing test at a time.

Planning Phase

Before writing code, answer:

What interface changes are needed? (functions, classes, APIs)
Which behaviors matter most? (prioritize critical paths)
Can we design for testability? (inject dependencies, avoid global state)

The Cycle

RED   → Write ONE failing test for the next behavior
GREEN → Write the MINIMUM code to make it pass
REFACTOR → Clean up without changing behavior
REPEAT

Rules:

Never write implementation before a failing test exists
Never write more than one failing test at a time
Run uv run pytest after every change
Tests must assert observable behavior, not implementation details
Mocks should only be used at system boundaries (I/O, network, clock)

Test File Structure

# tests/test_<module>.py

class TestFeatureName:
    """Group related behaviors."""

    def test_does_expected_thing_when_given_input(self):
        result = function_under_test(input_value)
        assert result == expected

    def test_raises_when_given_invalid_input(self):
        with pytest.raises(ValueError):
            function_under_test(bad_input)

Running Tests

uv run pytest                      # all tests
uv run pytest tests/test_foo.py    # single file
uv run pytest -k "test_name"       # by name pattern
uv run pytest --cov=src            # with coverage
uv run pytest -x                   # stop on first failure

uv Essentials

uv add <package>           # add dependency
uv add --dev <package>     # add dev dependency
uv remove <package>        # remove dependency
uv sync                    # sync environment from lockfile
uv run <command>           # run in managed environment
uv lock                    # regenerate lockfile

Always use uv run to execute commands — never activate venvs manually
Commit both pyproject.toml and uv.lock

References

mattpocock/skills — TDD skill — vertical-slice TDD philosophy
nizos/tdd-guard — automated TDD enforcement via hooks
s2005/uv-skill — uv workflow patterns

FAQ

What does the python-tdd-with-uv skill do?

Test-driven development in Python using uv as the package manager. Covers the red-green-refactor cycle, vertical slicing, and uv project setup.

How do I install python-tdd-with-uv?

Run npx skills add https://github.com/spencerpauly/awesome-cursor-skills --skill python-tdd-with-uv in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/python-tdd-with-uv/ (personal) or .claude/skills/python-tdd-with-uv/ (project).

Which AI agents can use python-tdd-with-uv?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is python-tdd-with-uv safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains python-tdd-with-uv?

It is published by spencerpauly in spencerpauly/awesome-cursor-skills. It has 412 recorded installs.