# uv 사용 (권장)
uv pip install cisco-ai-skill-scanner

# pip 사용
pip install cisco-ai-skill-scanner

# LLM 분석기 및 메타 분석기용
export SKILL_SCANNER_LLM_API_KEY="your_api_key"
export SKILL_SCANNER_LLM_MODEL="claude-3-5-sonnet-20241022"
# 선택 사항: disabled, minimal, low, medium, high, xhigh 또는 max
export SKILL_SCANNER_LLM_REASONING_EFFORT="low"

# VirusTotal 바이너리 스캔용
export VIRUSTOTAL_API_KEY="your_virustotal_api_key"

# Cisco AI Defense용
export AI_DEFENSE_API_KEY="your_aidefense_api_key"

skill-scanner

# 단일 스킬 스캔 (핵심 분석기: static + bytecode + pipeline)
skill-scanner scan /path/to/skill

# 동작 분석기로 스캔 (데이터 흐름 분석)
skill-scanner scan /path/to/skill --use-behavioral

# 모든 엔진으로 스캔
skill-scanner scan /path/to/skill --use-behavioral --use-llm --use-aidefense

# 오탐 필터링을 위한 메타 분석기로 스캔
skill-scanner scan /path/to/skill --use-llm --enable-meta

# 모호한 설명 확인을 위한 트리거 분석기로 스캔
skill-scanner scan /path/to/skill --use-trigger

# LLM 분석기를 여러 번 실행하고 다수 합의된 결과만 유지
skill-scanner scan /path/to/skill --use-llm --llm-consensus-runs 3

# 여러 스킬을 재귀적으로 스캔
skill-scanner scan-all /path/to/skills --recursive --use-behavioral

# 스킬 간 중복 탐지로 여러 스킬 스캔
skill-scanner scan-all /path/to/skills --recursive --check-overlap

# GitHub 저장소 스캔 (owner/repo 약식 또는 전체 URL)
skill-scanner scan-repo owner/repo
skill-scanner scan-repo https://github.com/owner/repo --use-llm

# 관대 모드: 실패 대신 잘못된 형식의 스킬 허용
skill-scanner scan /path/to/skill --lenient
skill-scanner scan-all /path/to/skills --recursive --lenient

# 비표준 스킬 형식의 관대 모드 (SKILL.md 불필요)
skill-scanner scan .claude/commands/deploy --lenient
skill-scanner scan-all .claude/commands --recursive --lenient

# SKILL.md 대신 사용자 정의 메타데이터 파일명 사용
skill-scanner scan /path/to/skill --skill-file README.md

# CI/CD: 위협 발견 시 빌드 실패
skill-scanner scan-all ./skills --fail-on-severity high --format sarif --output results.sarif

# 공격 상관 그룹이 포함된 대화형 HTML 보고서 생성
skill-scanner scan /path/to/skill --use-llm --enable-meta --format html --output report.html

# 사용자 정의 YARA 규칙 사용
skill-scanner scan /path/to/skill --custom-rules /path/to/my-rules/

# 사용자 정의 분류 + 위협 매핑 프로필 사용 (JSON/YAML)
skill-scanner scan /path/to/skill --taxonomy /path/to/taxonomy.json --threat-mapping /path/to/threat_mapping.json

# 선택적 알 수 없는 파일 업로드가 포함된 VirusTotal 해시 스캔
skill-scanner scan /path/to/skill --use-virustotal --vt-upload-files

# 스캔 정책 사전 설정 사용 (strict, balanced, permissive)
skill-scanner scan /path/to/skill --policy strict

# 사용자 정의 조직 정책 파일 사용
skill-scanner scan /path/to/skill --policy my_org_policy.yaml

# 사용자 정의할 정책 파일 생성
skill-scanner generate-policy -o my_org_policy.yaml

# 대화형 정책 구성 도구 (TUI)
skill-scanner configure-policy

from skill_scanner import SkillScanner
from skill_scanner.core.analyzers import BehavioralAnalyzer

# 분석기로 스캐너 생성
scanner = SkillScanner(analyzers=[
    BehavioralAnalyzer(),
])

# 스킬 스캔
result = scanner.scan_skill("/path/to/skill")

print(f"Findings: {len(result.findings)}")
print(f"Max severity: {result.max_severity}")

# 참고: is_safe는 HIGH/CRITICAL 결과가 탐지되지 않았음을 나타냅니다.
# 스킬이 모든 위험에서 자유롭다는 것을 보장하지는 않습니다.
if not result.is_safe:
    print("Issues detected -- review findings before deployment")

$ skill-scanner scan ./my-skill --use-behavioral

============================================================
Skill: my-skill
============================================================
Status: [OK] No findings
Max Severity: NONE
Total Findings: 0
Scan Duration: 0.15s

# .github/workflows/scan-skills.yml
name: Scan Skills
on:
  pull_request:
    paths: [".cursor/skills/**"]
jobs:
  scan:
    uses: cisco-ai-defense/skill-scanner/.github/workflows/scan-skills.yml@main
    with:
      skill_path: .cursor/skills
    permissions:
      security-events: write
      contents: read

# .pre-commit-config.yaml
repos:
  - repo: https://github.com/cisco-ai-defense/skill-scanner
    rev: v1.0.0  # 최신 릴리스 태그 사용
    hooks:
      - id: skill-scanner

skill-scanner-pre-commit --install

pre-commit run skill-scanner --from-ref "$BASE_SHA" --to-ref "$HEAD_SHA"

skill-scanner-pre-commit --scan-all