CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

testland/vex-author

Use when a scanner flags a CVE that analysis shows is not exploitable in your product, and a machine-readable assertion is needed instead of deleting the finding. Writes and validates OpenVEX statements (not_affected, affected, fixed, under_investigation) with vexctl and attaches them to images.

Quality

90%

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

Overview
Quality
Evals
Security
Files

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.

A highly actionable, well-sequenced operational guide: executable commands at every step, explicit validation gates with a CI feedback loop, plus useful anti-patterns and limitations sections. The only weaknesses are minor token efficiency (a redundant jq snippet and a conceptual overview paragraph) and an all-inline structure that forgoes any reference-file split.

DimensionReasoningScore

Conciseness

The body is operational throughout — field tables, justification codes, ready-to-run vexctl/jq commands, anti-patterns, limitations — with little padding. Minor trimmable content keeps it below 5: the conceptual Overview paragraph re-explains what a VEX document is, and the jq justification check is repeated verbatim in Step 7 and the CI step.

4 / 5

Actionability

Every step ships copy-paste-ready commands: full `vexctl create` invocations with author/product/vuln/status/justification flags, `vexctl merge`, `vexctl attest --attach --sign`, an executable jq validation query, a `vexctl filter` preview, and a complete CI YAML job. The worked bash example and resulting report table cover the common case end to end.

5 / 5

Workflow Clarity

Steps 1-9 are clearly sequenced from install through CI, with an explicit validation checklist (Step 7), a concrete gate ("must be empty before handing off"), a pre-commit suppression preview via `vexctl filter` (Step 8), and a CI step that fails the build on unverified claims — a full validate/fix/retry feedback loop for a batch-like operation. Not 4 because checkpoints are explicit rather than implied.

5 / 5

Progressive Disclosure

Well-organized single-file skill with clear section headers, a links-as-needed References section, and no nested or buried references (no bundle files exist, so nothing is missing). It stays at 4 rather than 5 because at ~290 lines everything is inlined with no one-level-deep split of the spec tables or CI material, and the under-50-line simple-skill exception does not apply.

4 / 5

Total

18

/

20

Passed

Description

87%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: explicit 'Use when' trigger clause paired with concrete, third-person capability statements naming the tool, the statement types, and the artifact. Keyword coverage is good though it lacks a few natural synonyms (false positive, suppress), keeping specificity and trigger quality at 4 rather than 5.

DimensionReasoningScore

Specificity

Quotes concrete third-person actions — "Writes and validates OpenVEX statements (not_affected, affected, fixed, under_investigation) with vexctl and attaches them to images" — enumerating the statuses and the tool. Not 5 because merge/filter/CI workflows from the body are absent, leaving minor coverage gaps.

4 / 5

Completeness

Explicitly answers both: "Use when a scanner flags a CVE that analysis shows is not exploitable in your product, and a machine-readable assertion is needed instead of deleting the finding" (when, with concrete triggers) and the writes/validates/attaches sentence (what). Matches the anchor's clear what-and-when with concrete trigger phrases; a 4 would require the 'when' to be less explicit.

5 / 5

Trigger Term Quality

"scanner flags a CVE", "not exploitable", "machine-readable assertion", "OpenVEX", "vexctl", "not_affected" are natural phrases a user in this domain would say. Missing common synonyms like "false positive", "suppress", or "triage", so it falls short of the comprehensive-synonyms anchor at 5.

4 / 5

Distinctiveness Conflict Risk

The OpenVEX/vexctl/CVE-not-exploitable niche is highly specific with distinct triggers (scanner CVE findings, exploitability assertions); minimal overlap with any generic vulnerability or SBOM skill.

5 / 5

Total

18

/

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.

Reviewed

On this page