CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bug-triage

Re-evaluate open bugs — priority vs severity, assign to sprints, surface systemic trends. Run when the count grows.

Quality

81%

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

SKILL.md
Quality
Evals
Security

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 tightly written, highly actionable procedure: exact file paths, a copy-paste Grep call, decision tables, and a complete output template, with approval gates and stop conditions at every risky point. Its only real costs are slight redundancy between the Collaborative Protocol and Step 6, and a long inline report template that could be split out.

DimensionReasoningScore

Conciseness

The body is procedural and dense — decision tables, exact paths, and a full output template with almost no explanation of concepts Claude already knows. Minor over-explanation and repetition could be trimmed (e.g. the Collaborative Protocol re-states the Step 6 P4-candidate flow, and the no-bugs stop is stated twice in Step 2a), fitting anchor 4 rather than anchor 5's 'every token earns its place'.

4 / 5

Actionability

Guidance is fully executable for an instruction skill: exact glob paths in priority order ("production/qa/bugs/*.md"), a copy-paste-ready Grep invocation with pattern and output mode, decision tables for severity/priority, an exact user-approval script, and a complete report template covering the common cases. The only unspecified command (the targeted story-status grep) is an edge case, not a common one.

5 / 5

Workflow Clarity

The six steps are clearly sequenced (parse args → load backlog → classify → trends → report → write & gate) with explicit validation checkpoints and feedback loops throughout: the stop-if-no-bugs condition, sprint-capacity check with overflow flagging, the P4-candidate confirmation loop, the ask-before-write gate with a BLOCKED verdict on decline, and post-write follow-up actions. No validation gaps are identifiable, matching anchor 5 rather than anchor 4.

5 / 5

Progressive Disclosure

No bundle files (references/, scripts/, assets/) exist and the skill is a single well-sectioned document; the severity/priority tables and report template are the working core and belong inline. The ~75-line report template could arguably live in a reference file and referenced paths (.claude/docs/coding-standards.md, hooks/yaml-helper.sh) are external project files rather than organized skill references, which leaves minor organization gaps characteristic of anchor 4.

4 / 5

Total

18

/

20

Passed

Description

67%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.

The description names its domain and several concrete actions in efficient third-person form with an explicit run condition. Its main weakness is the vague trigger ("Run when the count grows" — count of what, at what threshold?) and the absence of natural synonyms like "triage" or "backlog" that a user would actually say.

Suggestions

Make the trigger concrete: e.g. "Run when open bugs exceed 10, at sprint start, or after new bugs are filed from QA."

Add natural trigger synonyms users would say, such as "triage", "bug backlog", or "regressions".

Mention the concrete output (a triage report at production/qa/bug-triage-[date].md) to round out the 'what' coverage.

DimensionReasoningScore

Specificity

"Re-evaluate open bugs", "assign to sprints", "surface systemic trends" list several concrete actions with the priority-vs-severity distinction named, but coverage is not comprehensive (no mention of the triage report output or backlog handling), matching anchor 4 rather than 5.

4 / 5

Completeness

Both parts are present: a clear what ("Re-evaluate open bugs — priority vs severity, assign to sprints, surface systemic trends") and an explicit when ("Run when the count grows"). The when clause could be more explicit or specific — 'the count' of what, and at what threshold — which is exactly anchor 4, not anchor 5's concrete trigger phrases; it is above anchor 3 because the when clause is explicitly stated rather than merely implied.

4 / 5

Trigger Term Quality

Relevant keywords are present ("bugs", "priority", "severity", "sprints", "systemic trends") but common natural variations are missing — notably "triage", "backlog", "regressions", and "QA" — so it fits anchor 3 ('some relevant keywords but missing common variations or synonyms') rather than anchor 4's 'good coverage'.

3 / 5

Distinctiveness Conflict Risk

The priority-vs-severity framing and sprint assignment give it a clear niche that is mostly distinct, with only minor overlap risk against closely related sprint-planning or QA-reporting skills, matching anchor 4 rather than anchor 5 (whose distinctiveness here is comparable, not clearly superior).

4 / 5

Total

15

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

Donchitos/Claude-Code-Game-Studios

Path

.claude/skills/bug-triage/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.