CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

tdd

Test-driven development and testing patterns for Rails applications. Drives implementation from tests using an outside-in approach with RSpec, Capybara, and FactoryBot. Use when building new features, writing or improving tests, adding test coverage, fixing bugs with a test-first workflow, or when the user mentions TDD, test-driven, test-first, outside-in, spec plan, RSpec, Capybara, system specs, model specs, testing patterns, writing tests, or improving test coverage.

Quality

94%

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

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 strong skill body: a numbered TDD workflow with genuine validation checkpoints and user-review stop points, executable RSpec commands, a concrete spec-plan template, a decision table for what gets its own spec, and clean one-level-deep reference files. The only weakness is mild over-explanation of general testing concepts in the Philosophy section that could be trimmed for token efficiency.

DimensionReasoningScore

Conciseness

The body is dense, imperative, and mostly free of padding — commands, a full example spec plan, and short rule statements. A few philosophy passages explain concepts Claude already knows ("Tests serve two purposes...", the Given/When/Then shape, DAMP over DRY, tautological tests), which could be trimmed; most of the philosophy instead encodes this workflow's specific doctrine (seam selection, vertical slices, stop points), so it sits at 4 rather than 3, and well above 3 rather than 5 only because of those trimmable passages.

4 / 5

Actionability

Fully executable throughout: concrete `bundle exec rspec` invocations for single files, line numbers (`spec/models/game_spec.rb:24`), description matching (`-e 'for_player'`), and the full suite; a copy-paste-ready spec-plan template under `docs/plans/<feature>-spec-plan.md`; and per-step instructions like "confirm it fails for the right reason (missing route, missing method, missing template), not a syntax error." Specific examples cover the common cases (system, model, request specs).

5 / 5

Workflow Clarity

The 5-step process is clearly sequenced with explicit validation checkpoints and feedback loops: confirm the test fails for the right reason before implementing, re-read the spec file after user edits, loop read-failure → implement → re-run until green, tick plan checkboxes, then a completeness check against the feature summary and a regression check over Related specs. The Prove-It bug pattern adds its own validate (failing repro) → fix → full-suite loop. This matches the 5 anchor's 'explicit validation steps; feedback loops for error recovery' and is clearly not the 4 anchor, whose validation is only implied ('Verify output is valid') — here validation is an explicit numbered step with a failure branch.

5 / 5

Progressive Disclosure

The SKILL.md is a well-organized overview (philosophy, process, decision table, commands) and pushes spec examples into three clearly signaled, one-level-deep references that all exist in the bundle: `references/system_spec.rb`, `references/model_spec.rb`, and `references/spec_conventions.md`, each introduced by a named section with an instruction to "Read the appropriate reference before writing a new spec." No nested references, no buried pointers, and inline content is limited to key conventions rather than full spec listings.

5 / 5

Total

19

/

20

Passed

Description

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

An excellent description: concrete domain and tooling, third-person voice, an explicit and richly keyworded 'Use when...' clause, and a well-defined niche. The only minor gap is that the capability side is somewhat single-action (drive implementation from tests) rather than enumerating multiple distinct operations.

DimensionReasoningScore

Specificity

"Drives implementation from tests using an outside-in approach with RSpec, Capybara, and FactoryBot" names the domain and the concrete core action with specific tools, and "fixing bugs with a test-first workflow" adds a second concrete action context. It falls just short of the 5 anchor's 'multiple specific concrete actions; comprehensive coverage' because the what-side centers on essentially one approach (drive implementation from tests) rather than a list of distinct capabilities.

4 / 5

Completeness

It explicitly answers both what ("Drives implementation from tests using an outside-in approach with RSpec, Capybara, and FactoryBot") and when (a full "Use when..." clause with concrete trigger phrases), matching the 5 anchor's example pattern. Voice is third person ("Drives"), so no penalty applies.

5 / 5

Trigger Term Quality

The trigger list is comprehensive and natural: "building new features, writing or improving tests, adding test coverage, fixing bugs with a test-first workflow, or when the user mentions TDD, test-driven, test-first, outside-in, spec plan, RSpec, Capybara, system specs, model specs, testing patterns, writing tests, or improving test coverage." These are exactly the phrases a user would say when they need this skill, including tool names and spec types, with synonym coverage (test-driven / test-first / TDD).

5 / 5

Distinctiveness Conflict Risk

It carves a clear niche — Rails TDD with named tools (RSpec, Capybara, FactoryBot, system/model specs) — so it would not fire for general Rails, non-Ruby testing, or unrelated document skills. Conflict risk is minimal; triggers like "spec plan" and "outside-in" are distinctive to this skill.

5 / 5

Total

19

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository

RoleModel/rolemodel-skills

Path

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