CtrlK
BlogDocsLog inGet started
Tessl Logo

tdd

Strict TDD loop — red/green/refactor must be followed for every code change, no exceptions

74

1.42x
Quality

61%

Does it follow best practices?

Impact

94%

1.42x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./dot_config/opencode/skill/tdd/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

22%

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 reads as a mandate or constraint rather than a functional skill description. It lacks concrete actions the skill performs, omits a 'Use when...' clause, and misses common trigger term variations. While 'TDD' and 'red/green/refactor' provide some domain specificity, the description fails to communicate what the skill actually does or when Claude should select it.

Suggestions

Add a 'Use when...' clause specifying triggers, e.g., 'Use when the user asks to write code, implement features, fix bugs, or mentions TDD, test-driven development, or writing tests first.'

Describe concrete actions the skill performs, e.g., 'Writes a failing test before any implementation, implements minimal code to pass the test, then refactors while keeping tests green.'

Include common trigger term variations such as 'test-driven development', 'unit tests', 'write tests first', 'test before code' to improve discoverability.

DimensionReasoningScore

Specificity

The description states a methodology ('red/green/refactor') but does not list concrete actions the skill performs. It reads more like a rule or constraint than a description of capabilities.

1 / 3

Completeness

The 'what' is vaguely implied (enforce TDD) but not clearly articulated as specific actions. There is no 'when' clause or explicit trigger guidance, which per the rubric caps completeness at 2, and the weak 'what' brings it to 1.

1 / 3

Trigger Term Quality

Contains 'TDD', 'red/green/refactor', and 'code change' which are relevant keywords a user might use, but misses common variations like 'test-driven development', 'unit tests', 'write tests first', or 'test before code'.

2 / 3

Distinctiveness Conflict Risk

TDD is a fairly specific methodology, giving it some distinctiveness, but the phrase 'every code change' is broad enough that it could conflict with other coding workflow or testing skills.

2 / 3

Total

6

/

12

Passed

Implementation

100%

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

This is an excellent skill file that is lean, actionable, and well-structured. It assumes Claude's intelligence (no explanation of TDD concepts), provides concrete guidance at every step, and includes thoughtful additions like the failure modes table, mid-session recovery procedure, and checkpoint format. The workflow is clear with explicit validation gates between phases.

DimensionReasoningScore

Conciseness

Every section earns its place. No unnecessary explanations of what TDD is or why it matters — it jumps straight into the rules and loop. The failure modes table is dense and useful. No padding.

3 / 3

Actionability

Each step has concrete, specific instructions: run the test, confirm failure, write minimum code, commit. The failure modes table provides exact corrections. The checkpoint format gives a copy-paste template for tracking. This is an instruction-only skill that doesn't need code examples.

3 / 3

Workflow Clarity

The 4-step loop is clearly sequenced with explicit validation at each phase (confirm failure, confirm green, re-run after refactor). The 'Resuming Mid-Session' section handles error recovery. The checkpoint format creates a feedback loop for tracking compliance.

3 / 3

Progressive Disclosure

For a skill under 50 lines with no need for external references, the content is well-organized with clear sections (Rule, Loop, Failure Modes, Resuming, Checkpoint Format). Each section serves a distinct purpose and is easy to navigate.

3 / 3

Total

12

/

12

Passed

Validation

100%

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

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
athal7/dotfiles
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.