# 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