# Используя 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"

# Для сканирования бинарных файлов через VirusTotal
export VIRUSTOTAL_API_KEY="your_virustotal_api_key"

# Для Cisco AI Defense
export AI_DEFENSE_API_KEY="your_aidefense_api_key"

skill-scanner

# Сканирование одного навыка (основные анализаторы: статический + байткод + конвейерный)
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 (краткая запись владелец/репозиторий или полный 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"Находок: {len(result.findings)}")
print(f"Макс. серьёзность: {result.max_severity}")

# Примечание: is_safe указывает, что не обнаружено находок уровня HIGH/CRITICAL.
# Это не гарантирует, что навык свободен от всех рисков.
if not result.is_safe:
    print("Обнаружены проблемы — проверьте находки перед развёртыванием")

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

============================================================
Навык: my-skill
============================================================
Статус: [OK] Находок нет
Макс. серьёзность: НЕТ
Всего находок: 0
Длительность сканирования: 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