CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

triage-reviews

Fetch PR review comments, verify each against real code/docs, fix valid issues, commit and push

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

Quality

Content

88%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 is a strong, highly actionable workflow: concrete executable commands at every step, explicit verification before accepting findings, lint/test gates with failure-handling paths, and clear rules for the thread reply/resolve loop. Structure and organization are solid; the only minor improvement areas are slight tightenability of the Phase 3.5 rationale prose and possibly splitting the large GraphQL query blocks into a reference file.

DimensionReasoningScore

Conciseness

The body is dense with executable commands and short, purposeful steps; explanations that appear (e.g. "GitHub's review threads can only be resolved via GraphQL (REST has no endpoint)", "The thread ID is a GraphQL node ID, not the REST comment ID") convey genuinely non-obvious knowledge rather than padding. A few rationale sentences in Phase 3.5 (e.g. "Resolving them would let the PR look ready while the bug is still in the code") could be tightened, matching the 'efficient; minor instances of over-explanation' anchor rather than the fully lean anchor 5.

4 / 5

Actionability

The skill provides copy-paste-ready commands throughout: three concrete `gh api --paginate` fetch commands, a complete executable GraphQL query with `--jq` filter, exact REST reply and GraphQL resolve mutations with per-field templates, a commit message template, and a final report table format. These fully cover the common cases, matching the 'fully executable; copy-paste ready' anchor.

5 / 5

Workflow Clarity

The four-phase sequence is explicit with validation checkpoints and feedback loops: every finding must be verified against real code before classification, lint/tests gate the commit with a defined failure path ("If lint/tests fail, fix the failures before committing" and the skip-and-report-as-unfixed fallback), thread resolution has explicit only-when rules, and a cap guards against bulk-resolving unrelated threads in this batch operation. This matches the anchor 'clear sequence with explicit validation steps; feedback loops for error recovery'.

5 / 5

Progressive Disclosure

The body is well-structured into clearly headed phases with no nested or buried references, and there are no bundle files (references/, scripts/, assets/ are absent), so everything needed is appropriately inlined for a single linear workflow. At ~128 lines with large inline GraphQL/bash blocks it exceeds the under-50-line simple-skill case, so it fits the 'good structure; most content is appropriately placed; minor organization gaps' anchor rather than a 5.

4 / 5

Total

18

/

20

Passed

Description

58%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 is specific and action-oriented with a clear pipeline of concrete, third-person verbs, but it completely lacks a 'Use when...' trigger clause and has thin natural-keyword coverage. Adding explicit trigger guidance and common user phrasings would raise both completeness and trigger-term quality.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to triage, address, or respond to PR review feedback or review comments."

Include natural trigger synonyms users would actually say, such as "review feedback", "address PR comments", or "triage review comments".

Mention the reply-and-resolve thread step to close the coverage gap with the skill's Phase 3.5 workflow.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Fetch PR review comments", "verify each against real code/docs", "fix valid issues", "commit and push" — all in specific, third-person verb form. It stops short of comprehensive coverage: the thread reply/resolve loop (Phase 3.5) that makes up a substantial part of the skill is absent, matching the 'several specific actions; minor gaps' anchor rather than the 'comprehensive' one.

4 / 5

Completeness

The 'what' is clear (fetch, verify, fix, commit, push), but there is no 'Use when...' clause or equivalent explicit trigger guidance — the 'when' is entirely absent. Per the judging guidelines, a missing 'Use when' clause caps completeness at 3; this fits the anchor 'Has a clear what but when is missing or only weakly implied', and is not the level-4 anchor because nothing explicitly states when to invoke the skill.

3 / 5

Trigger Term Quality

"PR review comments" is a natural phrase users would say, but the description offers few other natural trigger terms — no "review feedback", "address comments", "triage", or similar variations a user might phrase the request with. This matches the 'some relevant keywords but missing common variations or synonyms' anchor rather than the 'good keyword coverage' one.

3 / 5

Distinctiveness Conflict Risk

"Fetch PR review comments, verify each... fix valid issues, commit and push" carves a fairly distinct niche (triaging review feedback on a PR) with concrete triggers like "PR review comments". There is minor overlap risk with general code-review or PR-management skills, matching the 'mostly distinct; minor overlap risk with closely related skills' anchor; it is not a 5 because the triggers don't fully disambiguate it from a generic 'review a PR' skill.

4 / 5

Total

14

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

stickerdaniel/linkedin-mcp-server

Path

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