CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

tdd-workflows-tdd-cycle

Use when working with tdd workflows tdd cycle

Quality

61%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/tdd-workflows-tdd-cycle/SKILL.md

The canonical home for this skill is tdd-workflows-tdd-cycle in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

70%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body delivers an unusually rigorous TDD workflow — explicit phase gates, per-phase checklists, failure recovery, and concrete agent prompts for every step. Its weaknesses are a broken reference to a nonexistent playbook file, meaningful redundancy across the four summary/discipline sections, and meta-filler that should be removed.

Suggestions

Fix or remove the reference to `resources/implementation-playbook.md` — the file does not exist in the bundle, so the pointer at line 24 is a dead end; either ship the playbook or move detailed material (metrics, anti-patterns, coverage details) into it.

Consolidate the overlapping discipline sections (Validation Checkpoints, Anti-Patterns to Avoid, Success Criteria, Notes) into one — the red-green-refactor rules are restated four times.

Delete the "[Extended thinking: ...]" bracketed filler and the stray trailing line "TDD implementation for: $ARGUMENTS", which read as generation artifacts rather than instructions.

DimensionReasoningScore

Conciseness

The core 12-step orchestration is dense and earns its tokens, but there is real tightening to do: discipline rules are restated across Validation Checkpoints, Anti-Patterns, Success Criteria, and Notes; the "[Extended thinking: ...]" bracketed filler and the stray trailing fragment "TDD implementation for: $ARGUMENTS" add nothing; and the generic boilerplate bullets ("Clarify goals, constraints, and required inputs") are padding. Not 2 because it never explains concepts Claude already knows — no "what is TDD" primer — and the duplication, while several sections, is peripheral rather than pervasive.

3 / 5

Actionability

Each of the 12 steps specifies the exact Task tool subagent_type and a ready-to-use prompt, with explicit outputs, gates, and constraints — concrete, executable orchestration guidance for an instruction-only skill. Not 5 because it assumes the referenced subagent types exist without setup guidance, and omits the actual mechanics of running tests and measuring coverage (no commands or tool specifics for those verification steps).

4 / 5

Workflow Clarity

The multi-step process is clearly sequenced into 6 phases / 12 numbered steps with explicit GATE checkpoints ("Do not proceed until all tests fail appropriately"), per-phase validation checklists, a failure-recovery feedback loop (STOP → identify violated phase → rollback → resume → document), and two well-defined modes (incremental vs suite). This matches the anchor's "explicit validation steps; feedback loops for error recovery; checklists for complex processes".

5 / 5

Progressive Disclosure

Sections are well-organized, but the only reference — "open `resources/implementation-playbook.md`" — points to a file that does not exist in the bundle (no resources/ directory), and secondary material (metrics tracking, anti-patterns, coverage report types) is inlined in a ~215-line body that could be offloaded. Not 4 because a broken reference is a navigation failure, not a minor organization gap; not 2 because the body itself has clear headers and reasonable structure.

3 / 5

Total

15

/

20

Passed

Description

36%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is a circular, auto-generated-feeling trigger clause that names the domain but says nothing about what the skill does. It relies on a single jargon keyword ("tdd") instead of the natural phrases users would say, severely limiting discoverability and differentiation.

Suggestions

State what the skill does before the trigger, e.g. "Executes a strict red-green-refactor TDD cycle with phase gates, coverage thresholds, and refactoring triggers" — this fixes the missing 'what' that caps completeness.

Spell out "test-driven development (TDD)" and add natural trigger terms users actually say: "red green refactor", "write tests first", "unit tests", "test coverage".

Drop the duplicated jargon phrase "tdd workflows tdd cycle" (it repeats 'tdd' twice) and make the 'when' clause concrete, e.g. "Use when implementing a feature or module test-first".

DimensionReasoningScore

Specificity

The description is only "Use when working with tdd workflows tdd cycle" — it names the TDD domain but contains zero action verbs or capabilities (not even the minimal action of anchor 2's "Processes PDF files"), yet is not entirely vague since the domain is identified. Not 1 because TDD is a concrete, named domain rather than pure abstraction like "Helps with documents".

2 / 5

Completeness

Only a 'when' clause is present ("Use when working with...") with no 'what' whatsoever — exactly anchor 2's "only 'when' is present without 'what'" pattern ("Use when working with documents"). Not 3 because there is no statement of what the skill does at all, not even an implicit one; not 1 because the 'when' half, while circular, is present and domain-anchored.

2 / 5

Trigger Term Quality

"tdd" is a keyword users genuinely say, but the description misses the natural phrases and synonyms — "test-driven development", "red green refactor", "write tests first", "unit tests" — leaving only the repetitive jargon phrase "tdd workflows tdd cycle". Not 4 because the missing variations are the most common ways users would actually phrase the request, not just a few gaps.

3 / 5

Distinctiveness Conflict Risk

TDD is a recognizable niche, but with no stated capabilities the description could overlap with generic testing, unit-testing, or code-review skills that also trigger on "tests". Not 4 because nothing in the description distinguishes it from those related skills; not 2 because "tdd cycle" is specific enough to avoid conflict with the vast majority of unrelated skills.

3 / 5

Total

10

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/tdd-workflows-tdd-cycle/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.