CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-tdd-london-swarm

Agent skill for tdd-london-swarm - invoke with $agent-tdd-london-swarm

52

1.01x
Quality

28%

Does it follow best practices?

Impact

93%

1.01x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/agent-tdd-london-swarm/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

36%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 contains genuinely useful London School TDD patterns but is padded with three overlapping coordination sections, opens with a junk duplicate frontmatter block, and leans on fictional swarm APIs that can't be executed. It also never gives the agent an actual ordered TDD workflow to follow.

Suggestions

Replace the topic-catalog layout with a sequenced workflow (e.g. 1. write failing acceptance test outside-in, 2. mock collaborator contracts, 3. drive implementation inward, 4. run the suite and refactor) with explicit validation checkpoints.

Remove or define the non-existent APIs ('createSwarmMock', 'swarmCoordinator', 'SwarmContractMonitor', 'toSatisfyContract', 'toHaveBeenCalledBefore') — either show their real implementations in a scripts/ file or drop those examples in favor of plain Jest.

Cut the duplicate YAML block at the top of the body (with its malformed '>$dev$null' shell) and merge the redundant 'Swarm Coordination Patterns', 'Swarm Integration', and 'Best Practices' sections into one, moving extended contract examples into a references/ file.

DimensionReasoningScore

Conciseness

The ~245-line body opens with a duplicate YAML frontmatter block (including malformed shell like '>$dev$null') and restates the same mock/contract/coordination material across 'Swarm Coordination Patterns', 'Swarm Integration', and 'Best Practices' — several noticeably padded sections matching anchor 2. It is not 3 because the redundancy is extensive rather than incidental, and not 1 because it does not spend space explaining concepts Claude already knows (it never defines what mocks or TDD are).

2 / 5

Actionability

The core Jest examples (mockRepository definitions, toHaveBeenCalledWith assertions) are concrete, but a large share depends on undefined infrastructure — 'swarmCoordinator.notifyTestStart', 'createSwarmMock', 'extendSwarmMock', 'SwarmContractMonitor', 'toSatisfyContract', 'toHaveBeenCalledBefore' — none of which exist as shown. This matches anchor 3 (concrete guidance but incomplete / non-executable in key places): better than 2 because real executable patterns are present, worse than 4 because the missing definitions are more than minor gaps.

3 / 5

Workflow Clarity

The body is organized as topic catalogs (methodology, patterns, strategies, integration) with no sequenced process — no red/green/refactor loop, no ordered outside-in steps, no validation checkpoints for when a test or contract fails. This matches anchor 2 (rough implied sequence, many gaps, poorly defined steps): the 'Outside-In Development Flow' section title gestures at a sequence without defining one, so it cannot reach 3, and it avoids 1 because the sections do imply a coherent overall direction.

2 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are all absent), so everything is inline in one ~250-line file. Section headers are reasonable, but the methodology examples, contract-testing patterns, and swarm coordination material are all content that would belong in separate reference files, matching anchor 3 (some structure, content that should be separate is inline). Not 4 because at this length a SKILL.md overview plus one-level-deep references is clearly warranted; not 2 because the sections are clearly labeled and navigable.

3 / 5

Total

10

/

20

Passed

Description

21%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 is boilerplate placeholder text that merely echoes the skill's slug and an invocation hint. It conveys no capabilities, no trigger terms, and no use conditions, and should be rewritten to state what the skill does (mock-driven, outside-in TDD guidance) and when to invoke it.

Suggestions

Rewrite the description to state concrete capabilities in third person, e.g. 'Guides mock-driven, outside-in (London School) TDD: defines collaborator contracts with mocks, verifies object interactions, and coordinates test coverage across swarm agents.'

Add an explicit trigger clause: 'Use when writing tests test-first, designing through mocks/stubs, verifying interactions between objects, or when the user mentions London School, mockist TDD, or contract testing.'

Drop the auto-generated boilerplate ('Agent skill for ... - invoke with $agent-tdd-london-swarm') — it wastes the description budget and adds no trigger value.

DimensionReasoningScore

Specificity

The description 'Agent skill for tdd-london-swarm - invoke with $agent-tdd-london-swarm' names the domain only via the slug and contains no action verbs whatsoever, sitting between anchor 1 (no concrete actions) and anchor 2 (names domain, generic actions). It names a domain but describes zero actions, so it cannot reach 3, and it is not 'entirely vague' since the slug identifies a specific niche, keeping it above 1.

2 / 5

Completeness

There is only a vague 'what' implied by the skill name ('Agent skill for tdd-london-swarm') and no 'when' clause at all, exactly matching anchor 2 ('has a vague what and no when'). It cannot score 3 because the 'what' is never explicitly stated in the description text itself, and not 1 because the slug does gesture at the skill's purpose.

2 / 5

Trigger Term Quality

The only terms present are technical slug jargon ('tdd-london-swarm', '$agent-tdd-london-swarm'); none of the natural phrases a user would actually say (mocks, mockist, test-first, London school, behavior verification) appear. This matches anchor 1 — only technical jargon, no natural keywords — and does not warrant 2 because even a single generic natural keyword is absent.

1 / 5

Distinctiveness Conflict Risk

The slug 'tdd-london-swarm' is fairly specific, but the description provides no differentiating capability statements, so it could overlap with any general TDD, mocking, or testing skill — matching anchor 3 (somewhat specific but could still overlap). Not 4 because nothing in the prose distinguishes it from sibling testing skills.

3 / 5

Total

8

/

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
ruvnet/ruflo
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.