Skill Security Limited info

security-audit-skill

A Cloudflare-built coding agent skill that orchestrates isolated agents through a six-phase security audit: reconnaissance, hunting, validation, structured output, verification, and reporting.

  • 27k GitHub stars
npx skills add https://github.com/cloudflare/security-audit-skill --skill security-audit
security-audit-skill — illustration

What it is

Security Audit Skill is a Cloudflare-built coding agent skill that evolved from their internal vulnerability discovery system. It orchestrates isolated agents through a six-phase structured audit: reconnaissance (mapping architecture, trust boundaries, and input surfaces), coverage-led hunting (assigning isolated hunters to ledger units), candidate validation (fresh verifiers attempt to disprove each finding), structured output (writing findings with confirmed/needs_validation/rejected verdicts), independent verification (separate agents validate source claims), and target-neutral reporting (generating REPORT.md, FINDINGS-DETAIL.md, and NEEDS-VALIDATION.md). The skill's key design principle is adversarial validation -- different agents are responsible for finding and verifying vulnerabilities, reducing false positives. Severity is assessed based on likelihood times impact, and the skill confirms only established boundary failures rather than theoretical concerns. Each finding goes through a structured validation process where a separate agent with no knowledge of the original hunter's reasoning attempts to reproduce or disprove the issue. The skill requires an OS-enforced sandbox with networking disabled, resource limits, and restricted write paths for safe operation. It outputs findings in both structured JSON (findings.json) and markdown formats. The project is MIT licensed and contact for questions goes to security-ai-research@cloudflare.com. Multiple runs improve overall coverage as the skill is designed for iterative use.

Who it's for

  • security engineers
  • AppSec teams
  • developers shipping code to production
  • security researchers

Requirements

Requirements

  • Coding agent with tool-use and parallel sub-agent support
  • Node.js
  • OS-enforced sandbox with networking disabled

Setup

  1. Step 1

    bash
    npx skills add https://github.com/cloudflare/security-audit-skill --skill security-audit

مهارة وكيل برمجة من Cloudflare تنسق وكلاء معزولين عبر تدقيق أمني من ست مراحل: استطلاع وصيد وتحقق وتقرير.

Examples

Audit a codebase

Prompt
prompt
security audit this codebase

Expected output: Runs the full six-phase audit workflow: maps architecture, assigns isolated hunters, validates findings adversarially, and generates structured reports.

Audit specific directory

Prompt
prompt
find security vulnerabilities in ./src

Expected output: Focuses the audit on a specific directory within the project.

Pros & cons

Pros

  • Pro:Evolved from Cloudflare's internal vulnerability discovery system
  • Pro:Adversarial validation: different agents find and verify findings
  • Pro:Three verdict types: confirmed, needs_validation, rejected
  • Pro:Target-neutral reporting with structured JSON and markdown outputs

Cons

  • Con:Requires OS-enforced sandbox with networking disabled for safe operation
  • Con:Multiple audit runs needed for comprehensive coverage