CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

testland/definition-of-done

Use for any question or task about a Definition of Done, including what one should include, checking a PR or story against it, and stories marked done that bounce back from QA. 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

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Overview
Quality
Evals
Security
Files

Quality

Content

81%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 highly actionable and the audit workflow is exceptionally rigorous, with concrete commands, evidence standards, and a complete report template. Its main weaknesses are redundancy — repeated Scrum Guide quotes and overlapping limitations sections — and a spine that is long relative to its single reference file.

Suggestions

Deduplicate the Scrum Guide quotations: the org-standards blockquote appears verbatim in both 'Overview' and 'Per-organization vs per-team' — quote it once and link the second mention.

Trim the Overview to only the facts that anchor the audit rules (team/org ownership of lines; a miss returns the item to the Product Backlog); Claude already knows what a Definition of Done is.

Merge the 'Limitations' and 'Audit limitations' sections into one, and consider moving the anti-patterns table to a reference file to shorten the spine.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious guidance, but includes unnecessary material: two long Scrum Guide blockquotes in the Overview (with the org-standards quote repeated verbatim in 'Per-organization vs per-team') explaining a concept Claude already knows, plus 'Limitations' and 'Audit limitations' sections that overlap. Not 4 because the duplication and concept re-explanation go beyond minor trimmable instances; not 2 because most sections (evidence mapping, verdict rules, templates) earn their tokens.

3 / 5

Actionability

Fully executable throughout: specific commands ('gh pr view --json reviews,reviewDecision', '--json statusCheckRollup'), a precise LCOV reading method ('Per-file rate is LH / LF, computed only over files present in the diff'), and copy-paste-ready starter DoD, PR template, and audit report blocks covering the common cases. Not 4 because there are no gaps in concrete guidance.

5 / 5

Workflow Clarity

The audit workflow is clearly sequenced (setup: pin revision and evidence window, split atomic lines, handle conditionals, scope → evidence mapping → three-state assignment → verdict rules → report shape) with explicit validation standards ('self-attestation is not evidence', 'unverifiable never auto-passes') and feedback loops (unverifiable clears only via a named person; unenforceable lines are handed back to authoring). Not 4 because checkpoints are explicit rather than minor-gapped.

5 / 5

Progressive Disclosure

The one bundle reference (references/adherence-worked-example.md) is well-signaled, one level deep, and holds exactly the right content (a full end-to-end worked example), verified to exist. Not 5 because the spine itself runs ~300 lines with sections (e.g., the 10-row anti-patterns table, the evidence-mapping table) that could partly live in references, leaving the body long for an overview; not 3 because what is inline is well-sectioned and the reference is clearly signaled.

4 / 5

Total

17

/

20

Passed

Description

92%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: third-person, concrete about both halves of the skill (authoring and auditing), with an explicit 'Use for' trigger clause covering the natural scenarios. The only gap is a few missing synonym phrases a user might naturally say.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Drafts a starter DoD and a per-PR checklist', 'audits work line by line against an existing DoD with repository evidence, never on self-attestation', 'checking a PR or story against it' — in third person, comprehensively covering the skill's authoring and auditing halves. Not 4 because coverage of capabilities is complete rather than having minor gaps.

5 / 5

Completeness

Explicitly answers both: what ('Drafts a starter DoD and a per-PR checklist, and audits work line by line... with repository evidence') and when ('Use for any question or task about a Definition of Done, including what one should include, checking a PR or story against it, and stories marked done that bounce back from QA'). Concrete trigger phrases are present, matching the 5 anchor.

5 / 5

Trigger Term Quality

Good natural-term coverage: 'Definition of Done', 'DoD', 'PR', 'story', and the very natural scenario 'stories marked done that bounce back from QA'. Not 5 because common variations users might say — 'quality gate', 'acceptance criteria', 'is this story done' — are absent; not 3 because the key term, its abbreviation, and the related artifacts are all present.

4 / 5

Distinctiveness Conflict Risk

Clear niche (DoD authoring and adherence auditing) with distinct triggers ('Definition of Done', 'bounce back from QA'); the mention of PR checking is framed as DoD auditing, so overlap with generic code-review skills is minimal.

5 / 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