CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

tdd-orchestrator

Master TDD orchestrator specializing in red-green-refactor discipline, multi-agent workflow coordination, and comprehensive test-driven development practices.

Quality

41%

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/skills/tdd-orchestrator/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

10%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 is a persona document, not an operational skill: it describes what an ideal TDD orchestrator is, but never instructs Claude how to do anything concrete. Its one progressive-disclosure pointer references a file that does not exist, and nearly all content is padding that should be deleted or moved to real reference files.

Suggestions

Cut the Expert Purpose, Capabilities, Behavioral Traits, Knowledge Base, and Example Interactions sections down to a lean overview (or move genuinely needed detail into real reference files); the current ~195 lines could compress to well under 50 without losing actionable content.

Add concrete, executable guidance — e.g. a worked red-green-refactor loop with actual pytest/Jest commands, a coverage/mutation-testing snippet, and a specific agent-delegation pattern — so Claude knows exactly what to do instead of being told to "apply relevant best practices".

Fix progressive disclosure: either create resources/implementation-playbook.md with the detailed examples the body promises, or remove the dangling reference; as written, the only pointer in the skill leads to a nonexistent file.

DimensionReasoningScore

Conciseness

Roughly 170 of the ~195 lines are padded persona material ("Elite TDD orchestrator", twelve capability sections of abstract noun-phrase bullets, behavioral traits, knowledge-base lists) that add nothing Claude does not already know — this is the 'heavily padded' anchor, not level 2, which presumes only several padded sections around useful content.

1 / 5

Actionability

There is no code, command, or concrete example anywhere; the instructions are "Clarify goals, constraints, and required inputs. Apply relevant best practices and validate outcomes" and the 8-step Response Approach is equally abstract ("Establish TDD discipline", "Optimize test execution") — 'entirely vague or abstract; only describes rather than instructs'.

1 / 5

Workflow Clarity

The Response Approach provides a rough 8-step sequence, but the steps are poorly defined abstractions with no validation checkpoints or error-recovery loops, matching anchor 2 rather than 1 (a sequence exists) or 3 (anchor 3's steps are concrete and merely lack checkpoints).

2 / 5

Progressive Disclosure

The ~170 lines of capability catalogs clearly belong in separate reference files but are inlined, and the single external reference ("open resources/implementation-playbook.md") is dangling — no resources/ directory exists in the bundle, so the only disclosure mechanism is broken, matching the 'content that clearly belongs in separate files is inlined' anchor.

2 / 5

Total

6

/

20

Passed

Description

45%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 names a clear domain (TDD / red-green-refactor) but is written as buzzword-heavy persona copy with no concrete actions and no 'use when' trigger guidance. It would rarely be selected confidently at the right moment because it never tells Claude (or the user) when to reach for it.

Suggestions

Add an explicit trigger clause, e.g. "Use when implementing features test-first, writing unit/integration tests before code, or coordinating red-green-refactor cycles across agents or teams."

Replace buzzword phrases ("Master... specializing in... comprehensive...") with concrete verb-led actions such as "Orchestrates red-green-refactor cycles, delegates test-writing to agents, enforces test-first compliance".

Include natural trigger synonyms users actually say — "write the tests first", "unit testing", "test coverage", "refactor with a safety net" — to improve trigger matching and distinctiveness.

DimensionReasoningScore

Specificity

The description names the TDD domain but uses nominal buzzword phrases ("Master TDD orchestrator", "comprehensive test-driven development practices") with no verb-led concrete actions, matching the 'names the domain but actions are minimal or generic' anchor rather than the level-3 anchor requiring 1-2 concrete actions.

2 / 5

Completeness

The 'what' is discernible (TDD cycle orchestration, multi-agent coordination) but the 'when' is entirely absent — there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3. It is not 2 because the 'what' clearly names the domain rather than being extremely vague.

3 / 5

Trigger Term Quality

"red-green-refactor", "TDD", and "test-driven development" are natural keywords users would say, but common variations and synonyms (e.g. "write tests first", "unit testing", "test coverage") are missing, matching the 'some relevant keywords but missing common variations' anchor.

3 / 5

Distinctiveness Conflict Risk

The TDD niche is somewhat specific, but "multi-agent workflow coordination" is broad enough to overlap with generic workflow-orchestration and testing skills, matching 'somewhat specific but could still overlap with similar skills' rather than the mostly-distinct level 4.

3 / 5

Total

11

/

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/skills/tdd-orchestrator/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.