Claude에게 질문

Cloudflare 보안 감사 AI 스킬: 설치와 사용법

Cloudflare가 오픈소스로 공개한 보안 감사 스킬의 동작 원리, 설치, 실행 방법을 공식 README 기준으로 정리했습니다.

빠른 확인
  • 저장소: github.com/cloudflare/security-audit-skill(MIT 라이선스)
  • 준비: 클로드 데스크톱 앱의 Code 탭(유료 요금제)
  • 비용: 스킬 소스는 무료, 감사 실행 시 Claude 사용량은 별도
  • 주의: 달비가 직접 실행하지 않은 도구입니다. 실제 스캔 품질과 경험은 미확인
  • 확인일: 2026년 10월 23일
보안 감사 스킬의 6단계 흐름: 정찰, 탐색, 검증, 출력, 재검증, 보고서
README에 명시된 6단계 감사 과정 전체 흐름

코딩 에이전트를 보안 감사관으로 바꾸는 스킬(skill, 에이전트에 추가하는 전문 기능)입니다. Cloudflare가 자사 취약점 탐색 체계의 출발점이 된 도구를 오픈소스로 공개했습니다.[1] 이 체계의 배경은 Cloudflare 블로그에서 확인할 수 있습니다.[3] 코드베이스 전체를 6단계로 감사하며, 발견한 문제마다 독립 에이전트가 반박을 시도해 검증된 것만 보고서에 남깁니다.

감사가 진행되는 6단계

부모 에이전트가 사냥꾼 에이전트와 검증자 에이전트를 조율하는 구조도
부모 에이전트가 전체를 조율하고, 사냥꾼과 검증자는 서로 격리돼 있다
보안 감사 스킬의 6단계
단계이름하는 일
1Reconnaissance(정찰)아키텍처, 신뢰 경계, 입력 표면, 커버리지(감사 점검 범위)를 파악한다
2Coverage-led hunting(탐색)커버리지 장부에서 빠진 곳을 찾아 독립 사냥꾼 에이전트를 배정한다
3Candidate validation(후보 검증)발견한 후보를 별도 검증 에이전트에게 넘겨 반박을 시도한다
4Structured output(구조화 출력)판정 결과를 findings.json에 기록하고 스키마로 검증한다
5Independent verification(독립 재검증)새 에이전트가 최종 소스 주장을 다시 확인한다
6Target-neutral reporting(보고서)REPORT.md, FINDINGS-DETAIL.md, NEEDS-VALIDATION.md를 생성한다
사냥꾼 에이전트가 찾은 후보를 검증 에이전트가 반박 검증하는 과정
발견한 에이전트와 검증하는 에이전트는 항상 다르다(Adversarial validation)

README에 따르면 핵심 설계 원칙은 "발견한 에이전트와 검증하는 에이전트가 절대 같지 않다"입니다. 반박에 실패한 것만 confirmed로 남습니다.[1]

스킬에는 두 가지 모드가 있습니다. 보안 질문이나 특정 취약점 조사에는 guidance 모드가 자동 적용되고, 코드베이스 전체 감사나 pen-test를 명시적으로 요청하면 full audit 모드로 6단계 전체가 실행됩니다.[2]

설치하기

설치 전에 저장소의 SKILL.md를 읽어 스킬이 어떤 권한을 사용하는지 확인하세요.

클로드 데스크톱 앱 Code 탭에서 보안 감사 스킬 설치 요청을 입력한 화면
Code 탭 입력창에 아래 요청 문장을 그대로 붙여넣는다
아래 명령을 실행해서 보안 감사 스킬을 설치해줘:
npx skills add https://github.com/cloudflare/security-audit-skill --skill security-audit --global

Code 탭이 명령 실행 허용을 물으면, npm 패키지를 내려받아 스킬을 등록하는 과정이므로 허용합니다.

성공 확인: 스킬이 등록됐다는 메시지가 나오면 설치가 끝난 것입니다. 오류가 나오면 오류 문장을 Code 탭에 그대로 붙여넣고 해결해 달라고 하세요.

프로젝트 한 곳에서만 쓰려면 --global을 빼고 설치합니다.[1]

감사 시작하기

Code 탭에서 보안 감사를 시작하는 요청을 입력한 화면
프로젝트 폴더를 선택한 뒤 감사 요청을 입력한다

감사할 프로젝트 폴더를 선택한 상태에서 Code 탭에 요청합니다.

security audit this codebase

README에 나와 있는 다른 표현도 쓸 수 있습니다.[1]

find security vulnerabilities in ./src
do a security review, output to ~/audits/my-project

출력 폴더를 지정하지 않으면 ~/security-audit-skill/<저장소 이름>/run-<N>에 자동으로 만들어집니다.

성공 확인: 1단계 Reconnaissance가 시작되면서 아키텍처를 파악하는 과정이 보이면 됩니다.

결과 읽기

감사 결과의 세 가지 판정: confirmed, needs_validation, rejected
모든 발견은 이 세 가지 판정 중 하나를 받는다
판정 유형과 의미
판정의미
confirmed소스 추적과 관찰 결과가 완전하다. 심각도(critical, high, medium, low, informational)가 부여된다
needs_validation소스에 근거가 있지만 확인이 막힌 사실이 남아 있다. 심각도 없음
rejected반박에 성공해 후보에서 탈락했다
감사가 끝난 뒤 출력 폴더에 생성되는 보고서 파일 목록
감사가 끝나면 출력 폴더에 이 파일들이 만들어진다
주요 출력 파일
파일내용
REPORT.md전체 감사 요약 보고서
FINDINGS-DETAIL.mdconfirmed 판정의 상세 내역
NEEDS-VALIDATION.md추가 확인이 필요한 항목 목록
findings.json모든 판정을 담은 기계 판독 가능 파일
coverage-ledger.json감사 커버리지 장부

알아둘 것

비용과 반복 실행

스킬 소스는 MIT 라이선스로 무료이지만, 감사를 실행하면 Claude 사용량이 소비됩니다. 여러 에이전트가 동시에 작동하므로 한 번의 감사에도 상당한 사용량이 들 수 있습니다. README에 따르면 한 번 실행은 반복 실행 대비 약 절반의 취약점만 찾습니다.[1]

막혔을 때

30초 체크리스트

공식 출처

  1. cloudflare/security-audit-skill 공식 저장소(README)
  2. security-audit-skill SKILL.md
  3. Cloudflare 블로그: Build your own vulnerability harness

2026년 10월 23일 확인. 설치 방식은 빠르게 바뀔 수 있으므로 공식 저장소의 최신 README를 우선하세요.

가이드가 도움이 되셨다면 여기도 확인해보세요.

제가 직접 만든 작업물, 지침, 템플릿을 올리고 있습니다. (무료임)

무료 자료실 보러가기

Instagram 릴스의 댓글 키워드 보안에 연결되는 공개 실행 문서입니다.

가이드가 도움이 됐다면 무료 자료실 가기