# 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"निष्कर्ष: {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] कोई निष्कर्ष नहीं
अधिकतम गंभीरता: NONE
कुल निष्कर्ष: 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

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

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