CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ac-tdd-runner

Run TDD cycle for feature implementation. Use when implementing features with RED-GREEN-REFACTOR, running test-driven development, automating TDD workflow, or ensuring test-first development.

Quality

81%

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

The canonical home for this skill is ac-tdd-runner in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

73%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.

A well-structured, largely executable skill body: real code against a real bundle script, a clearly sequenced three-phase workflow with explicit validation and revert loops, and an appropriate pointer to the implementation file. Weaknesses are mild redundancy (Purpose section restating the description, re-explaining standard TDD practice) and small wiring gaps around how the feature dict and configuration are supplied.

Suggestions

Remove or merge the Purpose section into the opening line — it duplicates the frontmatter description and adds no new information.

Trim comments and phase-detail items that restate standard TDD practice Claude already knows (e.g., "# Improve code structure", "Identify code smells"), keeping only runner-specific behavior.

Show how a `feature` dict is constructed (its test_cases shape) and how the Configuration JSON is passed to TDDRunner, making Quick Start fully copy-paste runnable.

DimensionReasoningScore

Conciseness

The body is mostly efficient with real API examples, but includes unnecessary padding: the "Purpose" section restates the frontmatter description almost verbatim, and comments/details like "# Improve code structure" and the RED/GREEN/REFACTOR detail lists re-explain standard TDD practice Claude already knows. This fits score 3 ('some unnecessary explanation or could be tightened') better than score 4, since the redundancy spans more than minor instances.

3 / 5

Actionability

Quick Start and phase snippets are executable and match the actual script (TDDRunner, run_cycle, red/green/refactor_phase all verified in scripts/tdd_runner.py), and the Cycle Result JSON documents the concrete output shape. Minor gaps remain — how the `feature` dict is constructed, where `project_dir` points, and how the Configuration JSON is loaded — so it stops short of fully copy-paste-ready coverage of the common cases (score 5).

4 / 5

Workflow Clarity

The TDD Cycle section sequences all three phases with code, and each phase's details include explicit validation and feedback loops: "If tests pass unexpectedly, add more specific assertions", "If tests fail, iterate on implementation. Stop when all tests pass", and "Run tests after each change. Revert if tests fail". This matches the score-5 anchor (clear sequence, explicit validation, error-recovery loops), including a revert-on-failure rollback.

5 / 5

Progressive Disclosure

Good structure: key runnable examples are inline, and the bulk implementation is one level deep in scripts/tdd_runner.py, clearly signaled by "See scripts/tdd_runner.py for full implementation" (the file and its symbols exist). It is not score 5 because the inlined Cycle Result schema and Configuration block are API details that could live in a separate reference file, and the API Reference section is a bare pointer with no key examples inline — minor organization gaps matching score 4.

4 / 5

Total

16

/

20

Passed

Description

78%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.

A strong description that explicitly states both what the skill does and when to use it, with natural trigger phrases covering the main ways a user would express a TDD need. Its main weakness is that the 'what' clause names only one action — running the cycle — rather than enumerating the concrete capabilities (writing failing tests, iterating to green, refactoring).

Suggestions

Expand the 'what' clause with 2-3 concrete actions, e.g. "Write failing tests, iterate implementations until green, and refactor — running the full RED-GREEN-REFACTOR cycle for feature implementation."

Add one or two more user-natural trigger variations such as "write the tests first" or "strict TDD workflow" to broaden keyword coverage.

DimensionReasoningScore

Specificity

"Run TDD cycle for feature implementation" names the domain and a single concrete action (running the RED-GREEN-REFACTOR cycle), but does not list several specific actions like creating failing tests, iterating implementations, or refactoring — matching the '1-2 concrete actions, not comprehensive' anchor. It exceeds score 2 because the action is domain-specific rather than generic, but falls short of score 4's 'several specific actions' with only one action stated.

3 / 5

Completeness

The 'what' is explicit ("Run TDD cycle for feature implementation") and the 'when' is explicit with concrete trigger phrases ("Use when implementing features with RED-GREEN-REFACTOR, running test-driven development, automating TDD workflow, or ensuring test-first development"). Both parts are clearly and concretely answered, matching the score-5 anchor; score 4 would require the 'when' to be less explicit than it is.

5 / 5

Trigger Term Quality

"running test-driven development", "automating TDD workflow", "ensuring test-first development", and "RED-GREEN-REFACTOR" are natural phrases a user would say when needing this skill. A few common variations are missing (e.g., "write failing tests first", "test-first coding"), so it does not reach the comprehensive synonym coverage of score 5, but it clearly exceeds the partial coverage of score 3.

4 / 5

Distinctiveness Conflict Risk

The TDD/test-first niche with RED-GREEN-REFACTOR triggers is mostly distinct from other skills, but "implementing features" is broad and could overlap with generic test-generation or feature-implementation skills. Minor overlap risk with closely related skills fits score 4 rather than score 5's 'minimal conflict risk'.

4 / 5

Total

16

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

fernandezbaptiste/Skrillz

Path

.claude/skills/ac-tdd-runner/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.