CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

snyk-findings-export

Use when the user wants Snyk findings collected or exported as structured records with their supporting evidence, for example "export Snyk findings for this repo as JSON", "collect Snyk SCA and Code results with evidence for our security tooling", or "give me a machine-readable Snyk findings bundle". Runs only the Snyk scans the user puts in scope through the local Snyk MCP server, keeps each native record, and writes one JSON bundle plus a short coverage summary. Read-only. Not for fixing issues (use snyk-fix) or choosing packages (use secure-dependency-health-check).

77

Quality

97%

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

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 tight, highly actionable skill body: exact commands and tool arguments, a validated write step, and per-failure-mode handling, with detail correctly pushed to two real, well-linked reference files. The only weakness is slight redundancy across sections that keeps it from maximal leanness.

Suggestions

State the file-modification-times prohibition once (Timestamps section) and drop the restatement in 'Keep the bundle honest', keeping only the positive rule that observation time is the scan's finishedAt.

Consolidate the overlapping honesty rules in 'Keep the bundle honest' with the corresponding workflow steps (e.g., availability states are defined in bundle-format.md; the body repeats the never-null rule) to trim duplicated guidance.

DimensionReasoningScore

Conciseness

Efficient and dense with operational specifics, but with minor trimming opportunities: the file-modification-times prohibition appears twice ("Never use another `date` format or file modification times" in Timestamps and "Observation time is the scan's own `finishedAt`. Never use file modification times" in Keep the bundle honest), and a few similar restatements across sections. This fits anchor 4 ("minor instances of over-explanation that could be trimmed") better than anchor 5 ("every token earns its place").

4 / 5

Actionability

Fully executable, copy-paste-ready guidance: exact tool-argument table (e.g., `snyk_sca_scan` with `{path, all_projects: true, include_ignores: true}`), exact shell commands (`date -u +%Y-%m-%dT%H:%M:%SZ`, `git -C <path> rev-parse HEAD`, `python3 -m json.tool <output> > /dev/null`, PowerShell equivalents), explicit defaults (output path, scan order), and per-failure handling. Specific commands cover the common cases, matching anchor 5.

5 / 5

Workflow Clarity

Clear six-step sequence (snapshot context, scanner version, scans, build records, write-and-check, report) with an explicit validation checkpoint ("Confirm it parses: `python3 -m json.tool <output> > /dev/null`") and feedback loops for error recovery (auth error → stop and ask; tool unavailable → record `outcome: "unavailable"`; other failure → retry once, record, continue). This matches anchor 5's explicit validation plus error-recovery loops.

5 / 5

Progressive Disclosure

The body stays an orchestration overview while field mapping and bundle shaping are clearly signaled, one-level-deep references that exist as substantive files: "Map fields and choose identifiers with [references/evidence-profiles.md](references/evidence-profiles.md)" and "Shape the bundle and set availability states with [references/bundle-format.md](references/bundle-format.md)". Content is appropriately split with easy navigation, matching anchor 5.

5 / 5

Total

19

/

20

Passed

Description

100%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 capability list, literal example trigger phrases, explicit read-only scope, and explicit hand-offs to sibling skills. It fully answers both what the skill does and when to use it without padding or over-claiming.

DimensionReasoningScore

Specificity

Multiple specific concrete actions with comprehensive coverage: "Runs only the Snyk scans the user puts in scope through the local Snyk MCP server, keeps each native record, and writes one JSON bundle plus a short coverage summary. Read-only." Each action is distinct and concrete (scoped scans, native-record preservation, single JSON bundle output, coverage summary), matching the anchor-5 example's level of detail rather than leaving minor coverage gaps.

5 / 5

Completeness

Explicitly answers both questions: what ("Runs only the Snyk scans the user puts in scope through the local Snyk MCP server, keeps each native record, and writes one JSON bundle plus a short coverage summary") and when ("Use when the user wants Snyk findings collected or exported as structured records with their supporting evidence", followed by three concrete example trigger phrases). This mirrors the anchor-5 example's structure; it also adds scope exclusions, exceeding anchor 4's "when could be more explicit".

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage with synonyms and literal user phrasings: "export Snyk findings for this repo as JSON", "collect Snyk SCA and Code results with evidence", "machine-readable Snyk findings bundle", plus variations "collected or exported" and "structured records". These are exactly the phrases a user would naturally say, so it matches anchor 5 rather than anchor 4 ("a few natural terms missing").

5 / 5

Distinctiveness Conflict Risk

Clear niche with distinct triggers and explicit disambiguation: "Not for fixing issues (use snyk-fix) or choosing packages (use secure-dependency-health-check)" removes overlap with the closest sibling skills, and the export/evidence framing is distinct from generic scanning or fixing. Minimal conflict risk, matching anchor 5.

5 / 5

Total

20

/

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

snyk/studio-recipes

Path

plugins/codex/skills/snyk-findings-export/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.