security-diff-scan — Codex skill: what it does, how to install
Reviews pull requests, commits, and local diffs for security vulnerabilities. Catches risks in modified and deleted code before merging.
npx skills add openai/plugins --skill security-diff-scan -a codexWhat security-diff-scan does
This skill inspects Git diffs, PRs, and working-tree changes to find security issues. It guides the assistant through threat modeling, finding discovery, and attack-path analysis across modified files without auditing the entire unaffected codebase.
Under the hood, the workflow uses plugin Python scripts alongside Codex MCP helpers. It maps modified files with generate_in_scope_files.py, registers findings, and writes the final summary into report.md and SARIF format.
Install this if you need structured pre-merge security checks on pull requests. Without Python and the required MCP helpers in your environment, running the terminal workflow will fail.
What it helps with
- check Git diffs and pull requests for security vulnerabilities
- build threat models scoped to specific code changes
- trace attack paths through modified and deleted files
- export vulnerability review results to SARIF and Markdown
Example prompts for the agent
- Run security-diff-scan on the current git diff
- Scan the latest commit for security vulnerabilities using security-diff-scan
- Review my working-tree patch with security-diff-scan and generate a SARIF report
How to install security-diff-scan
1Skills CLI (Vercel)
npx skills add openai/plugins --skill security-diff-scan -a codex2Manually: put the files in place
.agents/skills/security-diff-scan/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openai/plugins --skill security-diff-scan -a claude-code2Manually: put the files in place
~/.claude/skills/security-diff-scan/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/security-diff-scan/
Manually: put the files in place
.cursor/skills/security-diff-scan/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openai/plugins security-diff-scan2Manually: put the files in place
.github/skills/security-diff-scan/SKILL.mdPlatform CLI
gemini skills install https://github.com/openai/plugins --path plugins/codex-security/skills/security-diff-scanManually: put the files in place
.devin/skills/security-diff-scan/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set201
The whole set →Similar
Questions about security-diff-scan
How to install security-diff-scan in Codex?
Run npx skills add openai/plugins --skill security-diff-scan in your terminal. This downloads the skill into your project's .agents/skills directory.
What does security-diff-scan do?
It inspects code modifications across commits or branches, identifies potential security flaws, and validates attack paths. The process concludes by producing a Markdown report and SARIF findings.
What output formats does security-diff-scan produce?
The skill generates a report.md summary and a standard SARIF file. It can also produce targeted inline review comments for verified findings.