/install ai-skill-scanner
Skill Security Scanner
Scan skills for malicious patterns before installation. Detects credential exfiltration, suspicious network calls, obfuscated code, prompt injection, and other red flags.
Quick Start
# Scan a local skill folder
python3 scripts/scan.py /path/to/skill
# Verbose output (show matched lines)
python3 scripts/scan.py /path/to/skill --verbose
# JSON output (for automation)
python3 scripts/scan.py /path/to/skill --json
Workflow: Scan Before Install
- Download or locate the skill folder
- Run
python3 scripts/scan.py \x3Cskill-path> --verbose - Review findings by severity (CRITICAL/HIGH = do not install)
- Report results to user with recommendation
Score Interpretation
| Score | Meaning | Recommendation |
|---|---|---|
| CLEAN | No issues found | Safe to install |
| INFO | Minor notes only | Safe to install |
| REVIEW | Medium-severity findings | Review manually before installing |
| SUSPICIOUS | High-severity findings | Do NOT install without thorough manual review |
| DANGEROUS | Critical findings detected | Do NOT install — likely malicious |
Exit Codes
0= CLEAN/INFO1= REVIEW2= SUSPICIOUS3= DANGEROUS
Rules Reference
See references/rules.md for full list of detection rules, severity levels, and whitelisted domains.
Limitations
- Pattern-based detection — cannot catch all obfuscation techniques
- No runtime analysis — only static scanning
- False positives possible for legitimate tools that access network/files
- Always combine with manual review for HIGH/MEDIUM findings
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install ai-skill-scanner - After installation, invoke the skill by name or use
/ai-skill-scanner - Provide required inputs per the skill's parameter spec and get structured output
What is AI Skill Scanner?
Scan OpenBot/Clawdbot skills for security vulnerabilities, malicious code, and suspicious patterns before installing them. Use when a user wants to audit a skill, check if a ClawHub skill is safe, scan for credential exfiltration, detect prompt injection, or review skill security. Triggers on security audit, skill safety check, malware scan, or trust verification. It is an AI Agent Skill for Claude Code / OpenClaw, with 2828 downloads so far.
How do I install AI Skill Scanner?
Run "/install ai-skill-scanner" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is AI Skill Scanner free?
Yes, AI Skill Scanner is completely free (open-source). You can download, install and use it at no cost.
Which platforms does AI Skill Scanner support?
AI Skill Scanner is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created AI Skill Scanner?
It is built and maintained by HugoSbl (@hugosbl); the current version is v2.1.0.