CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

triage-finding

Triage supplied or imported security findings against a repository using its security policy and static code evidence. Accepts scanner reports, advisories, GitHub findings, and Jira or Linear tickets. Do not use for discovery, duplicate triage, runtime validation, or fixes.

67

Quality

84%

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 tightly written, judgment-heavy skill that delegates operational detail to three real, one-level-deep reference files and keeps the body as lean procedural policy with no token waste. Its gaps are modest: no worked example of a normalized finding or final result, some checkpoints left to judgment, and several referenced paths that live outside the bundle and cannot be verified from it.

Suggestions

Include one short worked example in the body or the contract reference showing a supplied finding normalized to a triage_item with a final triage-finding/v0 result, so the common case is fully concrete.

Add an explicit final validation step before emitting results (e.g., confirm one result per input, in input order, with all required contract fields present) to close the workflow with a checkpoint.

Clarify or localize the '../../' references (security-guidance.md, static-finding-assessment.md, findings.schema.json) — they point outside the skill bundle and are unverifiable from it; if they are environment-level shared assets, say so explicitly where first cited.

DimensionReasoningScore

Conciseness

The body is dense, prescriptive policy with no padding and no explanation of concepts Claude already knows — e.g., 'Trace the claimed actor and source through every material transformation and control to the exact consequence' assumes full competence and adds only non-obvious procedural rules. Every sentence instructs or bounds behavior ('Do not infer trust from labels such as local, CLI, administrator, configuration, plugin, or example'), fitting 'lean and efficient; every token earns its place' (5); the few repeated phrases (input-order preservation, read-only limits) are brief boundary emphasis rather than the over-explanation of anchor 4.

5 / 5

Actionability

Guidance is concrete and executable throughout: exact verdict enums ('confirmed', 'not_actionable', 'needs_review'), an exact extraction checklist, source-type enums, precise rank rules ('unique, contiguous positive ranks from 1'), and a named contract ('triage-finding/v0') with point-of-use references to the files that hold the operational detail. It stops short of anchor 5 because no worked example of a normalized finding or final result appears in the body (the output shape is fully delegated to the contract reference) and a few directives remain abstract ('Inspect the smallest useful evidence set'), matching 'mostly executable guidance with minor gaps' (4).

4 / 5

Workflow Clarity

The section order is the execution order — Intake, Normalize, Review the security policy, Assess the specific claim, Verdicts, Rank and route, Return the result — with decision checkpoints throughout: ask before inspecting when no finding is supplied, 'Wait for selection before querying GitHub', record proof gaps, and 'retain needs_review' when an unresolved fact remains. Feedback loops exist (re-review policy 'as the investigation reaches them'; escalate unresolved facts to needs_review). It sits at 4 rather than 5 because several gate conditions are left to judgment rather than explicit validate-then-proceed mechanics, and there is no final self-check step (e.g., verify one result per input before emitting the contract).

4 / 5

Progressive Disclosure

The three bundle references (references/ticket-intake.md, references/github-rest-intake.md, references/triage-result-contract.md) all exist, are one level deep with no chained references, and are well-signaled at point of use with their purpose ('Read references/github-rest-intake.md for repository intake'). Structure is good but not 5: the body also leans on paths outside the bundle ('../../references/security-guidance.md', '../../references/static-finding-assessment.md', '../../schemas/findings.schema.json') that do not resolve within the provided bundle, and core decision policy (verdict definitions, boundary rules) is fully inlined rather than split — matching 'good structure; most content appropriately placed; minor organization gaps' (4).

4 / 5

Total

17

/

20

Passed

Description

78%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, disciplined description: it states the concrete method (security policy plus static code evidence), enumerates accepted input sources, and closes with explicit exclusions that sharply delimit the skill's niche. The main improvement would be a positive 'Use when...' clause with natural trigger terms like 'vulnerabilities' or 'CVEs'.

Suggestions

Add a positive trigger clause (e.g., 'Use when a user supplies scanner findings, vulnerabilities, CVEs, advisories, or security tickets to evaluate') to complement the 'Do not use for...' exclusions and lift completeness and trigger coverage.

Mention the concrete outputs (confirmed / not_actionable / needs_review verdicts with exploitability ranking) so the 'what' covers the full capability.

DimensionReasoningScore

Specificity

Concrete actions and method are stated ('Triage supplied or imported security findings against a repository using its security policy and static code evidence') along with specific accepted inputs ('scanner reports, advisories, GitHub findings, and Jira or Linear tickets'), but coverage stops short of naming the outputs (verdicts, ranking) or more of the concrete operations the body performs. This matches 'several specific actions; minor gaps' (4) rather than the comprehensive coverage of 5, and clearly exceeds the 1-2-action scope of 3.

4 / 5

Completeness

The 'what' is explicit (triage findings against a repo using security policy and static evidence, with enumerated input types), and trigger guidance is given through an explicit accepted-inputs list plus explicit exclusions ('Do not use for discovery, duplicate triage, runtime validation, or fixes'). The positive 'when' is delineated by these statements rather than a direct 'Use when...' clause, so it matches 'both what and when; when could be more explicit' (4); the accepted-inputs and exclusion lists are explicit trigger guidance that keeps it above the anchor-3 cap for a missing trigger.

4 / 5

Trigger Term Quality

Natural trigger terms are present and varied — 'security findings', 'scanner reports', 'advisories', 'GitHub findings', 'Jira or Linear tickets', 'repository' — which users would plausibly say when needing this skill. Common variations like 'vulnerabilities', 'CVEs', 'SARIF', or 'Dependabot' are absent, so it fits 'good keyword coverage; a few natural terms missing' (4) rather than the comprehensive synonym coverage of 5.

4 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche — static triage of already-supplied findings — and the explicit exclusions ('Do not use for discovery, duplicate triage, runtime validation, or fixes') actively disambiguate it from sibling skills for those tasks. This matches 'clear niche with distinct triggers; minimal conflict risk' (5).

5 / 5

Total

17

/

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

openai/plugins

Path

plugins/codex-security/skills/triage-finding/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.