claude-permissions-audit

Audit and reorganize Claude Code permission settings across global and project-local files.

15|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/jackchuka/skills --skill claude-permissions-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-permissions-audit
Source: https://github.com/jackchuka/skills/tree/main/claude-permissions-audit
Command: npx skills add https://github.com/jackchuka/skills --skill claude-permissions-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Review and reorganize Claude Code permission settings so global settings are the source of truth, project-local files stay minimal, and read vs write operations have clear separation.

Core Features & Use Cases

Phase 1: Discover All Settings Files Phase 2: Audit Phase 3: Propose Reorganization Phase 4: Apply Changes Phase 5: Summary

Quick Start

Run the audit to align global vs local Claude Code permission settings and apply a global-first reorganization.

Frequently Asked Questions about claude-permissions-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit and clean up Claude Code permission settings across multiple projects?

Global Claude Code permissions act as the baseline source of truth for all projects, while project-local settings provide specific overrides. Auditing separates these scopes to ensure read and write operations have clear boundaries and prevent local files from bloating.

What is the best way to align global vs local settings for Claude Code?

The best way to align global vs local settings is applying a global-first reorganization. This involves discovering all settings files, auditing them for misplacement, proposing a clean hierarchy, and applying changes so global config handles broad permissions.

How do I prepare MCP server permissions for new deployments without breaking existing config?

Preparing MCP server permissions involves scanning existing global and local files to remove redundant rules before deployment. The audit outputs a reorganization plan that preserves necessary permissions while clearing out misconfigurations that could conflict during new setup.

When should I reorganize my Claude Code config files?

You should reorganize your Claude Code config files when project-local settings become bloated with rules that belong globally, or when read and write operations lack clear separation. Reorganization establishes a single source of truth and simplifies future deployments.

Can I apply a global-first permission reorganization without losing project-specific access?

Yes, a global-first permission reorganization preserves project-specific access by keeping minimal necessary rules in project-local files. The audit proposes changes that move broad permissions globally while retaining local overrides only for specific read or write operations.