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.