CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

testland/definition-of-done

Use when a team has no Definition of Done, wants to revise it, or is about to mark a story or PR done without checking it. Drafts a starter DoD and a per-PR checklist, and audits work line by line against an existing DoD with repository evidence, never on self-attestation.

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

Overview
Quality
Evals
Security
Files

Quality

Content

88%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 is a highly actionable, well-validated reference whose audit method is sequenced with explicit checkpoints and feedback loops, and its one bundle file is real, clearly signaled, and one level deep. Remaining gains are token efficiency (deduplicate the Scrum Guide quotations) and splitting more of the audit detail into the references directory.

Suggestions

Deduplicate the Scrum Guide quotations: the DoD definition appears in full in Overview, again in 'Per-organization vs per-team', and paraphrased in References — keep one authoritative quote and cite it elsewhere.

Consider moving the 11-row 'Line-pattern to evidence mapping' table (and possibly the worked verdict cases) into a references/ file, keeping SKILL.md as a leaner spine with clearly signaled one-level-deep pointers.

DimensionReasoningScore

Conciseness

The body is dense and earns most of its tokens (templates, evidence-mapping table, verdict rules), but the Scrum Guide DoD quote is repeated — full text in Overview, repeated again under "Per-organization vs per-team", and paraphrased a third time in References. That places it at the 4 anchor (efficient with minor instances that could be trimmed) rather than 5, but well above 3 since there is no explanation of concepts Claude already knows beyond the functional quotations.

4 / 5

Actionability

Guidance is fully executable: copy-paste-ready markdown for the starter DoD, PR template, and audit report; exact commands with documented JSON fields ("gh pr view --json reviews,reviewDecision", "statusCheckRollup"); LCOV LH/LF per-file rate math; and an explicit condition-to-verdict decision table. It matches the 5 anchor — specific, ready-to-use instruction covering the common cases.

5 / 5

Workflow Clarity

The audit workflow is clearly sequenced with explicit validation: pin the checklist revision and evidence window, split atomic lines, handle conditional branches, map line patterns to named artifacts, assign one of three states with required evidence, and apply the verdict table. Feedback loops are explicit ("unverifiable never auto-passes - it clears only when a named person supplies the missing evidence"; unenforceable lines are handed back to authoring rather than waived).

5 / 5

Progressive Disclosure

The worked example is correctly split into references/adherence-worked-example.md (verified to exist), clearly signaled ("A full stage-2 audit worked end to end is in [references/adherence-worked-example.md]"), and exactly one level deep. It falls short of the 5 anchor because the ~300-line body inlines substantial detail — notably the 11-row line-pattern evidence table — where a second one-level reference could keep SKILL.md closer to an overview.

4 / 5

Total

18

/

20

Passed

Description

96%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 capability and trigger conditions in third person, with concrete actions and natural trigger vocabulary. Its only weakness is minor co-trigger risk with general PR-review skills from the "mark a PR done" phrasing.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Drafts a starter DoD and a per-PR checklist, and audits work line by line against an existing DoD with repository evidence, never on self-attestation" — covering both the authoring and auditing halves of the skill with no vague filler. It matches the 5 anchor (multiple specific concrete actions, comprehensive coverage) rather than 4, since the action coverage is complete rather than having minor gaps.

5 / 5

Completeness

It explicitly answers both questions: what ("Drafts a starter DoD and a per-PR checklist, and audits work line by line...") and when ("Use when a team has no Definition of Done, wants to revise it, or is about to mark a story or PR done without checking it") with concrete trigger phrases. This matches the 5 anchor exactly; the when-clause is explicit, so it is not capped at 3 or docked to 4.

5 / 5

Trigger Term Quality

Natural terms include "Definition of Done", the synonym "DoD", "story or PR", "done", "revise", and "checklist" — phrases a team member would actually say when needing this. It sits at the 5 anchor (comprehensive natural terms including synonyms); file extensions are inapplicable in this domain, and no common variation is missing.

5 / 5

Distinctiveness Conflict Risk

The Definition-of-Done niche is clear and mostly distinct, but "about to mark a story or PR done without checking it" and "audits work... with repository evidence" overlap with generic code-review / PR-review skills. It fits the 4 anchor (mostly distinct, minor overlap risk with closely related skills) better than 5, whose example has triggers no neighboring skill would claim.

4 / 5

Total

19

/

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.

Reviewed

On this page