Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
camacho avatar

Audit Permissions

  • 42 installs
  • 1 repo stars
  • Updated May 26, 2026
  • camacho/ai-skills

audit-permissions is a Claude skill that analyzes permission audit logs and recommends safe allow-list changes to reduce permission prompts.

About

This skill analyzes Claude Code permission audit logs and recommends allow-list changes to reduce permission prompts. It runs a TypeScript analyzer, presents a report, and offers to merge only safe patterns into permissions.allow while never modifying permissions.deny. It also flags security warnings and suppresses recommendations that carry danger-level flags. A developer uses it when reviewing how often they get prompted and optimizing the allow-list. It matters because it tightens permission configuration without silently approving risky commands.

  • Analyzes permission audit logs and recommends allow-list changes
  • Report and reset modes, with security warnings and suppressed dangerous recommendations
  • Merges safe rules into permissions.allow without touching permissions.deny

Audit Permissions by the numbers

  • 42 all-time installs (skills.sh)
  • Ranked #1,398 of 2,203 Security skills by installs in the Skillselion catalog
  • Data as of Jul 28, 2026 (Skillselion catalog sync)
At a glance

audit-permissions capabilities & compatibility

Capabilities
permission audit · security audit · config review
Use cases
security audit
From the docs

What audit-permissions says it does

Analyze permission audit logs and recommend allow-list changes.
SKILL.md
Never touch keys outside `permissions.allow`. Never touch `permissions.deny`.
SKILL.md
npx skills add https://github.com/camacho/ai-skills --skill audit-permissions

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs42
repo stars1
Last updatedMay 26, 2026
Repositorycamacho/ai-skills

What it does

Analyze Claude permission audit logs and recommend safe allow-list additions while flagging dangerous patterns.

Who is it for?

Users of the ai-env setup who want to reduce permission prompts by tuning permissions.allow safely

Skip if: Projects without the ai-env repo and permission-audit hook, which will hit file-not-found errors

When should I use this skill?

reviewing permission prompt frequency, optimizing the allow-list, or resetting the audit log

What you get

Safe allow-list additions merged into permissions.allow with dangerous patterns flagged and suppressed

  • permission audit report
  • recommended safe allow-list rules

By the numbers

  • 2 modes (report, reset)
  • safe rules merged only into permissions.allow

Files

SKILL.mdMarkdownGitHub ↗

Audit Permissions

Analyze permission audit logs and recommend allow-list changes. Wraps the TypeScript analyzer in ai-env.

Args Routing

  • No args / empty: run report (default)
  • Args contain "reset" or "clear": archive log and start fresh

Report Mode (default)

1. Generate Report

node --import tsx /Users/patrickcamacho/projects/camacho/ai-env/src/tools/permission-analyzer.ts

Present the full markdown output to the user.

2. Recommended Allow Rules

If the section has entries:

1. Read ~/.claude/settings.json, extract permissions.allow (default []) 2. Compute new patterns not already present (case-sensitive exact match) 3. Show before/after diff of ONLY permissions.allow 4. Ask: "Apply these N safe rules to settings.json?" (plain text y/n — works on all surfaces) 5. If approved: merge, deduplicate, sort alphabetically, write back with 2-space indent 6. Never touch keys outside permissions.allow. Never touch permissions.deny. 7. Confirm what was added

3. Security Warnings

If present: show each pattern with flags and sample commands. Ask: "Add any of these despite the flags? (list numbers, or 'none')"

4. Suppressed Recommendations

List for awareness. Do NOT offer to add — these have danger-level flags.

Done

Summarize: what was added, how many permission prompts should be reduced.

Reset Mode

/Users/patrickcamacho/projects/camacho/ai-env/.claude/hooks/audit-permissions-reset.sh

Fresh log starts automatically on next tool call.

Prerequisites

RequirementCheck
ai-env repo/Users/patrickcamacho/projects/camacho/ai-env exists (ai-env specific — other projects will see file-not-found errors)
Dependenciespnpm install completed in ai-env
Audit hookpermission-audit-log.sh in ~/.claude/settings.json PreToolUse

Troubleshooting

SymptomFix
"No audit data found"Hook not installed or no un-allowed prompts recorded yet
Analyzer crashesRun pnpm install in ai-env repo
Stale recommendations/audit-permissions reset, accumulate fresh data, re-run
settings.json parse errorValidate: jq . ~/.claude/settings.json

Related skills

FAQ

Does it touch permissions.deny?

No. It only merges safe patterns into permissions.allow and never touches permissions.deny or other keys.

What happens to dangerous patterns?

They are shown as security warnings or suppressed if they carry danger-level flags, never added automatically.

Securityauditappsec

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.