tdd-guide

579 stars 112 forks
0
C

Comprehensive Test Driven Development guide for engineering subagents with multi-framework support, coverage analysis, and intelligent test generation

CommandsAgentsMarketplace
#claude-ai#Development guide#claudecode-subagents#claude-ai-skills#Driven Development#coverage#multi-framework support#claude-skills

Third-Party Agent Skill: Review the code before installing. Agent skills execute in your AI assistant's environment and can access your files. Learn more about security

Installation for Agentic Skill

View all platforms →
skilz install alirezarezvani/claude-skills/tdd-guide
skilz install alirezarezvani/claude-skills/tdd-guide --agent opencode
skilz install alirezarezvani/claude-skills/tdd-guide --agent codex
skilz install alirezarezvani/claude-skills/tdd-guide --agent gemini

First time? Install Skilz: pip install skilz

Works with 22+ AI coding assistants

Cursor, Aider, Copilot, Windsurf, Qwen, Kimi, and more...

View All Agents
Download Agent Skill ZIP

Extract and copy to ~/.claude/skills/ then restart Claude Desktop

1. Clone the repository:
git clone https://github.com/alirezarezvani/claude-skills
2. Copy the agent skill directory:
cp -r claude-skills/engineering-team/tdd-guide ~/.claude/skills/

Need detailed installation help? Check our platform-specific guides:

Related Agentic Skills

Agentic Skill Details

Repository
claude-skills
Stars
579
Forks
112
Type
Other
Meta-Domain
Primary Domain
Market Score
0

Agent Skill Grade

C
Score: 72/100 Click to see breakdown

Score Breakdown

Spec Compliance
11/15
PDA Architecture
18/30
Ease of Use
18/25
Writing Style
5/10
Utility
16/20
Modifiers: +4

Areas to Improve

  • Description needs trigger phrases
  • SKILL.md is oversized overview
  • Marketing language throughout

Recommendations

  • Focus on improving Writing Style (currently 5/10)
  • Address 3 high-severity issues first
  • Add trigger phrases to description for discoverability

Graded: 2026-01-24

Developer Feedback

I've been working through TDD implementations lately, and your guide hits on something I've been thinking about—the gap between understanding the concept of test-first and actually making it stick in a team workflow. The C grade seems to nail it: solid foundations, but there's room to tighten up how the progression guides someone from "why TDD?" to "I'm actually doing it.

Links:

The TL;DR

You're at 72/100, solidly in C territory. The grading is based on Anthropic's best practices for agentic skills—Progressive Disclosure Architecture, ease of use, compliance, and utility. Your strongest area is Utility (16/20)—the skill actually solves real TDD problems. Weakest link is Writing Style (5/10)—there's promotional language and voice inconsistencies dragging you down.

What's Working Well

  • Problem-solving power is legit (7/8 for utility). You're addressing real needs: test generation from requirements, coverage analysis, multi-framework support. The shopping cart example actually demonstrates something useful.
  • Solid structure underneath (6/10 for layered structure). Having HOW_TO_USE.md and README.md shows you're thinking about depth. The red-green-refactor validation loop is exactly what someone needs.
  • Bonus points for grep-friendly structure (+1 modifier). You've built this thoughtfully enough that grep works well, and the scope boundaries are explicit.

The Big One: SKILL.md is Too Heavy

Your main drag is Progressive Disclosure Architecture (18/30)—specifically the token economy. SKILL.md is 288 lines when it should be a tight overview. Right now you're duplicating content from HOW_TO_USE.md and README.md inside SKILL.md itself. That's backwards.

Here's the fix: Cut SKILL.md d...

AI-Detected Topics

Extracted using NLP analysis

claude-ai Development guide claudecode-subagents claude-ai-skills Driven Development coverage multi-framework support claude-skills Test coverage analysis

Report Security Issue

Found a security vulnerability in this agent skill?