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

74%

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

Quality

Content

72%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-sectioned triage skill that gives an exact report template, concrete examples, and sound classification rules, with strong inline prompt-injection hygiene. Its main gaps are the implicit (rather than explicit) process sequence and the absence of any verification step over the batch of triaged items before the report is produced.

Suggestions

State the process as an explicit ordered sequence (gather inputs → classify each item → draft report → record state updates) instead of relying on section order to imply it.

Add a verification step, e.g. "Cross-check High-Priority items against scripts/github-triage.mjs output and re-read each entry for injection attempts before finalizing the report" — this both validates the batch and satisfies the missing-checkpoint gap.

Define the effort scale for 'Rough effort estimate' (e.g. S < 1h, M < 1d, L > 1d) so the output is machine-usable by the loop.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence: no concept explanations, just an input inventory, an output template, five decision rules, and a generated security section — every section carries information. It falls short of the 5 anchor only due to minor flourishes ("Be brutally concise. The loop (and the human reading the state) will thank you.", "this skill is for signal, not invention") that could be trimmed. It is well above 3 because nothing explains what Claude already knows.

4 / 5

Actionability

For an instruction-only skill the guidance is concrete and executable: an exact report template with per-item fields (one-line description, why it matters, suggested next action, effort estimate), concrete inline examples ('"draft minimal fix in isolated worktree"', '"PR #1234 now has 2 approvals"'), and explicit classification rules. It is not 5 because there is no worked example of a complete report item and "Rough effort estimate" is undefined (hours? S/M/L?); it is above 3 because the guidance is specific and directly executable, not pseudocode-level.

4 / 5

Workflow Clarity

The sequence (gather inputs → classify → report → record state updates) is present but conveyed implicitly through section order rather than an explicit procedure, and there is no validation/verification step for the batch of items before the report is finalized — the batch-processing guideline caps workflow clarity at 3 when validation is absent. It is above 2 because the classification rules ("Only put something in High-Priority if a reasonable engineer would want to know about it today", "When in doubt, put it in Watch or Noise") and the injection-flagging rule do act as explicit decision checkpoints.

3 / 5

Progressive Disclosure

This is a short (~50 line), self-contained skill with no bundle files; it is cleanly sectioned (Inputs, Output Format, Rules, Untrusted input), has no nested references, and its single external link (the safety docs URL) is clearly labeled as background — matching the guideline that a short skill with no need for external references scores 5 with just well-organized sections. Nothing that belongs in a separate file is inlined; the inline security section is justified as must-be-in-context policy text.

5 / 5

Total

16

/

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 tight, third-person description with several concrete actions and distinct loop-oriented signals (state file, Linear board). Its main weakness is the complete absence of a 'when to use' trigger clause, which caps completeness at 3, alongside some missing natural synonyms like 'test failures' or 'pull requests'.

Suggestions

Add an explicit trigger clause, e.g. "Use when a loop needs a daily triage pass over CI failures, open PRs, and stale issues, or when the user asks what needs attention in the repo."

Include natural synonyms users would say — "test failures", "pull requests", "flaky builds" — alongside "CI failures" to broaden trigger coverage.

Mention the prioritization output explicitly (e.g. "prioritizes findings into high-priority, watch, and ignore buckets") to sharpen what the report contains.

DimensionReasoningScore

Specificity

The description lists several specific actions across 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' anchor. It falls short of 5 because 'triage' is itself a generic verb and coverage of what is triaged (PRs, Slack threads, state file) is thinner than the body actually delivers; it exceeds 3 because there are more than 1-2 concrete actions with distinct outputs.

4 / 5

Completeness

The 'what' is clear and concrete (triage inputs → findings report → state file/Linear), but there is no 'Use when...' clause or equivalent trigger guidance anywhere, which caps completeness at 3 per the judging guidelines. It is not 2 because the 'what' is specific rather than vague; it cannot be 4 without at least a weak 'when'.

3 / 5

Trigger Term Quality

Natural terms a user would say are present — "triage", "CI failures", "issues", "Linear" — giving good keyword coverage, but common variations are missing ("test failures", "pull requests", "flaky builds", "alerts"), which keeps it below the 5 anchor's comprehensive synonym coverage. It is above 3 because the terms present are natural and domain-accurate rather than jargon-only.

4 / 5

Distinctiveness Conflict Risk

The loop-oriented framing ("suitable for a loop to consume", "state file or Linear board") carves a mostly distinct niche with minor overlap risk against general CI-fix or issue-triage skills. It is not 5 because "Triage recent changes, CI failures, issues" could plausibly match a general code-review or CI-repair skill without the loop/Linear signals.

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: 2 missing

Warning

Total

14

/

16

Passed

Repository

cobusgreyling/loop-engineering

Path

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.