CtrlK
BlogDocsLog inGet started
Tessl Logo

triage

Recurring auto-triage orchestrator. Polls the issue tracker(s) configured in auto-triage.config.json (Linear, GitHub, … — one or many, at once) for queued issues, normalizes each to a work-item, routes by label, then either delegates to `triage-resolve` (draft PR) or files a plan issue for human review. Tracker- and project-agnostic — every specific lives in config. Run by the scheduler each tick, or `triage <ITEM-ID>` for a single dry-run.

67

Quality

84%

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

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.

An exemplary orchestrator skill body: concrete formats and capability names throughout, a 9-step procedure with validation and idempotency gates at every risky point, a clearly separated blocked/error protocol, and well-signaled one-level references that all exist in the bundle. The only real costs are moderate rule repetition and some per-mode detail that could live in the reference files.

DimensionReasoningScore

Conciseness

The body is dense and assumes competence — no generic concepts are explained, and nearly every sentence carries operational rules (exact JSON shapes, state names, exact output format). However, several rules are restated multiple times ('state is the source of truth'/claimMarker handling appears in the --list mode, step 2, and the invariant; the dependency gate is described in three places), which is repetition that could be tightened. This fits the 'efficient; minor instances that could be trimmed' anchor rather than the lean level-5 anchor, and is far above the noticeably-verbose level 3.

4 / 5

Actionability

Guidance is fully concrete and executable: the exact cursor JSON shape, the exact --list output format ('[{"id","sites"}]', no prose, no fences), exact capability names (fetchQueue, getItem, setState, attachLink), exact transition rules, and the exact final blocked line 'TRIAGE_BLOCKED: <one-line reason>'. Per the scoring notes, absence of code in an instruction-only skill is not penalized when the guidance is this actionable.

5 / 5

Workflow Clarity

The 9-step procedure is clearly sequenced with explicit validation checkpoints at every risky point: a re-fetch idempotency gate at claim, the dependency gate applied at both --list and claim, skip conditions enumerated per step, a dedicated Blocked protocol with stop-and-surface feedback, and explicit post-hoc sync-back/transition rules per outcome. Despite being a batch operation, validation is pervasive, so the batch cap does not apply — this matches the top anchor with feedback loops and explicit checkpoints.

5 / 5

Progressive Disclosure

A clear overview with a 'Read first' section that well-signals all three real, one-level-deep reference files (references/config-schema.md, work-item-schema.md, tracker-binding.md — all present in the bundle) with a one-line purpose each, and config/state files clearly separated from the skill bundle. It falls short of the top anchor because some reference-worthy detail (the full --list output spec, the dependency-gate statusType semantics, and the Linear relation API details) is inlined in SKILL.md rather than pushed into the existing references.

4 / 5

Total

18

/

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 dense, concrete, well-differentiated description that names every pipeline stage and the exact inputs/outputs, in proper third-person voice. Its main gap is the absence of an explicit 'Use when...' trigger clause — the closing sentence describes scheduler invocation rather than user-facing usage conditions.

Suggestions

Add an explicit trigger clause, e.g. 'Use when queued tracker issues need automated triage, or when the user asks to triage an issue or run a dry-run on a single item (`triage <ITEM-ID>`).'

Add one or two natural synonyms for the queue ('tickets', 'backlog', 'bug queue') so the description matches the phrasing users actually say.

Since it is invoked alongside sibling skills, state the split in one clause (e.g. 'orchestrates only — implementation lives in `triage-resolve`') to further reduce cross-trigger risk with triage-resolve.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Polls the issue tracker(s)... for queued issues, normalizes each to a work-item, routes by label, then either delegates to `triage-resolve` (draft PR) or files a plan issue for human review' — comprehensive, specific, and all in third-person verb form.

5 / 5

Completeness

The 'what' is explicit and detailed, but there is no 'Use when...' clause or equivalent user-facing trigger guidance; 'Run by the scheduler each tick, or `triage <ITEM-ID>` for a single dry-run' states invocation mechanics rather than when a user should reach for the skill. Per the guideline, a missing explicit trigger clause caps completeness at 3 — it is not 4 because that anchor requires both a present 'what' and a present, if imperfect, 'when' trigger.

3 / 5

Trigger Term Quality

Good natural keyword coverage — 'auto-triage', 'issue tracker', 'queued issues', 'Linear', 'GitHub', 'draft PR', 'plan issue' — but a few natural synonyms a user might say (e.g. 'tickets', 'bug queue') are missing. Not the level-5 anchor, which requires comprehensive synonyms/extensions; clearly above level 3, which assumes common variations are missing.

4 / 5

Distinctiveness Conflict Risk

A clear niche ('Recurring auto-triage orchestrator' that 'delegates to `triage-resolve`') with explicit delineation from its sibling skills, but it sits in a family of similarly named skills (triage, triage-resolve, triage-init, triage-cleanup) creating minor overlap risk. Not 5 because that family of near-identical triggers could route a user to the wrong one; well above 3, since the orchestrator-vs-resolver split is stated.

4 / 5

Total

16

/

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