CtrlK
BlogDocsLog inGet started
Tessl Logo

testland/severity-vs-priority-reference

Pure-reference catalog distinguishing defect severity (impact on the system / user) from defect priority (urgency of fix), each on its own axis. Enumerates the canonical 5-point severity scale (Critical / High / Medium / Low / Trivial) and the 5-point priority scale (Immediate / High / Medium / Low / Deferred), explains why they must be tracked separately (a Critical/Deferred legacy bug exists; a Trivial/Immediate spelling bug on the homepage exists), maps to IEEE 1044-2009 severity classes, and ties to bug-lifecycle-reference state transitions. Use when triaging a defect, configuring a tracker's severity/priority fields, or reviewing whether a bug report assigned them consistently.

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

Passed

No findings from the security scan

Overview
Quality
Evals
Security
Files

Quality

Content

85%

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 well-structured pure-reference catalog with actionable, sequenced triage guidance and concrete per-tracker configuration, scoring well on actionability, workflow clarity, and progressive disclosure. Its main weakness is conciseness: glossary definitions and conceptual restatements of severity/priority repeat knowledge Claude already has and could be trimmed without losing the reference value.

Suggestions

Trim the ISTQB glossary quotes and the prose restating that severity is 'an objective property of the defect'; readers of a triage reference already know the concept, so the scales and anchors alone carry the meaning.

Collapse the 'Per IEEE 1044-2009' and 'Per ISTQB Glossary' framing sentences into a single References note rather than restating provenance inline above each scale.

Consider moving the full 5x5 matrix and worked-examples block into a separate reference file and keeping SKILL.md to the scales plus a one-line pointer, to reduce token load for readers who only need the anchor definitions.

DimensionReasoningScore

Conciseness

The ~218-line body includes content Claude largely already knows — the ISTQB glossary definitions of 'severity' and 'priority', prose restating that severity is 'an objective property of the defect', and the 'Per IEEE 1044-2009' framing — which matches the score-2 anchor of mostly efficient but with some unnecessary explanation; it is not the level below because the core enumerative reference material (scales, 5x5 matrix, worked examples proving axis independence) genuinely earns its tokens, and not the level above because the glossary quotes and conceptual restatements could be trimmed.

2 / 3

Actionability

The numbered 'How to use' steps give specific executable guidance ('pick a severity (S1-S5) from the severity scale anchors', 'Set the tracker's severity and priority fields per the configuring-a-tracker table'), and the tracker-config table supplies concrete per-platform field names (Jira Severity/Priority, GitHub labels 'severity:critical', Azure DevOps 1-4), matching the score-3 anchor for concrete copy-paste-ready guidance; per scoring_notes, absent code in an instruction-only skill is not penalized when guidance is this actionable.

3 / 3

Workflow Clarity

The 7-step 'How to use' sequence has explicit validation checkpoints — step 3 ('if the cell is rare or unusual, record an explicit rationale') and step 4 ('Confirm you did not collapse the axes') — and the worked example reinforces the matrix-check loop, matching the score-3 anchor for a clear sequence with explicit validation steps; it is not the level below because the checkpoints are explicit, not merely implied.

3 / 3

Progressive Disclosure

No bundle files exist in references/, scripts/, or assets/, and the body is organized into clear single-level sections (Overview, When to use, How to use, the two axes, Why separate, Worked example, Mapping to lifecycle, Common confusions, Configuring a tracker, Anti-patterns, Limitations, References) with one-level-deep pointers to sibling skills, matching the score-3 anchor for a well-organized single-file reference skill; it is not the level below because the content is appropriately sectioned rather than a monolithic wall or nested-reference chain.

3 / 3

Total

11

/

12

Passed

Description

100%

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 specific, uses third-person voice, and clearly pairs concrete capabilities with explicit 'Use when' triggers, fully satisfying the completeness and trigger-term dimensions. It is on the verbose side but every clause names a concrete action or trigger, so the verbosity does not dilute specificity.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'Enumerates the canonical 5-point severity scale', 'maps to IEEE 1044-2009 severity classes', 'ties to bug-lifecycle-reference state transitions' — matching the score-3 anchor for multiple specific concrete actions; it is not the level below because it goes beyond naming a domain to enumerating specific capabilities.

3 / 3

Completeness

Explicitly answers both 'what' (distinguishing severity from priority, enumerating both scales, mapping to IEEE 1044, tying to lifecycle) and 'when' (the 'Use when...' clause with three explicit triggers), matching the score-3 anchor; it is not the level below because the when-guidance is explicit, not merely implied.

3 / 3

Trigger Term Quality

'Use when triaging a defect, configuring a tracker's severity/priority fields, or reviewing whether a bug report assigned them consistently' gives natural trigger phrasings a triager or PM would actually say, matching the score-3 anchor for good coverage of natural terms; it is not the level below because the triggers are concrete and varied rather than a single generic keyword.

3 / 3

Distinctiveness Conflict Risk

The niche — separating defect severity from priority as two independent axes with per-tracker field configuration — is sharply scoped with distinct triggers, making it unlikely to fire for the wrong skill; it is not the level below because the domain and triggers are specific rather than overlapping with generic skills.

3 / 3

Total

12

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Reviewed

Table of Contents