Index of every page on this site: llms.txt
All skills
openai avatar

/deep-security-scan

@ec0d6c1
by openaiopenai/codex-security14k stars
1,108
Run it yourself

Run repeated Standard security scans of a repository or scoped path when the user requests a deep, exhaustive, or multi-pass audit. For changes to a PR, commit, branch or working tree, use security-diff-scan.

Use this Skill: https://skilld.dev/gh/openai/codex-security/deep-security-scan

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈57 tokens for metadata: the name and description. ≈718 when used: this file. ≈48 more on demand in 1 file.

Description uses 2.9% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈229 characters, or 2.9%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Deep Security Scan

The host runs Standard audits and merges their findings. Workers in the same scan can exchange investigation leads and verify each other’s evidence. Later passes receive the titles and locations already reported. The host stops when consecutive audits add nothing new or the configured scan or time limit is reached. Its final report includes every accepted audit.

  1. Resolve the authorized target and scope. For a scoped directory use that directory as targetPath and scope: ".". For a continuation, call get_codex_security_scan_context with its scanId and supplied handoffClaimToken. Use its saved identity and scope. If its mode is Standard or diff, continue with the corresponding scan skill. Follow ../../references/scan-prologue.md for source access and context updates.
  2. For a new target, call inspect_codex_security_setup({ targetPath, scope: ".", mode: "deep", projectConfigPath? }). Show the effective settings and their sources. max_discovery_runs caps the total number of Standard scans, including when several run together. Pass a project file only when the user selected it. Existing scans use their saved configuration.
  3. For a newly launched native scan with a supplied scan ID, inspect otherRunningDeepScans in the result of get_codex_security_scan_context once. Target-based setup previews have no scan ID. If another Deep scan is active, show its target, phase and human-friendly start time. Explain the additional CPU, memory and token use. Offer Cancel (Recommended) and Continue using request_user_input, then request_codex_security_user_input or plain chat if unavailable. Wait for an explicit choice. A dismissed dialog is not a cancellation. Cancel only the new scan if requested.
  4. Follow ../../references/access-advisory.md, then call start_codex_security_deep_scan({ scanId, handoffClaimToken? }) for an existing scan or start_codex_security_deep_scan({ targetPath, scope: ".", userContext?, projectConfigPath? }) for a new target. Reuse the project file selected at setup. Await the tool. If the tool runner returns a running cell ID, wait on that cell until it returns the scan result. If the connection closes, rejoin with the same arguments. Report a terminal failure with its saved results. For a policy refusal, identify the worker from its saved error when available. On explicit cancellation call cancel_codex_security_scan({ scanId }) from the owning thread.
  5. For an SDK-owned scan, return the host's scan ID and manifest path so the SDK can finalize it. When the tool returns completion, link its generated report.md and canonical artifacts. Use completion.scan.usage and any separate cost estimate to report usage per ../../references/final-report.md. Distinguish a completed audit with zero findings from a deadline reached before any audit completed.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts14d3 checks · Risk SAFE
  • Gen Agent Trust Hub14d

    This skill provides a structured interface for performing deep, multi-pass security audits on code repositories using specialized auditing tools. It includes security considerations common to diagnostic tools, such as the ingestion of untrusted repository data, which are managed through the use of dedicated tool components and human-in-the-loop confirmation for resource-intensive operations.

  • Socket14d

    No alerts

  • Snyk14d

    Risk: LOW · No issues

Signed by skilld at ec0d6c1. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 2 weeks ago

README badge

README badge for openai/codex-security/deep-security-scan