# Usando uv (recomendado)
uv pip install cisco-ai-skill-scanner

# Usando pip
pip install cisco-ai-skill-scanner

# Para el analizador LLM y el meta-analizador
export SKILL_SCANNER_LLM_API_KEY="your_api_key"
export SKILL_SCANNER_LLM_MODEL="claude-3-5-sonnet-20241022"

# Para el escaneo de binarios con VirusTotal
export VIRUSTOTAL_API_KEY="your_virustotal_api_key"

# Para Cisco AI Defense
export AI_DEFENSE_API_KEY="your_aidefense_api_key"

skill-scanner

# Escanea una sola skill (analizadores principales: static + bytecode + pipeline)
skill-scanner scan /path/to/skill

# Escanea con el analizador conductual (análisis de flujo de datos)
skill-scanner scan /path/to/skill --use-behavioral

# Escanea con todos los motores
skill-scanner scan /path/to/skill --use-behavioral --use-llm --use-aidefense

# Escanea con el meta-analizador para filtrar falsos positivos
skill-scanner scan /path/to/skill --use-llm --enable-meta

# Escanea con el analizador de disparadores (trigger) para comprobar descripciones vagas
skill-scanner scan /path/to/skill --use-trigger

# Ejecuta el analizador LLM varias veces y conserva los hallazgos acordados por mayoría
skill-scanner scan /path/to/skill --use-llm --llm-consensus-runs 3

# Escanea varias skills de forma recursiva
skill-scanner scan-all /path/to/skills --recursive --use-behavioral

# Escanea varias skills con detección de solapamiento entre skills
skill-scanner scan-all /path/to/skills --recursive --check-overlap

# Escanea un repositorio de GitHub (abreviatura owner/repo o URL completa)
skill-scanner scan-repo owner/repo
skill-scanner scan-repo https://github.com/owner/repo --use-llm

# Modo tolerante: tolera skills malformadas en lugar de fallar
skill-scanner scan /path/to/skill --lenient
skill-scanner scan-all /path/to/skills --recursive --lenient

# Modo tolerante con formatos de skill no estándar (no se requiere SKILL.md)
skill-scanner scan .claude/commands/deploy --lenient
skill-scanner scan-all .claude/commands --recursive --lenient

# Usa un nombre de archivo de metadatos personalizado en lugar de SKILL.md
skill-scanner scan /path/to/skill --skill-file README.md

# CI/CD: falla la compilación si se encuentran amenazas
skill-scanner scan-all ./skills --fail-on-severity high --format sarif --output results.sarif

# Genera un informe HTML interactivo con grupos de correlación de ataques
skill-scanner scan /path/to/skill --use-llm --enable-meta --format html --output report.html

# Usa reglas YARA personalizadas
skill-scanner scan /path/to/skill --custom-rules /path/to/my-rules/

# Usa perfiles personalizados de taxonomía + mapeo de amenazas (JSON/YAML)
skill-scanner scan /path/to/skill --taxonomy /path/to/taxonomy.json --threat-mapping /path/to/threat_mapping.json

# Escaneo de hashes con VirusTotal con carga opcional de archivos desconocidos
skill-scanner scan /path/to/skill --use-virustotal --vt-upload-files

# Usa un ajuste preestablecido de política de escaneo (strict, balanced, permissive)
skill-scanner scan /path/to/skill --policy strict

# Usa un archivo de política personalizado de tu organización
skill-scanner scan /path/to/skill --policy my_org_policy.yaml

# Genera un archivo de política para personalizar
skill-scanner generate-policy -o my_org_policy.yaml

# Configurador interactivo de políticas (TUI)
skill-scanner configure-policy

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

# Crea el escáner con analizadores
scanner = SkillScanner(analyzers=[
    BehavioralAnalyzer(),
])

# Escanea una skill
result = scanner.scan_skill("/path/to/skill")

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

# Nota: is_safe indica que no se detectaron hallazgos HIGH/CRITICAL.
# No garantiza que la skill esté libre de todo riesgo.
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  # usa la última etiqueta de release
    hooks:
      - id: skill-scanner

skill-scanner-pre-commit install