CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

triage

Triages a PR comment — from a bot (Copilot, CI) or a human reviewer. Routes to the `triage_helper.py` helper for identity checks, thread snapshotting, isolated-worktree fixes, and publish/reply/resolve mechanics; you classify the finding and apply a justified fix. `--dry-run` is fully read-only (investigation and a printed plan, zero mutations). `--no-resolve` runs the full fix/reply workflow but never resolves a thread. Run from inside the repo.

Quality

77%

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 ./plugins/platform-skills/skills/triage/SKILL.md

The canonical home for this skill is triage in nitinjain999/platform-skills

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 exceptionally operational skill body: exact commands, hard validation gates, ordered failure-path handling, and error-code-driven recovery. Its main costs are token weight — inline edge-case reasoning and restated always/never rules that could live in references/triage.md or be trimmed — and a referenced file that is not present in the bundle to verify.

Suggestions

Move the extended edge-case reasoning (Phase A lock-staleness semantics, Phase E hook-security rationale, Phase G --allow-new-comment-node-id handling) into references/triage.md's failure-recovery material, keeping SKILL.md to the hard gates and routing.

Trim the 'Never do these'/'Always do these' sections to only rules not already stated in the phase-by-phase routing to cut the systematic redundancy.

Ship references/triage.md alongside the skill in the bundle so the delegated judgment rules are actually verifiable at the referenced path.

DimensionReasoningScore

Conciseness

The body is dense and free of concept-explanation padding — nearly every clause encodes a helper-specific failure mode or hard gate — but it self-describes as a routing file that is 'not where the reasoning lives' while carrying extended edge-case reasoning inline (Phase A lock-staleness semantics, Phase E hook-security rationale, Phase G --allow-new-comment-node-id minutiae), and the 'Never do these'/'Always do these' sections systematically restate rules already specified in the phases.

3 / 5

Actionability

Every phase carries an exact subcommand signature with flags ('state lock --repo-root ... --pr <n>', 'publish --repo ... --expected-head-sha <sha> ...'), the JSON output contract, enumerated error codes with prescribed responses, and a copy-paste-ready CLAUDE_PLUGIN_ROOT bootstrap — fully executable guidance covering the common paths including GHES hosts and conversation comments.

5 / 5

Workflow Clarity

Phases A–H are explicitly ordered with an unconditional validation gate (no stage-commit before PASS, no publish before stage-commit, no fix-claiming reply before matches_pushed_commit: true, no resolve before CONFIRMED), per-error recovery guidance, and a mandated failure-path cleanup order (preserve → state write → cleanup → unlock) — validation checkpoints and feedback loops are emphatically present for these destructive and batch operations.

5 / 5

Progressive Disclosure

The single external reference is well signaled with its contents enumerated ('Read references/triage.md ... It holds the evidence-assessment rules, the ... state model, and the failure-recovery table') and is one level deep, but no bundle files accompany the skill to verify that path, and the body retains judgment-call reasoning that its own routing statement delegates to that reference — minor organization gaps.

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 specific, concrete description that clearly communicates a PR-comment triage pipeline end to end. It is weakened only by a missing 'Use when' trigger clause inside the description field itself (the guidance lives in a separate frontmatter field), one second-person clause, and keyword coverage that stops short of common synonyms.

Suggestions

Fold the trigger guidance into the description field itself, e.g. append 'Use when triaging PR review comments, classifying findings, or deciding whether a flagged bug is already fixed' so the description alone answers both what and when.

Use third person throughout: change 'you classify the finding and apply a justified fix' to 'classifies the finding and applies a justified fix'.

Add natural synonyms users would say — 'pull request', 'code review comment', 'reviewer feedback' — to broaden trigger coverage.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'identity checks, thread snapshotting, isolated-worktree fixes, and publish/reply/resolve mechanics', plus classify/fix and the --dry-run/--no-resolve semantics — giving near-comprehensive pipeline coverage; docked 1 for the second-person clause 'you classify the finding and apply a justified fix' per the third-person voice rule.

4 / 5

Completeness

The 'what' is explicit and concrete (triage PR comments, classify findings, apply fixes, publish, reply, resolve), but the description field itself carries no 'Use when...' trigger clause — the when-guidance lives in the separate `when_to_use` frontmatter field, and the only usage note in the description ('Run from inside the repo') is an environment constraint — which caps completeness at 3.

3 / 5

Trigger Term Quality

Natural terms a user would actually say are present ('PR comment', 'Copilot', 'CI', 'human reviewer', 'classify the finding', 'reply', 'resolves a thread'), but common synonyms such as 'pull request', 'code review', and 'reviewer feedback' are missing, so coverage is good rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

'Triages a PR comment — from a bot (Copilot, CI) or a human reviewer' carves a clear niche with distinct mechanics (snapshot, worktree, publish/reply/resolve), but without explicit trigger phrases it retains minor overlap risk with generic code-review or PR-fix skills.

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

Warning

Total

14

/

16

Passed

Repository

nitinjain999/platform-skills

Path

plugins/platform-skills/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.