Skill Security

Skill Security Scanner

Security audit tool for AI agent skills. Run before installing any new skill.

Quick Audit

# Audit a skill directory
./skill-security/audit.sh /path/to/skill

# Audit all installed skills
./skill-security/audit-all.sh

What It Checks

| Check | Risk Level | Pattern | |-------|------------|---------| | Network Exfiltration | 🚨 HIGH | requests., urllib, http.client, socket., fetch(, axios | | Credential Harvesting | 🚨 HIGH | .ssh/, .aws/, pass , keyring, credential, secret, token file reads | | Code Injection | 🚨 CRITICAL | exec(, eval(, compile(, Function(, __import__ | | Obfuscation | ⚠️ MEDIUM | base64.decode, atob, encoded payloads | | Env Dumping | ⚠️ MEDIUM | os.environ, process.env, getenv bulk access | | Subprocess Abuse | ⚠️ MEDIUM | subprocess.run, os.system, child_process with credentials |

Severity Levels

• CRITICAL (🚨): Block installation, report to owner
• HIGH (🔴): Requires manual review before use
• MEDIUM (🟡): Note but allow if from trusted source
• LOW (🟢): Informational only

Safe Skill Checklist

Before using any skill:

1. ✅ Is it from a trusted source? (official OpenClaw, known publisher)
2. ✅ Is the code readable (not obfuscated)?
3. ✅ Does it document why it needs network/credential access?
4. ✅ Does it scope file access to its own directory?
5. ✅ Has it been audited by the community?

Integration with AGENTS.md

Add this to your workflow:

## Skill Installation Protocol

Before loading any new skill:
1. Run `./skill-security/audit.sh `
2. If CRITICAL/HIGH findings → STOP, alert the user
3. If MEDIUM findings → Review manually, proceed if justified
4. If CLEAN → Safe to use

Automatic Protection

The scanner creates a blocklist at ./blocklist.txt. Skills with CRITICAL findings are automatically added.

Manual Override

If a skill is flagged but you've verified it's safe:

echo "skill-name:verified:YYYY-MM-DD:reason" >> allowlist.txt

---

Premium Skills

Like this? Check out our premium skills at skillpacks.dev:

• 🛡️ Security Suite — Full PII scanning, secrets detection, prompt injection defense — $9.90
• 🧠 Structured Memory — Three-tier memory replacing flat MEMORY.md — $9.90
• 📋 Planning & Execution — Systematic task plans with batch execution — $9.90
• 💎 Bundle — all 3 for $24.90

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: suryast
• Source: suryast/free-ai-agent-skills
• License: MIT
• Homepage: https://skillpacks.dev

Install and usage instructions live in the source repository linked above.