cisco-ai-defense/skill-scanner

어떤 프로젝트인가요?

핵심 기능

• 01YAML 및 YARA-X 패턴 규칙과 AST 및 데이터 흐름 분석을 결합합니다.
• 02탐지 결과를 의미론적으로 검토하는 LLM judge를 선택적으로 사용할 수 있으며, 여러 공급자를 지원합니다.
• 03JSON, Markdown, SARIF 및 인터랙티브 HTML 보고서를 출력합니다.
• 04재사용 가능한 GitHub Actions 워크플로와 pre-commit hook을 제공합니다.
• 05정책 프리셋과 사용자 지정 YAML 정책으로 탐지 노이즈를 조정할 수 있습니다.

활용 사례

• 코딩 어시스턴트에 설치하기 전에 서드파티 에이전트 스킬을 검증합니다.
• SARIF 결과를 GitHub Code Scanning에 표시해 CI에서 스킬 변경을 검사하고 승인 여부를 제어합니다.
• pre-commit을 통해 커밋할 때마다 팀의 스킬 저장소를 검사합니다.
• 스킬 간 중복 검사와 함께 스킬 디렉터리를 일괄 감사합니다.

빠른 시작

1. 1

   uv로 스캐너를 설치합니다

   uv pip install cisco-ai-skill-scanner
2. 2

   LLM judge API 키를 설정합니다

   export SKILL_SCANNER_LLM_API_KEY="your_api_key"
3. 3

   LLM judge와 balanced 프리셋을 사용해 skill을 스캔합니다

   skill-scanner scan /path/to/skill --use-llm --policy balanced --fail-on-severity high

사용 전 알아둘 점

• !최선의 노력으로만 탐지합니다. 탐지 결과가 없더라도 skill이 안전하다고 보장할 수 없습니다.
• !권장 설정에는 LLM judge API 키가 필요합니다. 규칙만으로는 보류 데이터에 포함된 악성 skill의 약 8%만 탐지하기 때문입니다.
• !메타데이터에 라이선스가 NOASSERTION으로 표시되어 있으므로 사용 전에 라이선스 조건을 확인해야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

skill-scanner은(는) 무엇인가요?

AI Agent Skills에서 프롬프트 인젝션, 데이터 유출, 악성 코드 패턴을 탐지하는 최선의 노력을 다하는 보안 스캐너입니다. Skill Scanner는 AI 에이전트 스킬을 설치하거나 공유하기 전에 위험한 콘텐츠가 있는지 검사합니다. 패턴 기반 탐지와 YAML 및 YARA-X 규칙, Python 코드의 AST 및 데이터 흐름 분석을 결합하고, 선택적으로 LLM judge가 탐지 결과를 의미론적으로 검토합니다. 결과는 JSON, Markdown, SARIF 또는 인터랙티브 HTML 보고서로 출력할 수 있습니다.

skill-scanner은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

skill-scanner은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

skill-scanner은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. skill-scanner의 마지막 커밋은 2026년 11월 6일입니다.

skill-scanner은(는) 어디에 사용할 수 있나요?

코딩 어시스턴트에 설치하기 전에 서드파티 에이전트 스킬을 검증합니다. SARIF 결과를 GitHub Code Scanning에 표시해 CI에서 스킬 변경을 검사하고 승인 여부를 제어합니다. pre-commit을 통해 커밋할 때마다 팀의 스킬 저장소를 검사합니다. 스킬 간 중복 검사와 함께 스킬 디렉터리를 일괄 감사합니다.

skill-scanner는 어떻게 설치하나요?

uv로 스캐너를 설치합니다: uv pip install cisco-ai-skill-scanner LLM judge API 키를 설정합니다: export SKILL_SCANNER_LLM_API_KEY="your_api_key" LLM judge와 balanced 프리셋을 사용해 skill을 스캔합니다: skill-scanner scan /path/to/skill --use-llm --policy balanced --fail-on-severity high

skill-scanner은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/cisco-ai-defense/skill-scanner