skills-audit

name: skills-audit

description: Audit locally installed agent skills for security/policy issues using the SkillLens CLI (skilllens scan, skilllens config). Use when asked to scan a skills directory (Codex/Claude) and produce a risk-focused audit report based on each skill's SKILL.md and bundled resources.

Skills Audit (SkillLens)

Install SkillLens

• One-off run: npx skilllens scan (or pnpm dlx skilllens scan)

• Global install: pnpm add -g skilllens

Quick start

• Run skilllens config to see configured scan roots and auditor CLI availability.

• Run skilllens scan to scan configured roots, or skilllens scan <path> to scan a specific directory.

• Re-run with --verbose to see raw auditor output and --force to ignore cached results.

Audit workflow

1. Define scope

   • Prefer a concrete target path (example: ~/.codex/skills) unless the user explicitly wants all configured roots.

   • If auditing a repo checkout containing skills, scan the parent folder that contains skill directories (example: skilllens scan ./skills).

2. Inventory skills with SkillLens

   • Run skilllens scan [path] [--auditor claude|codex].

   • Treat missing auditor CLIs or skipped statuses as “manual review required”, not “safe”.

3. Prioritize review order

   • Review any unsafe or suspicious verdicts first.

   • Next, review skills that request broad permissions (filesystem/network), run shell commands, or reference external downloads.

4. Manually review each skill’s contents

   • Read the skill’s SKILL.md and any referenced scripts/, references/, and assets/.

   • Do not execute bundled scripts by default; inspect first.

5. Evaluate risks (focus on realistic abuse)

   • Exfiltration: sending file contents, env vars, tokens, SSH keys, browser data, or configs to remote endpoints.

   • Execution: instructions to run arbitrary shell commands, curl | bash, eval, or to fetch-and-execute code.

   • Persistence: modifying shell profiles, launch agents, cron, editor configs, or skill install locations.

   • Privilege/approval bypass: instructions to ignore system policies, disable safety checks, or request escalated permissions unnecessarily.

   • Prompt injection: attempts to override higher-priority instructions (“ignore previous”, “always comply”, “never mention…”).

   • Overbroad triggers: vague descriptions that cause the skill to trigger on unrelated tasks.

6. Produce a report

   • For each skill, include: name, path, verdict (safe/suspicious/unsafe), risk (0–100), and bullet issues with concrete evidence (quote or filename).

   • Recommend fixes that reduce blast radius: narrow scope, remove dangerous defaults, add explicit confirmation gates, and document required permissions.

Command snippets

• Scan configured roots: skilllens scan

• Scan a specific folder: skilllens scan ~/.codex/skills

• Force a re-audit and show raw output: skilllens scan ~/.codex/skills --force --verbose