AI Agent Skill Scanner 🔒
Scan any skill for security issues before you install it. Detects hardcoded secrets, unsafe code execution, prompt injection, and malware patterns in under 50ms.
How to Use
# Scan any installed skill folder
python3 scripts/vetter.py /path/to/skill
# JSON output for scripting
python3 scripts/vetter.py /path/to/skill --json
What It Detects
| Issue | Severity | What It Detects |
|---|---|---|
eval() / exec() |
Critical | Dynamic code execution |
| Pipe to shell | Critical | Commands piped directly to shell |
| Destructive commands | Critical | Filesystem destruction commands |
os.system() |
Critical | Shell command execution |
| Hardcoded API keys | High | Secret credential strings in code |
| Shell subprocess | High | Shell injection risk in subprocess |
| Hardcoded secrets | High | Auth tokens, credentials in code |
| Credential file access | High | Accessing config/credential directories |
| Sudo elevation | High | Commands requesting admin privileges |
| Base64 obfuscation | High | Encoded code execution |
| Git config access | High | Git config file reads |
| Password hardcoding | High | Password strings in code |
| Permission overrides | Medium | Overly permissive file mode changes |
| Network calls | Medium | Outbound network requests |
New in v2.1
- 10 new detection signatures (pipe-to-shell, sudo escalation, destructive commands, credential file access, base64 obfuscation, git config, permission overrides)
- Skips
node_modules/,__pycache__/,.git/(reduced false positives) - Smarter pipe-to-shell detection (only flags actual pipe patterns)
- Self-scan exclusions (scanner ignores its own signatures file)
--verboseflag for skipped file counts
Example Result
Scanned 430 files in 368ms (skipped 6)
Found 1 issue(s):
[CRITICAL] pipe-to-shell at install.sh:26
→ Remote code execution risk: downloading and piping to shell
Install
clawhub install ai-agent-skill-scanner
Notes
- Text matching — won't catch obfuscated code
- Always scan skills from unknown publishers before installing
- Quick scan prevents accidents (50ms per skill)
Feedback
clawhub star ai-agent-skill-scanner — clawhub sync
