CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

review-triage-queue

Create a read-only, local triage queue report from OpenShell GitHub intake. Use to review the triage queue, scan incoming issues and community PRs, check main-branch CI failures, or resume a triage pass.

Quality

88%

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

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 lean, rule-dense instruction skill with excellent token efficiency and a well-executed split of the report format into a real referenced bundle file. The main gaps are the absence of executable retrieval commands for the intake sources and a couple of unlinked sibling-skill references.

Suggestions

Add one or two concrete retrieval commands or search queries (e.g., a gh issue/PR list invocation with the ordering and label filters) to the 'Gather intake' section so the source-reading steps are executable rather than implied.

Link `triage-issue` and `apply-triage-action` by path (or note where they live) the way the report template is linked, so navigation to sibling skills is unambiguous.

Add an explicit final validation step in 'Write the report' (e.g., check the report against the template's required sections and confirm full source coverage before advancing cursors) to close the feedback loop for this batch read operation.

DimensionReasoningScore

Conciseness

The body is dense, declarative rule text with zero concept explanation — every line prescribes behavior ("Update cursors only after a complete report; partial reads must not skip unread items", "Keep `critical` for security findings and release blockers"). It assumes Claude's competence (no explanation of what GitHub, CI, or Dependabot are) and every token earns its place.

5 / 5

Actionability

Guidance is highly concrete for an instruction-only skill: exact state paths (`.agents/triage-duty/state.local.yml`, `reports/<UTC timestamp>.md`), ID formats (`I<number>`, `P<number>`, `C<run_id>`), explicit budgets ("five-item budgets", "at most 20", "five oldest remaining candidates per run"), and a fixed classification/priority vocabulary. Not 5 because the intake-gathering steps give no executable commands or queries (e.g., gh CLI invocations or search filters), leaving the exact retrieval mechanics to inference.

4 / 5

Workflow Clarity

The sections form a coherent sequence (local state → gather intake → analyze/rank → resume → write report) with genuine checkpoints: cursors advance "only after a complete report", action records are authoritative and the checkpoint is "reconcile[d] … before proceeding", and `next_triage_issue` is recorded when the report is written. Not 5 because validation of the report itself (e.g., verifying every source page was read, or checking the report against the template before marking cursors) is implied by rules rather than given as an explicit validate-and-retry step.

4 / 5

Progressive Disclosure

Good structure: the ~56-line body is organized into clear sections and the bulk report format is correctly split into the verified one-level-deep reference [references/report-template.md](references/report-template.md), which exists in the bundle. Not 5 because navigation to `apply-triage-action` and `triage-issue` is by bare skill name with no path, and the out-of-bundle links (../../../CONTRIBUTING.md#label-discovery, ../../../SECURITY.md) are not verifiable from the skill itself.

4 / 5

Total

17

/

20

Passed

Description

92%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 strong description: concrete actions, explicit trigger guidance, and a clearly scoped niche. The only weakness is keyword coverage that omits a few natural synonyms (e.g., "pull requests" spelled out, "backlog", "Dependabot").

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Create a read-only, local triage queue report", "scan incoming issues and community PRs", "check main-branch CI failures", "resume a triage pass" — with scope constraints ("read-only, local"), giving comprehensive coverage of the skill's duties rather than generic phrasing. Not 4 because there is no noticeable gap: the create/review/scan/check/resume set covers everything the skill does.

5 / 5

Completeness

It explicitly answers both parts: what ("Create a read-only, local triage queue report from OpenShell GitHub intake") and when ("Use to review the triage queue, scan incoming issues and community PRs, check main-branch CI failures, or resume a triage pass") with a concrete trigger list. Matches the 5 anchor's structure of a clear what followed by an explicit 'Use when…' clause.

5 / 5

Trigger Term Quality

Natural phrases an on-duty engineer would say are present ("review the triage queue", "scan incoming issues", "community PRs", "CI failures", "resume a triage pass"), but coverage misses common variations such as the spelled-out "pull requests" and terms like "backlog" or "Dependabot". Not 5 because a few natural synonyms are missing; not 3 because keyword coverage is good, not partial.

4 / 5

Distinctiveness Conflict Risk

The niche is narrow and repo-specific — "OpenShell GitHub intake", "triage queue", "main-branch CI failures" — with triggers unlikely to fire for unrelated skills. Not 4 because overlap risk with generic review/reporting skills is minimal given the domain-specific vocabulary.

5 / 5

Total

19

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

relative_links

Relative link issues: 2 suspicious

Warning

Total

13

/

16

Passed

Repository

NVIDIA/OpenShell

Path

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