CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

moai-workflow-tdd

Test-Driven Development workflow specialist using RED-GREEN-REFACTOR cycle for test-first software development. Use when developing new features from scratch or when behavior specification drives implementation.

Quality

72%

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 ./.claude/skills/moai-workflow-tdd/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

55%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 workflow itself is clearly sequenced with strong validation checkpoints, error recovery, and a falsifiable verification matrix — the strongest part of the skill. However, the body is noticeably padded with repeated TDD/DDD comparisons and phase descriptions of knowledge Claude already has, the execution guidance lacks concrete commands or inline examples, and the two existing reference files are never linked from the body.

Suggestions

Cut the body to the workflow essentials: the TDD/DDD distinction is stated three times (Development Mode Configuration, Core Philosophy, Integration Points) and the phases are described twice (Implementation Guide, Standard TDD Session) — keep one authoritative copy of each and delete the rest.

Link the existing bundle files from the body, e.g. '**Examples**: See [references/examples.md](references/examples.md)' and '**Reference**: See [references/reference.md](references/reference.md)', and remove the body sections that duplicate reference.md content (phase guides, coverage table, naming conventions).

Add one concrete inline artifact to the execution steps — a minimal failing-test/example pair or the actual test-runner command (e.g. `pytest -x`) — since 'Write first failing test' and 'Run test to verify it passes' never show how to run the cycle.

DimensionReasoningScore

Conciseness

Noticeably verbose with several padded sections: the TDD/DDD distinction is stated three times ('Key distinction' in Development Mode Configuration, 'TDD vs DDD Comparison' in Core Philosophy, and again in 'With DDD Workflow' under Integration Points); the RED-GREEN-REFACTOR phases are fully described in 'Implementation Guide' and then repeated step-by-step in 'Standard TDD Session' and 'TDD Loop Pattern'; and sections restate basic knowledge Claude already has ('Arrange: Set up test data and dependencies... Assert: Verify the expected outcome', 'Remove duplication / Improve naming and readability / Extract methods'). It is not anchor 1 because genuinely skill-specific material (the .moai config mode selection, coverage thresholds, TRUST validation, anti-cheat invariants, red flags) does earn its place.

2 / 5

Actionability

Some concrete guidance exists ('Minimum 80% coverage per commit', '90% recommended for new code', the Verification checklist, and the two enforced anti-cheat invariants requiring verbatim RED output), but the core execution guidance is high-level — 'Write first failing test', 'Run test to verify it passes' — with no test-runner command or example test in the body, and the concrete RED-GREEN-REFACTOR code examples that exist in references/examples.md are never linked. This places it at the some-concrete-but-incomplete anchor rather than the mostly-executable anchor 4.

3 / 5

Workflow Clarity

The RED-GREEN-REFACTOR sequence is explicit with per-phase validation checkpoints ('The test must fail initially', 'Run the test to confirm it passes', 'No other tests should break', 'If any test fails, revert immediately'), feedback loops for error recovery ('Refactoring Breaks Tests: Revert immediately / Refactor in smaller steps'), dedicated recovery procedures for discipline breakdown, and a final verification checklist — matching the clear-sequence-with-explicit-validation-and-recovery anchor.

5 / 5

Progressive Disclosure

The body has clear section structure, but neither references/examples.md nor references/reference.md is mentioned or linked anywhere in the body — the references are present yet completely unsignaled. Additionally, references/reference.md duplicates body content (phase guidance, coverage thresholds) and ~150 lines of detailed phase/philosophy guidance that belongs in a separate file sit inline. It is above anchor 2 because the body is well-sectioned rather than a monolithic wall, but below anchor 4 because no navigation to the bundle files exists at all.

3 / 5

Total

13

/

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 clearly and explicitly states both what the skill does and when to use it, with domain-specific trigger terminology. The main gaps are the missing 'TDD' abbreviation/synonyms and the absence of concrete action verbs, which leave it just short of the top anchors on specificity and trigger coverage.

DimensionReasoningScore

Specificity

The description names the domain ('Test-Driven Development workflow specialist') and the core methodology ('using RED-GREEN-REFACTOR cycle for test-first software development'), which is slightly more than the domain-only anchor, but it lists no concrete actions such as 'write failing tests first' or 'implement minimal code' — it is a role/methodology descriptor rather than an action list, so it does not reach anchor 4.

3 / 5

Completeness

Both questions are answered explicitly: what ('Test-Driven Development workflow specialist using RED-GREEN-REFACTOR cycle for test-first software development') and when ('Use when developing new features from scratch or when behavior specification drives implementation') — an explicit 'Use when' clause with two concrete trigger conditions, matching the anchor-5 example pattern.

5 / 5

Trigger Term Quality

Good keyword coverage with natural phrases users would say: 'Test-Driven Development', 'test-first', 'new features from scratch', 'behavior specification'. A few natural terms are missing — the common abbreviation 'TDD' and phrasings like 'write tests first' — so it does not reach the comprehensive-synonyms anchor 5, but it is well above the generic-keyword anchors.

4 / 5

Distinctiveness Conflict Risk

TDD is a clear niche with distinct triggers ('RED-GREEN-REFACTOR', 'test-first', 'behavior specification'), but minor overlap risk remains with the closely related testing and DDD workflows when a user generically asks about writing tests or refactoring, so it stops short of minimal-conflict anchor 5.

4 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

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

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

modu-ai/moai-adk

Path

.claude/skills/moai-workflow-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.