CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bug-report-template

Use when someone reports a problem informally, a CI failure (JUnit XML, Allure, pytest or Playwright output) must become a bug report, or a draft needs a quality check before filing. Fills summary, environment, steps, expected vs actual and severity rationale, then checks each field is usable.

Quality

92%

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

The canonical home for this skill is testland/bug-report-template

SKILL.md
Quality
Evals
Security

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 dense, operational skill body: both intake workflows are fully sequenced and validated by an explicit blocking checklist, supported by copy-paste templates, executable code, and real one-level-deep reference files. The only weakness is modest length driven by a few conceptual asides (ISTQB terminology, severity-vs-priority background) that could be trimmed or folded into the scales reference.

DimensionReasoningScore

Conciseness

The body is dense and operational - format-detection tables, a field-source table with defaults, executable inference code, templates, a checklist - with only minor trimmable over-explanation: the ISTQB terminology blockquote ("ISTQB distinguishes error (human action), defect / fault / bug...") and the severity-vs-priority conceptual paragraph restate knowledge Claude already has. Not 5 because those asides don't earn their tokens; not 3 because they are brief and embedded in load-bearing sections.

4 / 5

Actionability

Fully executable guidance: a copy-paste-ready output template, a complete worked example from a Slack message with [GAP] markers, runnable Python (SEVERITY_FROM_ERROR / infer_severity), a concrete YAML bug_spec, and per-field defaults. Both common intake cases (informal report, CI failure) are covered with concrete examples, and parser/render bodies are delegated to real reference files - no pseudocode or missing key details, so it exceeds anchor 4.

5 / 5

Workflow Clarity

Both workflows are explicitly sequenced ("How to use" steps 1-6; CI workflow F1-F3) and gated by a review checklist with explicit verdicts ("pass, block, pass-with-caveats", "Any missing required field = BLOCK", "TBD in a required field = blank = BLOCK"). Feedback loops are present: gap flags return the draft to the reporter, dedupe search precedes filing, and title failures get "BLOCK + coach with a suggested rewrite". The batch CI-filing path includes this validation, so the missing-validation cap does not apply.

5 / 5

Progressive Disclosure

Verified against the actual bundle: all three referenced files exist (references/parsers.md, references/severity-and-priority-scales.md, references/spec-template.md) and are one level deep, each signaled at its point of need - "Use the classification scales in references/severity-and-priority-scales.md", "Parser bodies and per-format field shapes live in references/parsers.md", "Full template: references/spec-template.md" - plus a closing References section. The split (scales, parser code, and spec template out of the body; operational core inline) is appropriate and easy to navigate.

5 / 5

Total

19

/

20

Passed

Description

87%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: an explicit three-scenario "Use when" trigger clause paired with an enumerated, third-person action list. The only notable gaps are missing common synonyms (defect, test failure) and unmentioned CI-parsing capabilities.

DimensionReasoningScore

Specificity

"Fills summary, environment, steps, expected vs actual and severity rationale, then checks each field is usable" lists several concrete, specific actions. It stops short of anchor 5's comprehensive coverage because the CI-failure workflow's actions (parsing failure records, proposing classification, deduplicating, filing) are only implied by the trigger clause rather than stated as capabilities.

4 / 5

Completeness

Explicitly answers "when" with three concrete trigger scenarios ("Use when someone reports a problem informally, a CI failure ... must become a bug report, or a draft needs a quality check before filing") and "what" with an enumerated action list. Matches anchor 5; not 4, since the when-clause is already explicit and specific rather than merely improvable.

5 / 5

Trigger Term Quality

Strong natural phrasing users would actually say: "reports a problem informally", "CI failure", "bug report", "quality check before filing", plus concrete tool/format names ("JUnit XML", "Allure", "pytest or Playwright output"). It falls short of anchor 5 because common synonyms like "defect", "test failure", or "flaky test" are missing.

4 / 5

Distinctiveness Conflict Risk

The niche - converting informal problem reports and structured CI output (JUnit XML, Allure, pytest, Playwright) into filed bug reports - is a clear lane with distinct triggers and minimal conflict risk against adjacent QA or tracker skills, since the description scopes the work to drafting and checking "before filing".

5 / 5

Total

18

/

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

testland/qa

Path

plugins/qa-bug-repro/skills/bug-report-template/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.