Here's a structured approach to Test-Driven Development with 42 rules across 8 categories, from critical (red-green-refactor cycle) to low priority (test pyramid strategy). Each rule gets a prefix like cycle-, design-, or isolate-, making it easy to reference specific practices. The guide walks through the full TDD workflow and includes quick references for things like the AAA pattern, test isolation, and data management. It's built for AI agents but reads like a solid developer reference. One honest take: the categorization and priority system actually makes this more useful than most TDD guides that just throw all the rules at you at once. Goes well with the separate vitest and msw skills for framework specifics.
- skills.sh installs
- 415
- GitHub stars
- 222
- last updated
- Aug 21, 2026
Install
$ npx -y skills add pproenca/dot-skills --skill tdd --agent claude-codeInstalls into .claude/skills of the current project.
Files
Community Test-Driven Development Best Practices
Comprehensive guide to Test-Driven Development practices, designed for AI agents and LLMs. Contains 42 rules across 8 categories, prioritized by impact to guide test writing, refactoring, and code generation.
When to Apply
Reference these guidelines when:
- Writing new tests using TDD workflow
- Implementing the red-green-refactor cycle
- Designing test structure and organization
- Creating test data and fixtures
- Reviewing or refactoring existing test suites
TDD Workflow
- RED: Write a failing test that defines desired behavior
- GREEN: Write minimal code to make the test pass
- REFACTOR: Clean up code while keeping tests green
- Repeat for each new behavior
Rule Categories by Priority
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/pproenca/dot-skills
- Categories
- Backend & APIs, Testing & QA, Documentation, Code Review & Quality, Automation & Workflows
- First seen
- Jun 3, 2026
More from pproenca/dot-skills
All 100- Humanize409
- React Optimise403
- Knip Deadcode390
- Rails Hotwire380
- Ts Google378
- Nginx C Module Design369
- Vite367
- Nginx C Modules365
- Ios Animations355
- Dockerfile Optimise351
- Uniwind348
- 37signals Rails340
- Ast Grep340
- Audio Voice Recovery340
- Orval338
- Mui Base335
- Codemod334
- Vhs331
- Skill Authoring330
- Unix Cli326
- Python323
- Rust Refactor322
- Ios Design System319
- 12 Factor App318
Recommended
More Backend & APIs
openrouterbobmatnyc/claude-mpm-skillsOpenRouter unified AI API - Access 200+ LLMs through single interface with intelligent routing, streaming, cost optimization, and model fallbacks413skills.sh installs
metrickit-diagnosticsdpearson2699/swift-ios-skillsCollect and analyze on-device performance metrics and crash diagnostics using MetricKit. Use when setting up MXMetricManager, handling MXMetricPayload or MXDiag409skills.sh installsmusickit-audiodpearson2699/swift-ios-skillsIntegrate Apple Music playback, catalog search, and Now Playing metadata using MusicKit and MediaPlayer. Use when adding music search, Apple Music subscription 409skills.sh installs
blog-postmblode/agent-skillsGenerates engaging long-form blog posts from source materials or a topic brief. Supports listicles, editorial tutorials, how-to articles, narrative essays, and 404skills.sh installs
telegram-bot-builderdavila7/claude-code-templatesExpert in building Telegram bots that solve real problems - from simple automation to complex AI-powered bots. Covers bot architecture, the Telegram Bot API, us403skills.sh installs
sleep-storyjwynia/agent-skillsWrite stories designed to help listeners fall asleep. Use for bedtime podcasts, meditation content, calming narratives, or any content where the goal is gentle 403skills.sh installs