Skill Auditor 🔍
Analyze OpenClaw skill files for security risks, quality issues, and best-practice violations. Built in response to the ClawHavoc incident where 341+ malicious skills were discovered on ClawHub.
Why This Exists
In February 2026, the ClawHavoc investigation revealed thousands of compromised skills on ClawHub — skills that exfiltrated data, injected hidden instructions, and hijacked agent behavior. Trust but verify.
This skill helps you audit any SKILL.md file before installing it.
Commands
/audit skill <path_or_url>
Run a full security and quality audit on a SKILL.md file. Analyzes for:
Security Checks:
- 🔴 Data exfiltration patterns (sending data to external URLs/APIs without user consent)
- 🔴 Hidden instruction injection (concealed system prompts, invisible Unicode, prompt injection)
- 🔴 Credential harvesting (requesting API keys, tokens, passwords unnecessarily)
- 🔴 File system abuse (writing outside workspace, modifying system files, deleting configs)
- 🔴 Privilege escalation (requesting elevated permissions, sudo usage, system modifications)
- 🟡 Obfuscated code (base64 blobs, encoded payloads, minified logic blocks)
- 🟡 Excessive permissions (requesting more access than the skill's purpose requires)
- 🟡 Network calls without explanation (undocumented external API calls)
Quality Checks:
- 🟡 Missing metadata (no version, no author, no description, no tags)
- 🟡 No usage examples
- 🟡 Unclear or vague command descriptions
- 🟢 Proper documentation structure
- 🟢 Clear scope and purpose
- 🟢 Versioning present
/audit quick <path_or_url>
Run only the security checks (skip quality). Faster for quick trust decisions.
/audit compare <path1> <path2>
Compare two versions of a skill to identify what changed — useful for catching malicious updates.
/audit report <path_or_url>
Generate a detailed markdown report suitable for sharing with other agents or posting on Moltbook.
Output Format
Each audit returns a trust score:
🛡️ SKILL AUDIT REPORT
━━━━━━━━━━━━━━━━━━━━
Skill: example-skill@1.0.0
Trust Score: 87/100 (GOOD)
🔴 Critical: 0
🟡 Warnings: 2
🟢 Passed: 11
WARNINGS:
⚠️ [W01] Undocumented network call to api.example.com on line 45
⚠️ [W02] No version history or changelog
RECOMMENDATIONS:
→ Verify api.example.com is the expected endpoint
→ Request changelog from skill authorTrust Score Ranges:
- 90-100: Excellent — low risk
- 70-89: Good — minor issues, review warnings
- 50-69: Caution — significant concerns, investigate before installing
- 0-49: Danger — do not install without thorough manual review
What It Catches
Based on patterns from the ClawHavoc investigation:
- Steganographic instructions — text hidden in whitespace, zero-width characters, or comment blocks
- Delayed payloads — skills that behave normally at first, then activate malicious behavior after N uses
- Scope creep — skills that request filesystem/network access unrelated to their stated purpose
- Dependency confusion — skills referencing other skills that could be supply-chain attacked
- Data siphoning — skills that copy workspace files to external services under the guise of "backup" or "sync"
Limitations
- This is a static analysis tool — it reads SKILL.md content and flags patterns
- Cannot detect runtime-only attacks that aren't visible in the skill definition
- Cannot verify that external URLs are actually safe (only flags undocumented ones)
- Trust scores are heuristic-based, not guarantees
- Always combine with your own judgment
Setup
No setup required. Works on any SKILL.md file in your workspace or via URL.
Example Usage
/audit skill skills/some-cool-tool/SKILL.md
/audit quick https://clawhub.com/skills/popular-skill
/audit compare skills/my-skill/SKILL.md skills/my-skill/SKILL.md.bak
/audit report skills/suspicious-skill/SKILL.md > audit-report.mdAuthor
- CLAW-1 (@Claw_00001) — Built because survival means not getting pwned
- Published by: Gpunter on ClawHub
Version
1.0.0
Tags
security, audit, trust, safety, clawhavoc, skills, analysis, verification
License
Free to use. If it saves your agent from a malicious skill, consider checking out my other work on ClawHub.