CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

loop-triage

Triage recent changes, CI failures, issues, and conversations. Produces a concise, actionable findings report suitable for a loop to consume. Writes structured output to a state file or Linear board.

Quality

78%

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/minimal-loop-claude/.claude/skills/loop-triage/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%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-only skill: the output format is precisely specified, decision rules are explicit, and the untrusted-input section is justified operational policy rather than padding. The main gaps are the unspecified write target (state file vs Linear) and a dangling reference to a generation script that is not part of the bundle.

DimensionReasoningScore

Conciseness

The body is lean and functional throughout: precise input lists, an exact output-format spec, and terse decision rules ("Never propose architectural overhauls during triage — this skill is for signal, not invention"), with no concept-teaching. It matches 'lean and efficient; assumes Claude's competence; every token earns its place' — the only near-fluff is the quip "the human reading the state) will thank you" and a role-opener that restates the goal, which is not the over-explanation the 4 anchor describes.

5 / 5

Actionability

Concrete, executable guidance for an instruction-only skill: four named report sections, per-item required fields (description, why it matters, next action, effort estimate), and worked phrasing examples ("draft minimal fix in isolated worktree", "PR #1234 now has 2 approvals"), fitting 'mostly executable guidance with minor gaps'. Not 5 because the delivery mechanism promised by the description — how to write to the state file or Linear board — is entirely absent from the body, and no worked example of a completed report item is given; not 3 because the core task is fully and specifically specified.

4 / 5

Workflow Clarity

The single task (produce the triage report) is unambiguously specified with a well-sequenced structure: inputs → report format → categorization rules, plus explicit decision guidance for edge cases ("When in doubt, put it in Watch or Noise"). Triage is non-destructive, so the validation cap does not apply. Not 5 because handling of missing inputs and the report's write destination are unspecified, leaving minor gaps in the workflow.

4 / 5

Progressive Disclosure

For a sub-50-line, single-purpose skill the content is well organized into clearly headed sections (Inputs, Output Format, Rules, Untrusted input) with no inlined content that belongs in separate files. Not 5 because the body's marker comment points to "scripts/sync-untrusted-input.mjs", which does not exist in the bundle — a dangling referenced path that is a minor navigation gap when scored against the actual bundle structure.

4 / 5

Total

17

/

20

Passed

Description

66%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 solid, third-person description that clearly states what the skill does with concrete, domain-specific actions and outputs. Its main weakness is the complete absence of a 'Use when...' trigger clause, which caps completeness, and thinner coverage of natural trigger synonyms.

Suggestions

Add an explicit trigger clause, e.g. "Use when the loop needs to triage recent failures, issues, or changes before acting, or when asked to review the last day's activity."

Include natural trigger synonyms users would say — "test failures", "flaky tests", "PRs/pull requests", "incidents" — alongside "CI failures" and "issues".

Mention the report's prioritized structure (high-priority / watch / noise) to sharpen the 'what' and reduce overlap with generic review skills.

DimensionReasoningScore

Specificity

Lists three concrete third-person actions with named domains ("Triage recent changes, CI failures, issues, and conversations", "Produces a concise, actionable findings report", "Writes structured output to a state file or Linear board"), matching the 'several specific actions; minor gaps in coverage' anchor. Not 5 because 'Triage...' is an umbrella verb and the report's prioritization/categorization structure is not mentioned; not 3 because coverage goes well beyond 1-2 actions.

4 / 5

Completeness

The 'what' is clear (triage inputs → findings report → state file/Linear), but there is no 'Use when...' clause or equivalent explicit trigger guidance, capping completeness at 3 per the judging guidelines. It fits the anchor 'clear what but when is missing or only weakly implied' — 'suitable for a loop to consume' only weakly implies when. Not 4 because no explicit 'when' exists at all.

3 / 5

Trigger Term Quality

Good natural keyword coverage — "triage", "CI failures", "issues", "conversations", "Linear" are phrases a user in a loop-engineering context would naturally say, matching the 'good coverage; a few natural terms missing' anchor. Not 5 because common variations like "test failures", "flaky tests", "PRs/pull requests", and "incidents" are absent; not 3 because multiple strong natural terms are present, not just generic ones.

4 / 5

Distinctiveness Conflict Risk

The loop/state-file/Linear framing carves a clear niche that mostly distinguishes it from generic review or issue-triage skills, fitting 'mostly distinct; minor overlap risk'. Not 5 because terms like "triage" and "issues" could still collide with a general code-review or issue-triage skill since no distinct trigger clause differentiates them; not 3 because the destination outputs (state file, Linear board) are distinctive.

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

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