claude-code-config

Diagnose Claude Code permission precedence, hook execution, and policy overrides.

2|Updated Oct 30, 2025
One-click install
npx skills add https://github.com/zachmayer/skills --skill claude-code-config-zachmayer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-code-config
Source: https://github.com/zachmayer/skills/tree/main/.claude/skills/claude-code-config
Command: npx skills add https://github.com/zachmayer/skills --skill claude-code-config-zachmayer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill resolves confusion regarding Claude Code's non-obvious configuration behaviors, such as permission precedence, silent setting overrides, and complex hook execution logic.

Core Features & Use Cases

  • Permission Debugging: Understand why specific rules are shadowed or ignored due to file precedence and wildcard limitations.
  • Hook Lifecycle Management: Diagnose why hooks fail or behave unexpectedly by mapping exit codes to specific event triggers.
  • Use Case: Use this when a custom permission rule or hook is not firing as expected, or when you need to verify if a setting is being ignored by the managed policy layer.

Quick Start

Ask the agent to explain why a specific permission rule is being ignored by referencing the precedence and wildcard bypass rules in the claude-code-config skill.

Frequently Asked Questions about claude-code-config

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

FAQPage Schema
Why is my Claude Code permission rule being ignored or shadowed by another setting?

Claude Code hooks fail when exit codes do not map correctly to event triggers. Diagnose the hook integration by tracing the event-driven architecture to verify that each hook's exit code aligns with its expected execution lifecycle stage.

How does Claude Code configuration precedence work for managed policy overrides?

Claude Code configuration precedence determines which settings take priority when conflicts arise. Managed policy overrides silently supersede local configurations, requiring a deep analysis of the internal hierarchy to verify if a setting is being actively ignored.

How do I debug complex Claude Code configuration behaviors and hook execution failures?

Debug Claude Code configuration behaviors by mapping permission precedence and hook execution paths. This process isolates environment-specific settings, identifies wildcard limitations, and verifies that managed policy layers are not overriding intended behaviors.

Can I use Claude Code hooks with custom permission rules in environment-specific configurations?

Yes, Claude Code hooks work with custom permission rules, but environment-specific configurations can cause unexpected behaviors. You must verify that file precedence rules and event triggers are not being bypassed by the managed policy layer.

Claude Code hook not firing as expected, what are the configuration limitations?

A Claude Code hook not firing usually stems from exit code mismatches with event triggers or silent managed policy overrides. Limitations in wildcard handling and file precedence often shadow the intended hook execution path within the configuration.