skillguard은(는) 무엇을 하나요?
AI 에이전트 스킬, MCP 설정, 코딩 에이전트 명령 파일에서 위험한 동작을 스캔합니다.
개요
skillguard는 AI 에이전트 에코시스템에서 사용되는 설정 및 명령 파일을 분석하여 잠재적으로 위험한 동작이나 보안 취약점을 식별합니다.
지원 플랫폼
- Claude Code
- Cursor
- Codex
- 기타 AI 에이전트 플랫폼
스캔 대상
- AI 에이전트 스킬 파일
- MCP(Model Context Protocol) 설정 파일
- 코딩 에이전트 명령 파일
설치
git clone https://github.com/buzzicra/skillguard.git
cd skillguard
pip install -r requirements.txt
사용법
python skillguard.py <파일 또는 디렉토리 경로>
예시:
# 단일 파일 스캔
python skillguard.py ./skill.md
# 디렉토리 내 모든 파일 스캔
python skillguard.py ./skills/
탐지 규칙
다음과 같은 위험 동작을 탐지합니다:
- 파일 시스템 접근: 임의 파일 읽기/쓰기/삭제 시도
- 네트워크 요청: 외부 서버로의 데이터 전송
- 환경 변수 읽기:
env객체를 통한 환경 변수 접근 - 명령 실행:
exec,eval등 동적 코드 실행 - 시스템 명령:
os.system,subprocess호출
설정
skillguard.conf 파일에서 사용자 정의 규칙을 추가할 수 있습니다.
rules:
- name: 민감한 함수 호출
pattern: "dangerous_function"
level: warn
출력 형식
기본적으로 터미널에 결과를 출력하며, --json 플래그를 사용해 JSON 형식으로 출력할 수 있습니다.
python skillguard.py ./target.md --json
라이선스
MIT