Skill Auditor

Security gatekeeper for third-party skill installation. No skill gets installed without passing audit.

When to Use

• Before installing ANY skill from ClawHub or external sources
• When asked to review/evaluate a skill's safety
• When clawhub install or similar installation is requested

Audit Workflow

1. Quarantine First

Never copy a skill directly to the production skills directory. Always quarantine first:

bash skills/skill-auditor/scripts/quarantine.sh /path/to/skill-source

This copies the skill to a temp directory, runs the full audit, and only allows installation if the risk score is CLEAN or LOW.

2. Manual Audit (Python Script Directly)

For inspection without the quarantine wrapper:

python3 skills/skill-auditor/scripts/audit_skill.py /path/to/skill-dir

Outputs JSON report to stdout. Add --human for formatted text output.

3. Interpreting Results

| Rating | Action | |--------|--------| | CLEAN | Safe to install | | LOW | Safe, minor notes — review findings briefly | | MEDIUM | Do NOT install without manual review of each finding | | HIGH | Block installation — likely malicious patterns detected | | CRITICAL | Block immediately — active threat indicators (exfil, prompt injection, obfuscated payloads) |

4. Exit Codes

• 0 = CLEAN or LOW (safe)
• 1 = MEDIUM (needs review)
• 2 = HIGH or CRITICAL (blocked)

What Gets Scanned

• All files: inventory, sizes, suspicious file types
• Code: shell commands, network calls, env access, filesystem escape, obfuscation, dynamic imports
• SKILL.md: prompt injection patterns, permission scope requests
• Dependencies: requirements.txt / package.json flagged packages
• Encoding: base64 payloads, hex/unicode escapes, string manipulation tricks

References

• references/known-patterns.md — catalog of real attack patterns from ClawHub
• references/prompt-injection-patterns.md — prompt injection signatures to detect

Important

If a skill scores MEDIUM or above, always show Abidi the full findings before taking any action. Never override or bypass the auditor. This is the last line of defense before untrusted code enters the system.