CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

triage

Triage issues through a state machine driven by triage roles. Use when user wants to create an issue, triage issues, review incoming bugs or feature requests, prepare issues for an AFK agent, or manage issue workflow.

1.42x
Quality

84%

Does it follow best practices?

Impact

94%

1.42x

Average score across 3 eval scenarios

SecuritybySnyk

Low

Low-risk findings worth noting

The canonical home for this skill is triage in mattpocock/skills

SKILL.md
Quality
Evals
Security

Quality

Content

78%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 well-organized, token-efficient instruction skill with a clearly sequenced workflow, built-in human checkpoints, and ready-to-use templates. Its main weaknesses are the missing bundle files the body depends on (AGENT-BRIEF.md, OUT-OF-SCOPE.md) and the unspecified issue-tracker query/label mechanism, which leave the reader unable to execute parts of the flow as written.

Suggestions

Include AGENT-BRIEF.md and OUT-OF-SCOPE.md in the bundle (or inline their essential templates) — both are load-bearing for the ready-for-agent and wontfix outcomes and are currently missing.

State how to query and modify the issue tracker (which tool/command, and where the label mapping lives) so the query and role-application steps are executable without external setup.

Add a brief post-apply verification step (confirm role applied, comment posted, issue closed) to close the workflow's validation gap.

DimensionReasoningScore

Conciseness

Lean and efficient throughout: no background on what issue trackers or triage are, no padding, and every section carries operational content (role taxonomy, transition rules, templates, resume rules). Matches the 5 anchor 'every token earns its place'; there is nothing to trim to reach 4's 'minor instances of over-explanation'.

5 / 5

Actionability

Highly actionable for an instruction-only skill: copy-paste templates (the needs-info markdown template, the mandatory AI disclaimer), a full enumerated role taxonomy with transition rules, and concrete example utterances. Minor gaps keep it below 5: the mechanism for querying/applying roles on the tracker is left to an unspecified mapping ("should have been provided to you"), and it leans on external skills (`/grill-with-docs`, `/setup-matt-pocock-skills`) whose availability is assumed. Well above 3 — the guidance is specific and executable, not pseudocode.

4 / 5

Workflow Clarity

The triage flow is a clear five-step sequence with real checkpoints: "Wait for direction" after recommending, the reproduce step that reports outcome before grilling, "flag it and ask the maintainer before doing anything else" on role conflicts, and "Confirm what you're about to do... then act" for the override path. Below 5 because there is no post-apply verification (e.g., re-checking labels or the posted comment after acting) and the resume loop only covers needs-info, not other partial-progress cases.

4 / 5

Progressive Disclosure

Structure and signaling are good — a dedicated "Reference docs" section plus point-of-use links for [AGENT-BRIEF.md](AGENT-BRIEF.md) and [OUT-OF-SCOPE.md](OUT-OF-SCOPE.md) — but neither file exists in the bundle (no references/, scripts/, or assets/ directories, and no such files at the skill root). The split is appropriate in intent, yet the navigation is broken in practice and the key details ('how to write durable agent briefs', 'how the .out-of-scope/ knowledge base works') are therefore unavailable. This sits between the 3 and 4 anchors; broken reference targets keep it at 3.

3 / 5

Total

16

/

20

Passed

Description

83%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: explicit 'what' and 'when', natural trigger phrases, third-person voice, and no fluff. It would benefit from a couple of common synonyms (issue tracker, labeling) and dropping or narrowing the broad 'create an issue' trigger to reduce overlap with issue-creation skills.

Suggestions

Add common synonyms such as 'issue tracker', 'label issues', or 'backlog' to the trigger list to broaden natural-language matching.

Narrow 'create an issue' to the triage context (e.g., 'file a new issue for triage') to reduce conflict risk with dedicated issue-creation skills.

DimensionReasoningScore

Specificity

Names several concrete actions — "create an issue", "triage issues", "review incoming bugs or feature requests", "prepare issues for an AFK agent", "manage issue workflow" — with only minor gaps (applying labels, posting triage notes are not surfaced). Not a 5 because the core 'what' ("a state machine driven by triage roles") stays abstract and the action list is trigger-oriented rather than a comprehensive capability inventory; clearly above 3's '1-2 concrete actions'.

4 / 5

Completeness

Explicitly answers both: 'what' — "Triage issues through a state machine driven by triage roles" — and 'when' via "Use when user wants to create an issue, triage issues, review incoming bugs or feature requests, prepare issues for an AFK agent, or manage issue workflow" with concrete trigger phrases. Third-person voice throughout. Matches the 5 anchor exactly; not the 4 anchor since 'when' is fully explicit and enumerated.

5 / 5

Trigger Term Quality

Good natural-phrase coverage: "triage issues", "review incoming bugs", "feature requests", "manage issue workflow" — phrases a maintainer would plausibly say. Missing common synonyms like "label issues", "groom the backlog", or "issue tracker", so it fits 'good keyword coverage; a few natural terms missing' rather than the comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

The AFK-agent/issue-triage framing ("prepare issues for an AFK agent") carves a fairly distinct niche with a clear state-machine model. Minor overlap risk remains with generic issue-creation and code-review skills, particularly the broad "create an issue" trigger, so it sits just below the 5 anchor's 'clear niche with minimal conflict risk'.

4 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 4 missing

Warning

Total

15

/

16

Passed

Repository

saski/arnesto

Path

.agents/skills/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.