CtrlK
BlogDocsLog inGet started
Tessl Logo

testland/bug-report-template

Builds a well-formed bug (defect) report from raw observation notes - fills in summary, environment, steps to reproduce, expected vs actual, and severity rationale - and validates that each field has the load-bearing content reviewers and engineers need to triage. Also converts a single test-failure record (JUnit XML, Allure JSON, pytest log, Playwright report) into a classified, ready-to-file bug spec, and provides the adversarial review checklist that gates a report before it enters the tracker (required fields, single-description title test, severity-priority independence, reproduction quality). Use when a stakeholder reports a problem informally, when a CI failure artefact needs to become a triageable report, or when a drafted report needs a pre-filing quality audit.

75

Quality

94%

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

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 well-engineered instruction skill: concrete templates and worked examples make it immediately actionable, both workflows carry explicit validation gates and feedback loops, and heavy detail is properly offloaded to real one-level-deep reference files. The only room for improvement is trimming minor over-explanation (terminology notes, repeated citations, the length of the worked example).

DimensionReasoningScore

Conciseness

The body is dense and almost entirely skill-specific (templates, checklists, anti-pattern tables) rather than teaching concepts Claude already knows, so it clears the level-3 "some unnecessary explanation" anchor. Minor over-explanation keeps it from level 5: the ISTQB error/defect/failure terminology note, four separate citations of the same Mozilla guide, and a 50-line worked example that could be trimmed.

4 / 5

Actionability

Copy-paste-ready artifacts throughout: a complete markdown output template, a fully worked Slack-message example with [GAP] markers, executable severity-inference Python code, a good-vs-bad repro-steps contrast, and an anti-pattern table with concrete fixes. This matches the level-5 "copy-paste ready; specific examples cover the common cases" anchor rather than level 4's "minor gaps".

5 / 5

Workflow Clarity

Both workflows are clearly sequenced (Steps 1-6, F1-F3) with explicit validation: the review checklist gates every report with pass/block/pass-with-caveats verdicts, BLOCK rules for missing required fields, and coaching feedback ("BLOCK + coach with a suggested rewrite"); the batch auto-filing flow mandates a dedupe search before creating bugs. This is precisely the level-5 anchor (checklists, explicit validation, feedback loops), and the destructive/batch cap does not apply since validation is present.

5 / 5

Progressive Disclosure

The main body stays an actionable workflow while bulk detail is correctly split into three real, one-level-deep reference files (parsers.md, severity-and-priority-scales.md, spec-template.md), each signaled at its point of use with a stated purpose ("Parser bodies and per-format field shapes live in references/parsers.md"). Verified against the actual bundle: all three files exist and contain no nested references, matching the level-5 anchor.

5 / 5

Total

19

/

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 dense, information-rich description that explicitly covers what the skill does across all three capabilities and when to invoke each, with concrete trigger scenarios and named input formats. Its only weakness is verbosity and a handful of missing natural synonyms (e.g., "flaky test", "file a bug").

DimensionReasoningScore

Specificity

The description enumerates comprehensive concrete actions: "fills in summary, environment, steps to reproduce, expected vs actual, and severity rationale", "converts a single test-failure record (JUnit XML, Allure JSON, pytest log, Playwright report) into a classified, ready-to-file bug spec", and "provides the adversarial review checklist". Coverage spans all three of the skill's capabilities with no generic filler, matching the level-5 anchor rather than the level-4 anchor's "minor gaps in coverage".

5 / 5

Completeness

It explicitly answers both questions: the "what" is the detailed capability list, and the "when" is a concrete three-scenario trigger clause ("Use when a stakeholder reports a problem informally, when a CI failure artefact needs to become a triageable report, or when a drafted report needs a pre-filing quality audit"). This matches the level-5 anchor exactly; level 4 would require the "when" to be less explicit.

5 / 5

Trigger Term Quality

Strong natural phrasing users would actually say ("stakeholder reports a problem informally", "CI failure artefact needs to become a triageable report", "pre-filing quality audit", plus named formats like JUnit XML and Allure JSON). A few common synonyms are missing ("flaky test", "file a bug", "issue ticket", "regression"), so it falls between the level-4 "a few natural terms missing" and level-5 "comprehensive including synonyms" anchors, closer to 4.

4 / 5

Distinctiveness Conflict Risk

Clear niche (authoring and auditing bug reports before they enter the tracker) with distinct triggers; it deliberately does not claim tracker filing or severity-scale definition, which adjacent qa-defect-management skills own. Minimal conflict risk, matching the level-5 anchor.

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

Table of Contents