uv-tdd

Set up a Python project with a test-driven workflow using uv.

3|Updated Jan 26, 2026
One-click install
npx skills add https://github.com/gali-leilei/agent-skills-md --skill uv-tdd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: uv-tdd
Source: https://github.com/gali-leilei/agent-skills-md/tree/main/skills/uv-tdd
Command: npx skills add https://github.com/gali-leilei/agent-skills-md --skill uv-tdd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sets up a Python project with a test-driven workflow using uv.

Core Features & Use Cases

  • TDD-driven scaffolding: initialize a new Python project with uv and create an initial test structure.
  • Dependency and test workflow: add runtime and dev dependencies (e.g., pytest) and start with a basic test suite.
  • Documentation-driven development: maintain a spec.md with TODOs and update README as development progresses.

Quick Start

Create a new Python project and initialize it with uv to start test-driven development.

Frequently Asked Questions about uv-tdd

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a new Python project using uv with test-driven development?

Set up a TDD-driven Python project using uv by initializing the project structure, adding pytest as a dev dependency, creating an initial test suite, and configuring Git for version control.

What is documentation-driven development in a uv Python project?

Documentation-driven development in a uv Python project involves maintaining a spec.md file with TODOs and updating the README as development progresses alongside the test suite.

Do I need uv installed to scaffold a Python project with pytest?

Yes, you need uv installed to initialize the project and manage dependencies. You also need pytest for testing and standard Git for version control work.

Can I add runtime and dev dependencies like pytest to my uv project setup?

Yes, you can add both runtime and dev dependencies like pytest to your uv project. The scaffolding workflow integrates dependency management directly into the test-driven development cycle.

What's the best way to start test-driven development for Python from scratch?

The best way to start test-driven development from scratch is using a scaffolding workflow that initializes a uv project, sets up pytest, creates a basic test suite, and establishes Git version control.

Why does my TDD Python project need a spec.md file?

A TDD Python project needs a spec.md file to track TODOs and maintain documentation-driven development, ensuring project goals and progress are recorded as the test suite expands.