permissions

Manage Claude Code permissions by editing allow, ask, and deny lists in settings.json.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a secure and streamlined way to manage global permissions for Claude Code, ensuring that only authorized actions and tools can be executed.

Core Features & Use Cases

  • Add, Remove, Move Permissions: Easily modify entries across allow, ask, and deny lists in ~/.claude/settings.json.
  • Interactive Mode: Get a summary of current permissions and choose actions interactively.
  • Use Case: You need to grant a new tool access to read specific files but want to ensure it doesn't have broader system access. You can use this skill to add the specific read permission to the allow list.

Quick Start

Use the permissions skill to add the entry "mcp__new_tool__*" to the allow list.

Frequently Asked Questions about permissions

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

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

You can manage Claude Code permissions by modifying the `allow`, `ask`, and `deny` lists in the `~/.claude/settings.json` file. This Skill reads the file, detects your intent, validates input formats, and applies changes with safety checks.

What is the difference between allow, ask, and deny lists in Claude Code?

The allow, ask, and deny lists in Claude Code control tool execution permissions. You can add entries to allow automatic execution, ask for user confirmation, or deny access completely, moving entries between these lists to enforce security boundaries.

How do I add a new tool to the Claude Code allow list?

To add a tool to the allow list, you provide the entry name, such as "mcp__new_tool__*", to the permissions manager. It validates the input format and applies the change to the `allow` array in your global settings file.

Can I move permissions between deny and allow lists without editing files manually?

Yes, you can move permissions between the deny and allow lists interactively. The Skill modifies entries across these lists in `~/.claude/settings.json` based on your intent, applying the changes through a safe edit function rather than manual text editing.

Does Claude Code permission management work for restricting access to specific files?

Yes, Claude Code permission management works for restricting access. You can add specific read permissions to the allow list while keeping broader system access denied, ensuring only authorized actions and tools execute on targeted files.

Why do I need to validate input formats when updating Claude Code settings?

Validating input formats when updating Claude Code settings prevents syntax errors in `~/.claude/settings.json`. The Skill performs validation checks before applying edits to ensure the JSON structure remains intact and the permission entries are correctly formatted.