ljagiello/ctf-skills

Agent skills for solving CTF challenges - web exploitation, binary pwn, crypto, reverse engineering, forensics, OSINT, and more

이게 뭔가요

ctf-skills는 에이전트 스킬 모음입니다. 에이전트 스킬은 Agent Skills 스펙(예: Claude Code)을 따르는 모든 AI 에이전트 플랫폼에서 로드할 수 있는 작고 자족적인 지식 모듈입니다. 각 스킬은 다음을 함께 묶습니다:

CTF(캡처 더 플래그) 하위 도메인(웹, 바이너리-pwn, 암호, 리버스, 포렌식, OSINT, 악성코드 등)에 대한 간단한 설명,
해당 하위 도메인에서 작업하는 데 필요한 사전 요구 도구,
에이전트가 챌린지 해결 중에 호출할 수 있는 즉시 사용 가능한 스크립트, 치트 시트 및 참고 자료 세트.

요컨대, 대규모 CTF 지식 기반을 LLM 기반 에이전트가 소비하고 행동할 수 있는 형식으로 변환합니다.

왜 중요한가요

CTF 대회는 보안 연구자들에게 흔한 놀이터이자 적대적 추론에서 AI 에이전트를 훈련시키는 장소입니다. 가장 큰 마찰은 도구 설정입니다 – 에이전트는 작동하는 컴파일러, 디버거, 암호 라이브러리, 페이로드 컬렉션 등이 필요합니다. ctf-skills는 다음을 통해 이를 해결합니다:

단일 설치 프로그램(scripts/install_ctf_tools.sh)을 제공하여 일반적인 펜테스팅 도구(Python 패키지, apt/brew를 통한 시스템 패키지, Go 바이너리, Ruby 젬 등)를 한 번에 또는 목적에 맞는 그룹으로 프로비저닝할 수 있습니다.
각 스킬에 필요한 정확한 도구 목록을 사전 요구 사항 섹션에 인코딩하여 라이브 대회 중에 에이전트가 누락된 도구를 즉석에서 요청할 수 있습니다.
방대한 PayloadsAllTheThings 저장소를 온디맨드 얕은 클론으로 패키징하여 저장소를 가볍게 유지하면서도 에이전트에게 거대한 페이로드 라이브러리에 대한 접근을 제공합니다.

스킬이 Agent Skills 스펙에 맞게 작성되었기 때문에 해당 스펙을 지원하는 향후 모든 LLM 에이전트(Claude Code, 곧 출시될 OpenAI 플러그인 등)는 사용자 지정 통합 작업 없이 동일한 지식 기반을 즉시 사용할 수 있습니다.

시작하는 방법

에이전트에 스킬 세트 추가
```
npx skills add ljagiello/ctf-skills
```
이렇게 하면 전체 컬렉션이 로컬 Agent-Skills 런타임에 등록됩니다.

필요한 도구 설치 (대회 전에 권장)

bash scripts/install_ctf_tools.sh all   # 전체 설치
# 또는 필요한 것만 설치하는 예:
bash scripts/install_ctf_tools.sh python   # Python 기반 도구만

미리 보려면 --dry-run, 이미 있는지 확인하려면 --verify, 다시 설치하려면 --force를 사용하세요.

오케스트레이터 실행
```
/solve-challenge <CTF 문제 설명 또는 URL>
```
오케스트레이터는 챌린지를 파싱하고 적절한 스킬(예: SQLi에는 ctf-web)을 선택한 후 기본 스크립트나 치트 시트를 호출합니다.
반복 – 에이전트가 작업하면서 각 스킬의 사전 요구 사항 섹션을 읽고 도구가 없으면 동일한 설치 스크립트로 온디맨드 설치할 수 있습니다.

누가 사용해야 하나요

대상	왜 도움이 되나요
CTF 경쟁자	수십 개의 도구를 연결하는 데 시간을 쓰지 마세요. 설치 프로그램이 대신 해주고 스킬 파일은 즉시 사용 가능한 익스플로잇 템플릿을 제공합니다.
보안 교육자 / 트레이너	모든 머신에서 동일하게 작동하는 재현 가능하고 버전 관리되는 도구 상자를 학생들에게 제공합니다.
AI 에이전트 개발자	Agent Skills 스펙을 따르는 구체적이고 실제 세계의 지식 기반으로, 보안 작업에 대한 LLM 에이전트 훈련 또는 평가에 유용합니다.
레드 팀 자동화 엔지니어	내부 자동화 파이프라인에 스킬 세트를 연결하여 초기 익스플로잇 아이디어나 포렌식 트리아지 단계를 자동 생성합니다.

제한 사항 및 미해결 질문

자동화 범위 – 저장소는 스크립트, 치트 시트 및 페이로드 참조를 제공하지만 실제 익스플로잇 생성은 여전히 LLM의 추론에 의존합니다. 완전 자동화된 원클릭 pwn이 아닙니다.
도구 버전 변동 – 설치 프로그램은 많은 시스템 패키지의 최신 버전을 가져옵니다. 수년에 걸친 재현성은 버전을 수동으로 고정해야 할 수 있습니다.
에이전트 스펙 의존성 – 혜택을 받으려면 Agent Skills 스펙을 구현한 에이전트(현재 Claude Code가 언급됨)가 필요합니다. 다른 플랫폼은 어댑터가 필요할 수 있습니다.
설치 프로그램 보안 – 시스템 패키지를 설치하고 외부 저장소를 클론하는 스크립트를 실행하기 전에 민감한 환경에서 사용하기 전에 감사해야 합니다.

TL;DR

ctf-skills는 방대한 CTF 지식(웹, 바이너리, 암호, 포렌식, OSINT 등)을 LLM 기반 에이전트가 로드할 수 있는 에이전트 스킬로 변환합니다. 일반적인 펜테스팅 도구용 원커맨드 설치 프로그램과 챌린지 설명을 올바른 스킬로 라우팅하는 오케스트레이터(/solve-challenge)를 제공합니다. 경쟁자, 트레이너, 그리고 즉시 사용 가능한 보안 도구 상자가 필요한 AI 에이전트를 구축하는 모든 사람에게 이상적입니다.