CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

issue-triage

Scan open issues and discussions. Dedupe, prioritize, and propose labels. Updates issue-triage-state.md. L1 propose-only — never auto-label or close.

Quality

77%

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

Fix and improve this skill with Tessl

tessl review fix ./starters/issue-triage/.claude/skills/issue-triage/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

76%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 tight, well-structured instruction skill with an excellent output template and scoring rubric. The gaps are the implicit run sequence, the missing validation step for the batch state-file update, and two undefined terms ("loop score", L1/L2 levels) that a first-time reader must infer.

Suggestions

Add a numbered run sequence (gather issues + prior state → score per table → dedupe conservatively → rewrite issue-triage-state.md per template → prune closed issues) so the workflow is explicit rather than implied.

Add a validation checkpoint after the state write, e.g. re-read the updated file and confirm counts/dedupe list are consistent before finishing, to lift the batch-operation cap on workflow clarity.

Define "loop score" (how P0–P3 plus age map to the ranking used for Top 5) and give one concrete example of a gh CLI or MCP fetch so the skill is fully executable.

DimensionReasoningScore

Conciseness

The body is lean and imperative throughout — a one-sentence role statement, a copy-paste output template, a two-column scoring table, terse rules, and a justified untrusted-input policy. Nothing explains concepts Claude already knows, and every section carries operational instructions or constraints, matching the 5 anchor (every token earns its place).

5 / 5

Actionability

The exact state-file markdown template and the P0–P3 scoring table are concrete, near copy-paste guidance. It is not 5 because key details are missing: no specific command for fetching issues (gh CLI vs. MCP is left open) and "Top 5 (by loop score)" references a "loop score" that is never defined; it is clearly above the 3 anchor given the template's precision.

4 / 5

Workflow Clarity

The sequence (scan → score → dedupe → update state → prune closed) is present but only implicit — the document is organized as reference sections rather than ordered steps — and the batch write to issue-triage-state.md has no validation/verification checkpoint, which caps workflow clarity at 3 per the batch-operations guideline. Guardrails like "never auto-close" and "escalate to needs human" exist, so it is above the 2 anchor.

3 / 5

Progressive Disclosure

A single-file skill (no references/, scripts/, or assets/ bundle exists) with clean, well-labeled sections that is easy to navigate. It scores 4 rather than 5 because at ~70 body lines it exceeds the simple-skill threshold (under 50 lines) and sections like the scoring rubric and untrusted-input policy are approaching the size where a one-level reference file would be warranted; all content is nonetheless appropriately placed inline.

4 / 5

Total

16

/

20

Passed

Description

71%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 specific, lean description with strong action verbs and a distinct propose-only niche, written in third person. Its main weakness is the missing "when to use" guidance, which caps completeness and weakens trigger coverage.

Suggestions

Add an explicit trigger clause, e.g. "Use when triaging a GitHub backlog, deduplicating open issues, or when the user mentions issue triage, backlog grooming, or prioritizing issues."

Include the word "triage" and "backlog" in the description text itself (not just the skill name and state filename) so natural user phrasing matches the description.

DimensionReasoningScore

Specificity

"Scan open issues and discussions. Dedupe, prioritize, and propose labels. Updates issue-triage-state.md." lists five concrete, third-person actions (scan, dedupe, prioritize, propose labels, update state file) with comprehensive coverage of the triage domain. It matches the 5 anchor (multiple specific concrete actions) rather than 4, since even the 4-anchor examples list fewer actions than this description.

5 / 5

Completeness

The "what" is clear (scan, dedupe, prioritize, propose labels, update state file), but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It is not a 4 because the "when" is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

Natural terms are present — "issues", "discussions", "dedupe", "prioritize", "labels" — giving good keyword coverage. It falls short of the 5 anchor because common variations users would say are missing: "triage" itself appears only in the name/state filename, and "backlog"/"GitHub" never appear in the description text.

4 / 5

Distinctiveness Conflict Risk

The niche is mostly distinct — propose-only label/priority triage with a dedicated state file ("L1 propose-only — never auto-label or close") is unlikely to trigger a wrong skill. It is not 5 because without any trigger phrases it could still overlap with a general issue-management or issue-cleanup skill; it is clearly more distinct than the 3 anchor.

4 / 5

Total

16

/

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

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

cobusgreyling/loop-engineering

Path

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