CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

deep-security-scan

Use when the user asks for a deep, exhaustive, multi-pass, or variance-reducing repository-wide or scoped-path Codex Security scan. Run repeated complete independent Standard scans with the Codex Security deep-scan tool, which aggregates their validated findings and prepares the canonical artifacts; then complete the same scan once. Do not use for PRs, commits, branch diffs, or working-tree diffs.

69

Quality

87%

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

75%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 body delivers highly concrete, executable coordinator instructions with explicit validation checkpoints and error-recovery loops for a complex batch workflow. Its main weaknesses are repetitive prohibition lists and long compound sentences that could be significantly tightened, and reference paths that escape the skill directory and are not verifiable in the bundle.

Suggestions

Consolidate the repeated prohibition lists (rerun worker phases, list candidates, aggregate findings, submit another semantic draft, start another scan) into a single stated-once rule to remove near-verbatim duplication across Phase Ownership, Run Independent Standard Scans, and the result-handling guidance.

Break up the longest compound sentences (e.g., the 60+ word sentence about older generic or benchmark instructions) into short imperative statements so each rule is independently scannable.

Consider trimming or moving the detailed Daybreak Access Advisory edge cases (Bedrock detection, enrollment URL fallbacks) into a referenced file, keeping only the call-or-skip decision rule inline.

DimensionReasoningScore

Conciseness

The body is tool-specific with no padding about concepts Claude already knows, but it could be tightened considerably: prohibition lists repeat nearly verbatim across sections ("Do not rerun worker phases, list candidates, aggregate findings, submit another semantic draft, or start another scan" in Phase Ownership vs. the same list again in Run Independent Standard Scans and the result handling), and sentences run very long with stacked qualifiers (e.g., the 60+ word sentence on older generic benchmark instructions). This fits the 3 anchor ('mostly efficient but... could be tightened') rather than 4, and is not 2 since no section is padded or explains known concepts.

3 / 5

Actionability

Fully executable guidance: exact call signatures are given in the code block ("start_codex_security_deep_scan({ scanId, handoffClaimToken? })", target form, later calls) plus concrete completion ("complete_codex_security_scan({ scanId, handoffClaimToken? })"), context updates, cancellation, and UI fallbacks with specific button labels ("Cancel (Recommended)" and "Continue"). Specific examples cover the common host cases; nothing is left as pseudocode, matching the 5 anchor.

5 / 5

Workflow Clarity

A clear section-ordered sequence (routing → concurrent-scan guard → shared setup → daybreak advisory → run → complete) with explicit validation checkpoints ("Confirm that the manifest, findings.json, and coverage.json exist in the authoritative scanDir"; completion only after "all three unsealed parent artifacts exist") and error-recovery feedback loops (missing/malformed artifacts → stop and surface the blocker; completion failure → surface exact MCP error without retry). The destructive/batch cap does not apply since validation is present, but it falls short of the 5 anchor because the complex multi-phase process has no consolidated ordered checklist — the sequence must be reconstructed from dense prose — leaving minor gaps consistent with the 4 anchor.

4 / 5

Progressive Disclosure

Good section structure with headers, and the coordination policy that dominates the body legitimately belongs in the coordinator's SKILL.md, with workers pointed at one-level references ("Each worker reads ../../references/core-scan.md directly"; "read ../../references/scan-prologue.md once") that are clearly signaled in context. The minor organization gap keeping it at 4 rather than 5: the references use ../../ relative paths that escape the skill directory and cannot be verified against the provided bundle (no references/ directory ships alongside SKILL.md), which is a navigation fragility.

4 / 5

Total

16

/

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 that clearly and explicitly states what the skill does, when to use it, and when not to use it, with concrete tool-level actions and good trigger coverage. The only weakness is a few missing natural synonyms (e.g., 'thorough', 'comprehensive') in the trigger phrasing.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Run repeated complete independent Standard scans with the Codex Security deep-scan tool", "aggregates their validated findings", "prepares the canonical artifacts", "then complete the same scan once" — fully covering the skill's workflow. It is not below the 5 anchor since coverage is comprehensive with no notable gaps, and it exceeds the 4 anchor ('several specific actions; minor gaps').

5 / 5

Completeness

It explicitly answers both questions: the 'what' ("Run repeated complete independent Standard scans... aggregates their validated findings and prepares the canonical artifacts; then complete the same scan once") and the 'when' ("Use when the user asks for a deep, exhaustive, multi-pass, or variance-reducing... scan"), with concrete trigger phrases and an explicit exclusion clause. This matches the 5 anchor; the 4 anchor's 'when could be more explicit' does not apply since the trigger sentence is specific.

5 / 5

Trigger Term Quality

Good keyword coverage of natural trigger variations — "deep, exhaustive, multi-pass, or variance-reducing", "repository-wide or scoped-path Codex Security scan" — plus negative triggers ("Do not use for PRs, commits, branch diffs"). It falls short of the 5 anchor because common user synonyms like "thorough", "comprehensive", or "full security scan" are missing, matching the 4 anchor ('good keyword coverage; a few natural terms missing').

4 / 5

Distinctiveness Conflict Risk

Clear niche (deep/multi-pass variance-reducing scans vs. ordinary scans) with distinct triggers and an explicit "Do not use for PRs, commits, branch diffs, or working-tree diffs" carve-out, giving minimal conflict risk with sibling scan or diff-review skills. Not 4, since the qualifying adjectives ("deep, exhaustive, multi-pass, or variance-reducing") already prevent overlap with the ordinary Standard scan skill when a user asks for a plain security scan.

5 / 5

Total

19

/

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/deep-security-scan/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.