에이전트 스킬용 보안 스캐너
AI Agent Skills를 위한 최선 노력(best-effort) 보안 스캐너로, 프롬프트 인젝션, 데이터 유출, 악성 코드 패턴을 탐지합니다. 패턴 기반 탐지(YAML + YARA-X), AST 및 데이터플로우 분석, 선택적 LLM-as-a-judge, 그리고 타입이 지정된 탐지기 사실(fact)에 대한 제한된 CEL 의사결정 계층을 결합합니다.
중요: 이 스캐너는 최선 노력 탐지를 제공하며, 포괄적이거나 완전한 커버리지를 제공하지 않습니다. 발견 사항이 없는 스캔 결과가 해당 스킬에 모든 위협이 없음을 보장하지는 않습니다. 아래의 범위 및 한계를 참조하세요.
Agent Skills 명세를 따르는 OpenAI Codex Skills 및 Cursor Agent Skills 형식을 지원합니다. --lenient 사용 시 Claude Code .claude/commands/*.md 및 플랫 마크다운 스킬 저장소와 같은 비표준 형식도 스캔합니다.
cel-go v0.32.0 런타임을 사용하여 결정론적 탐지 이후, 선택적 LLM 분석 이전에 제한된 사실(fact)들을 상호 연관시킵니다low-noise 및 quiet 프리셋과 LLM 상한을 제공하며, 각각에 대해 재현율, 오탐률, F1이 공개됩니다 (권장 설정)Cisco AI Discord에 참여하세요 - 토론, 피드백 공유, 팀과의 소통을 위해.
Skill Scanner는 탐지 도구입니다. 알려진 그리고 개연성 있는 위험 패턴을 식별하지만, 보안을 인증하지는 않습니다.
주요 한계:
홀드아웃 스킬(MaliciousSkillBench의 동결된 테스트 분할, 악성 839개 및 무해 545개)에서:
balanced), 66.7%가 MEDIUM+ 등급에서 검토 대상에 도달하며(오탐률 15.4%), 33.7%가 HIGH 등급에서 차단됩니다(오탐률 6.4%).모든 수치는 해당 코퍼스 및 방법론과 함께 측정된 결과와 평가 Space에 있습니다.
문서 웹사이트는 **cisco-ai-defense.github.io/docs/skill-scanner**입니다.
심층 분석 페이지는 docs/에 있습니다.
| 가이드 | 설명 |
|---|---|
| 빠른 시작 | 5분 만에 시작하기 |
| 권장 설정 | 가장 낮은 FPR 또는 가장 높은 F1을 위한 설정을 선택하고, 복사-붙여넣기 가능한 구성을 제공합니다 |
| LLM 제공자 | 모든 제공자, 게이트웨이 또는 로컬 모델에 대해 LLM 판정기를 구성합니다 |
| 결과 및 튜닝 | 발견 사항을 읽고, 검토 큐를 만들고, 오탐을 줄입니다 |
| 아키텍처 | 시스템 설계 및 구성 요소 |
| CEL 결정 계층 | 타입이 지정된 팩트, 안전 경계, 롤아웃 모드 및 텔레메트리 |
| 위협 분류 체계 | 예시와 함께 제공되는 전체 AITech 위협 분류 체계 |
| 분류 체계 참조 | 모든 AITech 및 AISubtech 코드의 정의 |
| LLM 분석기 | LLM 구성 및 사용법 |
| System One 분석기 | 선택적 권고 스크리닝 계층과 이것이 게이트 역할을 할 수 없는 이유 |
| 메타 분석기 | 선택적 2차 검토 (기본적으로 꺼져 있음; 측정된 비용) |
| 행동 분석기 | 데이터 흐름 분석 세부 사항 |
| 스캔 정책 | 사용자 지정 정책, 프리셋 및 튜닝 가이드 |
| 정책 빠른 참조 | 정책 섹션 및 설정 항목에 대한 간결한 참조 |
| 측정된 결과 | 모든 공개 수치와 해당 코퍼스, 모집단 및 모델 |
| 규칙 작성 | 시그니처, YARA 및 Python 규칙을 추가하는 방법 |
| GitHub Actions | CI/CD 통합을 위한 재사용 가능한 워크플로 |
| API 참조 | REST API 문서 |
| 개발 가이드 | 기여 및 개발 환경 설정 |
필수 조건: CPython 3.11–3.14 및 uv (권장) 또는 pip.
휠에는 glibc Linux x86-64/ARM64, macOS 14+ x86-64/ARM64 및 Windows x86-64용 CEL 헬퍼가 포함되어 있습니다. 다른 플랫폼은 Go 1.27.1+가 필요한 소스 배포판에서 빌드합니다. 자세한 내용은 설치 및 구성을 참조하세요.
# Using uv (recommended)
uv pip install cisco-ai-skill-scanner
# As a standalone tool
uv tool install cisco-ai-skill-scanner # or: pipx install cisco-ai-skill-scanner
# Using pip
pip install cisco-ai-skill-scanner
# Using Homebrew (macOS 14+)
brew tap cisco-ai-defense/skill-scanner https://github.com/cisco-ai-defense/skill-scanner
brew install cisco-ai-defense/skill-scanner/skill-scanner
권장 설정의 프리셋과 설정은 2.2.0 이상이 필요합니다(skill-scanner --version).
# AWS Bedrock support (IAM credentials, no API key)
pip install cisco-ai-skill-scanner[bedrock]
# Google AI Studio / Gemini support
pip install cisco-ai-skill-scanner[google]