permission-optimizer

Analyze session JSONL to optimize Claude Code permissions in settings.json.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/usadamasa/claude-config --skill permission-optimizer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: permission-optimizer
Source: https://github.com/usadamasa/claude-config/tree/main/.claude/skills/permission-optimizer
Command: npx skills add https://github.com/usadamasa/claude-config --skill permission-optimizer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the management of your Claude Code permissions, ensuring security and efficiency by analyzing tool usage and suggesting optimal configurations for settings.json.

Core Features & Use Cases

  • Permission Auditing: Analyzes past tool usage to identify necessary permission adjustments.
  • Automated Suggestions: Proposes adding new permissions, removing unused ones, and flags potential security risks like "bare entry" warnings.
  • Use Case: Regularly review and update your settings.json to grant necessary access for new tools while revoking permissions for those no longer in use, preventing security vulnerabilities and improving workflow clarity.

Quick Start

Run the permission optimizer to analyze your tool usage and suggest updates to your settings.json file.

Frequently Asked Questions about permission-optimizer

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

FAQPage Schema
How do I optimize Claude Code permissions in settings.json?

Optimize Claude Code permissions by analyzing tool usage patterns from session JSONL data to suggest additions, removals, and flag security risks in settings.json. It audits Bash, Read, Write, and Edit permissions against defined safe, ask, and deny categories.

What are bare entry warnings in Claude permission configurations?

Bare entry warnings in Claude permission configurations are potential security risks identified when settings.json entries lack specific constraints. The optimizer flags these bare entries during analysis to prevent vulnerabilities and ensure adherence to safety categories.

Can I audit Claude tool usage patterns to remove unused permissions?

Yes, you can audit Claude tool usage patterns to remove unused permissions. The optimizer analyzes past session data to identify which Bash, Read, Write, and Edit permissions are no longer needed, suggesting removals to improve security and workflow clarity.

How does the permission optimizer compare to manually editing settings.json?

Unlike manually editing settings.json, the permission optimizer automatically analyzes session data to suggest precise additions and removals based on actual tool usage. It categorizes permissions into safe, ask, and deny actions, preventing security vulnerabilities that manual configuration might miss.

What session data format is required to analyze Claude permissions?

Analyzing Claude permissions requires session data in JSONL format. The optimizer processes these session JSONL files to extract tool usage patterns, comparing them against defined permission categories to generate accurate settings.json recommendations.

When should I review and update my Claude Code settings.json file?

Review and update your Claude Code settings.json file regularly to grant necessary access for new tools and revoke permissions for those no longer in use. This prevents security vulnerabilities, addresses bare entry warnings, and maintains workflow clarity.