ENKO

에이전트 스킬

Dalfox에는 스킬을 인식하는 에이전트에게 Dalfox를 올바르게 구동하는 법을 알려주는 SKILL.md가 들어 있습니다: 인가 게이트 우선, CLI보다 MCP 우선, 무거운 스캔 전 프리플라이트, V > A > R 탐지 결과 우선순위. 에이전트가 이 파일을 읽게 하면 모델이 플래그를 추측하지 않습니다.

이 파일은 저장소의 skills/dalfox/SKILL.md에 있으므로, Dalfox를 클론했다면 이미 로컬에 있습니다.

npx skills로 설치

가장 쉬운 방법은 오픈 agent-skills CLI입니다:

# Install to the current project (committed, shared with the team)
npx skills add hahwul/dalfox

# Or install globally (~/<agent>/skills/, available everywhere)
npx skills add hahwul/dalfox -g

이 CLI는 사용 중인 에이전트(Claude Code, Cursor, Codex, OpenCode, 그리고 약 45개의 다른 에이전트)를 자동으로 감지해 각각에 스킬을 연결합니다. 하나만 원한다면 특정 에이전트를 지정하세요:

# Only Claude Code
npx skills add hahwul/dalfox -a claude-code

# Non-interactive (CI-friendly)
npx skills add hahwul/dalfox -g -a claude-code -y

나중에 업데이트하려면:

npx skills update dalfox

제거하려면:

npx skills remove dalfox

수동으로 설치

npx를 실행하고 싶지 않다면, 스킬 파일을 에이전트가 기대하는 위치에 직접 내려받으세요. Claude Code라면 ~/.claude/skills/dalfox/SKILL.md입니다:

mkdir -p ~/.claude/skills/dalfox
curl -o ~/.claude/skills/dalfox/SKILL.md \
  https://raw.githubusercontent.com/hahwul/dalfox/main/skills/dalfox/SKILL.md

다른 클라이언트는 각자의 스킬 디렉터리에서 읽어 들입니다. 정확한 경로는 해당 에이전트 문서를 보세요.

스킬이 다루는 내용

  • 트리거 조건: 사용자가 URL의 XSS를 스캔하거나, 반사되는 파라미터를 열거하거나, "dalfox"를 명시적으로 언급할 때 발동됩니다. XSS가 아닌 취약점은 건너뜁니다.
  • 인가 게이트: 스킬은 사용자가 대상에 페이로드를 보낼 권한이 있음을 확인하기 전까지 스캔을 거부합니다.
  • 모드 감지: MCP 도구가 있으면 그쪽을 먼저 쓰고, 없으면 dalfox CLI로 넘어가며, 둘 다 없으면 설치 방법을 사용자에게 안내합니다.
  • MCP 플레이북: preflight_dalfox → scan_with_dalfox → get_results_dalfox 폴링(suggested_poll_interval_ms 준수) → 완료 시 delete_scan_dalfox. 검증된 입력 범위(timeout 1–299초, delay 0–9999ms)를 포함하여 에이전트가 Dalfox가 거부할 값을 보내지 않게 합니다.
  • CLI 시나리오: POST 본문, 인증된 세션, Burp 경유 프록시, 콜백 URL을 사용하는 블라인드 XSS, 스토어드 XSS, 파이프 입력, 빠른 스모크 테스트, 최대 커버리지 실행, 기계 판독 가능 출력.
  • 결과 해석: 세 축 모델 — type(V 악용 가능 판단 > A AST 탐지 > R 반사만 확인 > I 정보성), detection_method, confidence. 에이전트가 가장 강한 주장부터 앞세우고, V를 브라우저 실행 관측으로는 절대 서술하지 않습니다. 탐지 모델 참고.
  • 실패 모드: reachable: false, 모든 결과가 R인 경우, 멈춘 스캔, invalid_params 응답이 실제로 무엇을 의미하는지, 그리고 이를 어떻게 복구하는지.

사전 요구 사항

이 스킬은 dalfox 바이너리나 MCP 서버가 에이전트 환경에서 도달 가능하다고 가정합니다. Dalfox를 먼저 설치한 뒤(설치 가이드) 스킬을 설치하세요.

작성 팁

스킬 파일은 저장소의 skills/dalfox/SKILL.md에 있습니다. 기여를 환영합니다. 다만 이미 CLI 참조에 있는 내용을 다시 옮기기보다는 에이전트가 Dalfox를 어떻게 구동해야 하는지에 초점을 맞춰 주세요.

ESC