greyhaven-ai/tdd-python
grey-haven-plugins/core/skills/tdd-python/SKILL.md
Python Test-Driven Development expertise with pytest, strict red-green-refactor methodology, domain-first modeling (DDD), principled DRY discipline, FastAPI testing patterns, and Pydantic model testing. Use when implementing Python features with TDD, writing pytest tests, testing FastAPI endpoints, developing with test-first approach, modeling domain concepts, refactoring duplication, or when user mentions 'Python TDD', 'pytest', 'FastAPI testing', 'red-green-refactor', 'Python unit tests', 'test-driven Python', 'domain modeling', 'value object', 'ubiquitous language', 'DRY', or 'Python test coverage'.
$ install --global
skillsauthnpx skillsauth add greyhaven-ai/claude-code-config tdd-pythonInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 18, 2026, 7:32 AM24.4s3 files scanned
SKILL.md
- name:
- tdd-python
- description:
- Python Test-Driven Development expertise with pytest, strict red-green-refactor methodology, domain-first modeling (DDD), principled DRY discipline, FastAPI testing patterns, and Pydantic model testing. Use when implementing Python features with TDD, writing pytest tests, testing FastAPI endpoints, developing with test-first approach, modeling domain concepts, refactoring duplication, or when user mentions 'Python TDD', 'pytest', 'FastAPI testing', 'red-green-refactor', 'Python unit tests', 'test-driven Python', 'domain modeling', 'value object', 'ubiquitous language', 'DRY', or 'Python test coverage'.
- # v2.0.43:
- Skills to auto-load for subagents spawned from this skill
- # v2.0.74:
- Restrict tools available when this skill is active
TDD Python Skill
Python Test-Driven Development following strict red-green-refactor cycle with pytest — sharpened by DDD at Red (model the domain first) and DRY at Refactor (deduplicate same-concept repetition only).
Description
Systematic Python implementation using TDD methodology. Tests are written first and drive design; domain vocabulary drives the tests; duplication is removed only when the same concept repeats, not when syntax coincidentally looks alike.
Discipline Layering
- Before Red — Model the Domain: Name the entity, value object, or aggregate in the business's language. Decide entity vs. value object. Reject primitive obsession — wrap
str/intinEmailAddress,Money,NewType, orpydantic.BaseModelwhen they carry rules. Keep domain logic out of FastAPI routes. - Red: Write a failing test. Name it in domain terms (
test_rejects_refund_when_amount_exceeds_daily_limit) — never mechanical (test_returns_false). - Green: Minimal code to pass. No speculative abstractions.
- Refactor — DRY with discipline: Deduplicate only when the same domain concept appears ≥3 times with the same meaning. Three similar lines beats a premature abstraction. Promote recurring primitives to value objects. When uncertain, inline.
What's Included
- Examples: Python TDD cycles, FastAPI TDD, Pydantic model TDD, value-object modeling
- Reference: pytest patterns, Python testing best practices, branded-type idioms (
NewType,frozen=True) - Templates: pytest templates, TDD workflows
Use When
- Implementing Python features with TDD
- Modeling domain concepts (entities, value objects, aggregates)
- FastAPI endpoint development (keeping domain rules out of routes)
- Pydantic model development
- Refactoring duplication after a green test
Related Agents
tdd-python-implementer
Skill Version: 1.1
Related Skills
greyhaven-ai/testing-strategy
development
VerifiedTrustedCommunity
Grey Haven's comprehensive testing strategy - Vitest unit/integration/e2e for TypeScript, pytest markers for Python, >80% coverage requirement, fixture patterns, and Doppler for test environments. Use when writing tests, setting up test infrastructure, running tests, debugging test failures, improving coverage, configuring CI/CD, or when user mentions 'test', 'testing', 'pytest', 'vitest', 'coverage', 'TDD', 'test-driven development', 'unit test', 'integration test', 'e2e', 'end-to-end', 'test fixtures', 'mocking', 'test setup', 'CI testing'.
23SKILL.mdUpdated Apr 5, 2026
greyhaven-ai/test-generation
development
VerifiedTrustedCommunity
Comprehensive test suite generation with unit tests, integration tests, edge cases, and error handling. Use when generating tests for existing code, improving coverage, or creating systematic test suites. Triggers: 'generate tests', 'add tests', 'test coverage', 'write tests for', 'create test suite'.
23SKILL.mdUpdated Apr 5, 2026
greyhaven-ai/react-tanstack-testing
development
VerifiedTrustedCommunity
Specialized testing for React applications using TanStack ecosystem (Query, Router, Table, Form) with Vite and Vitest. Use when testing React + TanStack apps, mocking server state, testing router, or validating query behavior. Triggers: 'TanStack testing', 'React Query testing', 'test TanStack', 'mock query', 'router test'.
23SKILL.mdUpdated Apr 5, 2026
greyhaven-ai/tanstack-patterns
development
VerifiedTrustedCommunity
Apply Grey Haven's TanStack ecosystem patterns - Router file-based routing, Query data fetching with staleTime, and Start server functions. Use when building React applications with TanStack Start. Triggers: 'TanStack', 'TanStack Start', 'TanStack Query', 'TanStack Router', 'React Query', 'file-based routing', 'server functions'.
23SKILL.mdUpdated Apr 5, 2026