CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

triage

This skill should be used when triaging and categorizing findings for the CLI todo system.

51

Quality

64%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/03-plan/triage/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%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.

The skill body gives unusually concrete, executable guidance (exact filenames, frontmatter, prompts, commands) organized in a clear step sequence. Its main weaknesses are duplication that inflates token cost, a destructive delete path with no validation checkpoint, and a monolithic single-file layout that inlines a large template and example.

Suggestions

Add a validation checkpoint before the destructive 'next' branch — e.g. confirm the deletion with the user or verify the filename matches an existing todo before removing it — and a verify step after rename/frontmatter updates.

De-duplicate the status-transition logic: keep it in Step 2 and cut the 'Status Transitions During Triage' repetition, or vice versa.

Move the long todo-file template (and possibly the filled example) into a references/ file and link to it, keeping SKILL.md as the overview; also define `{next_id}` and `{date}` explicitly.

DimensionReasoningScore

Conciseness

The body is operational instruction rather than explanation of known concepts, but it is noticeably duplicative: the pending→ready status transitions are spelled out in Step 2 ('Rename file from `{id}-pending-{priority}-{desc}.md` → `{id}-ready-{priority}-{desc}.md`') and repeated almost verbatim under 'Status Transitions During Triage', and the presentation template appears both blank and as a fully filled example. This fits 'mostly efficient but could be tightened' rather than score 4's minor trims, and is not score 2 since there is no padding with concepts Claude already knows.

3 / 5

Actionability

Guidance is highly concrete and executable: exact filename patterns ('{next_id}-ready-{priority}-{brief-description}.md'), exact YAML frontmatter blocks, exact confirmation strings, a priority mapping table, and a shell command ('ls todos/*-ready-*.md'). It falls short of score 5 only through small gaps such as `{next_id}` and `{date}` never being defined.

4 / 5

Workflow Clarity

The four-step sequence (present → handle decision → continue → summary) is clear, but this is a batch workflow with a destructive operation — 'Delete the todo file - Remove it from todos/ directory' — and there is no validation or verification step before deletion, and no feedback loop if a rename or frontmatter update fails. Per the rubric guideline, a destructive/batch workflow missing validation is capped at 3.

3 / 5

Progressive Disclosure

The single SKILL.md is well sectioned (Workflow, Example Response Format, Important Implementation Details), but at ~300 lines it inlines content that could be split out — notably the ~150-line todo-file template and the fully worked example. It matches 'some structure but could be better organized' rather than score 4's 'most content is appropriately placed'.

3 / 5

Total

13

/

20

Passed

Description

53%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.

The description has an explicit use-when clause and a recognizable niche, but it is thin: capabilities are generic (triaging/categorizing) rather than concrete, and natural trigger variations are missing. It answers 'when' clearly but leaves 'what' implied.

Suggestions

State concrete capabilities alongside the trigger, e.g. 'Presents code review or security audit findings one by one, records yes/next/custom decisions, and renames or deletes CLI todo files accordingly.'

Add natural trigger phrases users would say, such as 'code review findings', 'security audit results', or 'triage the todos'.

Separate the 'what' from the 'when' so both are explicit: one sentence of capabilities plus an explicit 'Use when...' clause.

DimensionReasoningScore

Specificity

The description names its domain ("triaging and categorizing findings for the CLI todo system") with two actions — triaging and categorizing — but stops there; concrete capabilities like presenting findings, collecting yes/next/custom decisions, or renaming todo files are absent. It matches 'names domain and 1-2 concrete actions, but not comprehensive' rather than score 4, whose anchor requires several specific actions.

3 / 5

Completeness

The 'when' is explicit ('This skill should be used when triaging and categorizing findings for the CLI todo system') but the 'what' is only implied by the when-clause — the skill's actual capabilities are never separately stated. This falls at 'what' weakly implied rather than score 4, which requires both clearly present.

3 / 5

Trigger Term Quality

'triaging', 'categorizing findings', and 'CLI todo system' are natural terms a user might say, but common variations users would actually use — 'code review findings', 'security audit results', 'review findings', 'todo triage' — are missing. It sits at 'some relevant keywords but missing common variations or synonyms', below score 4's 'good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

The phrase 'for the CLI todo system' carves out a fairly distinct niche with trigger terms (triage, findings, todo system) that are unlikely to fire for unrelated skills. It is 'mostly distinct; minor overlap risk' with generic todo- or task-management skills, falling short of score 5's comprehensive distinct triggers.

4 / 5

Total

13

/

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

marchatton/agent-skills

Path

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