audit-code

Security-focused code review of project source code. Covers OWASP-style vulnerabilities, hardcoded secrets, dangerous function calls, and patterns relevant to AI-assisted development.

What to do

Run the auditor against the target path:

python3 "$SKILL_DIR/scripts/audit_code.py" "$ARGUMENTS"

If $ARGUMENTS is empty, default to $PROJECT_ROOT.

What it checks

• Hardcoded secrets -- API keys (AWS, GitHub, Stripe, OpenAI, Slack), tokens, private keys, connection strings, passwords
• Dangerous function calls -- eval, exec, subprocess with shell=True, child_process.exec, pickle deserialization, system(), gets(), etc.
• SQL injection -- String concatenation/interpolation in SQL queries
• Dependency risks -- Known hallucinated package names, unverified installations
• Sensitive files -- .env files committed to git, credential files in repo
• File permissions -- Overly permissive chmod patterns
• Exfiltration patterns -- Base64 encode + network send, DNS exfiltration, credential file reads

Output

Structured report with severity-ranked findings, file locations, and actionable remediation steps.

When to use

• Before committing or pushing code
• When reviewing third-party contributions or PRs
• As part of a periodic security audit of the codebase
• After AI-assisted code generation to verify no secrets or vulnerabilities were introduced

Advisory hooks

The repository's .claude/settings.json includes PreToolUse hooks that warn on dangerous Bash and Write operations. These hooks are advisory only -- they produce warnings but do not block execution.

• audit-code is the detection layer for source code security issues
• The hooks provide supplementary runtime warnings during agent operation
• To enforce PreToolUse blocking or escalation, hooks must return hookSpecificOutput.permissionDecision: "deny" or "ask" instead of warning messages