settings-management

What this skill does

# Configuration Meta Skill

## 🚨 MANDATORY: Invoke docs-management First

> **STOP - Before providing ANY response about Claude Code configuration or settings:**
>
> 1. **INVOKE** `docs-management` skill
> 2. **QUERY** for the user's specific topic
> 3. **BASE** all responses EXCLUSIVELY on official documentation loaded
>
> **Skipping this step results in outdated or incorrect information.**

### Verification Checkpoint

Before responding, verify:

- [ ] Did I invoke docs-management skill?
- [ ] Did official documentation load?
- [ ] Is my response based EXCLUSIVELY on official docs?

If ANY checkbox is unchecked, STOP and invoke docs-management first.

---

## Overview

Central authority for Claude Code configuration and settings. This skill uses **100% delegation to docs-management** - it contains NO duplicated official documentation.

**Architecture:** Pure delegation with keyword registry. All official documentation is accessed via docs-management skill queries.

## When to Use This Skill

**Keywords:** settings, configuration, settings.json, environment variables, permissions, sandbox, enterprise settings, managed-settings.json, user settings, project settings, local settings, tools, hooks configuration, model configuration, plugin settings, precedence

**Use this skill when:**

- Configuring settings.json files
- Understanding settings hierarchy and precedence
- Setting up permission rules (allow, deny, ask)
- Configuring sandbox settings
- Managing enterprise policies
- Setting environment variables
- Understanding available tools
- Configuring plugin settings
- Troubleshooting configuration issues

## Keyword Registry for docs-management Queries

Use these keywords when querying docs-management skill for official documentation:

### Settings Files

| Topic | Keywords |
| --- | --- |
| Overview | "settings", "settings.json", "configuration files" |
| User Settings | "user settings", "~/.claude/settings.json" |
| Project Settings | ".claude/settings.json", "project settings" |
| Local Settings | "settings.local.json", "local settings" |
| Enterprise | "managed-settings.json", "enterprise managed policy" |

### Available Settings

| Topic | Keywords |
| --- | --- |
| Settings Table | "available settings", "settings options" |
| Model Setting | "model setting", "model override" |
| Hooks Setting | "hooks setting", "disableAllHooks" |
| Output Style | "outputStyle setting", "output style config" |
| Status Line | "statusLine setting", "status line config" |
| API Key Helper | "apiKeyHelper", "custom script auth" |
| Keybindings | "keybindings.json", "keyboard shortcuts config", "custom keybindings" |
| Plans Directory | "plansDirectory", "plans directory setting", "plan file storage" |
| Turn Duration | "showTurnDuration", "turn duration display", "timing display" |

### Permissions

| Topic | Keywords |
| --- | --- |
| Permission Settings | "permission settings", "allow deny ask rules" |
| Allow Rules | "permissions allow", "allow tool rules" |
| Deny Rules | "permissions deny", "deny tool rules", "excluding sensitive files" |
| Ask Rules | "permissions ask", "confirmation rules" |
| Default Mode | "defaultMode", "permission modes" |

### Sandbox

| Topic | Keywords |
| --- | --- |
| Sandbox Settings | "sandbox settings", "bash sandboxing" |
| Sandbox Network | "sandbox network", "allowUnixSockets", "allowLocalBinding" |
| Excluded Commands | "excludedCommands", "sandbox exclusions" |
| Auto Allow | "autoAllowBashIfSandboxed", "auto-approve sandboxed" |

### Precedence

| Topic | Keywords |
| --- | --- |
| Settings Precedence | "settings precedence", "configuration hierarchy" |
| Override Order | "enterprise project user precedence", "settings override" |

### Environment Variables

| Topic | Keywords |
| --- | --- |
| Environment Variables | "environment variables", "ANTHROPIC_API_KEY" |
| Model Variables | "ANTHROPIC_MODEL", "model environment" |
| Proxy Variables | "HTTP_PROXY", "HTTPS_PROXY", "proxy configuration" |
| Telemetry Variables | "DISABLE_TELEMETRY", "telemetry settings" |
| Bedrock Variables | "CLAUDE_CODE_USE_BEDROCK", "bedrock environment" |
| Vertex Variables | "CLAUDE_CODE_USE_VERTEX", "vertex environment" |
| Temp Directory | "CLAUDE_CODE_TMPDIR", "temporary directory", "temp file location" |
| Background Tasks | "CLAUDE_CODE_DISABLE_BACKGROUND_TASKS", "disable background tasks", "background process control" |

### Plugins

| Topic | Keywords |
| --- | --- |
| Plugin Configuration | "plugin configuration", "enabledPlugins" |
| Marketplaces | "extraKnownMarketplaces", "plugin marketplaces config" |

### JSON Schema

| Topic | Keywords |
| --- | --- |
| Custom Schema | "settings schema", "JSON schema", "claude-code-settings.schema.json" |
| Schema Location | "custom schema", "extended schema", "SchemaStore" |
| Schema Updates | "update schema", "schema refresh", "/update-settings-schema" |
| Schema Validation | "validate schema", "schema compliance", "draft-07" |

### Tools

| Topic | Keywords |
| --- | --- |
| Available Tools | "tools available to Claude", "tool table" |
| Tool Permissions | "tool permissions", "permission required tools" |

## Quick Decision Tree

**What do you want to do?**

1. **Configure settings file** -> Query docs-management: "settings.json", "available settings"
2. **Set up permissions** -> Query docs-management: "permission settings", "allow deny rules"
3. **Configure sandbox** -> Query docs-management: "sandbox settings", "bash sandboxing"
4. **Understand precedence** -> Query docs-management: "settings precedence", "configuration hierarchy"
5. **Set environment variables** -> Query docs-management: "environment variables", specific variable name
6. **Configure enterprise policy** -> Query docs-management: "managed-settings.json", "enterprise managed policy"
7. **Set up plugin settings** -> Query docs-management: "plugin configuration", "enabledPlugins"
8. **Understand available tools** -> Query docs-management: "tools available to Claude"
9. **Exclude sensitive files** -> Query docs-management: "excluding sensitive files", "deny rules"
10. **Configure model** -> Query docs-management: "model setting", "ANTHROPIC_MODEL"
11. **Troubleshoot config issues** -> Query docs-management: "configuration troubleshooting" + specific issue

## Topic Coverage

> ⚠️ **STALENESS WARNING:** The lists below are for navigation reference only.
> ALWAYS query docs-management for the authoritative, current list of settings fields,
> environment variables, and configuration options. These change with Claude Code releases.

### Settings File Types

Query Pattern: `docs-management: "settings.md file types locations"`

- User settings, project settings, local settings
- Enterprise policies (managed settings)
- Platform-specific paths

### Key Settings Options

Query Pattern: `docs-management: "settings.md available settings table"`

Categories include: authentication helpers, cleanup, announcements, environment, permissions, hooks, model, output styling, status line. Query docs-management for the complete list of current settings fields.

### Permission Settings

Query Pattern: `docs-management: "settings.md permission settings allow deny ask"`

Covers: allow/deny/ask rules, additional directories, default mode, bypass mode controls.

### Sandbox Settings

Query Pattern: `docs-management: "settings.md sandbox settings network"`

Covers: enabled flag, auto-allow behavior, excluded commands, network settings (sockets, binding, proxies).

### Settings Precedence

Query Pattern: `docs-management: "settings.md precedence hierarchy"`

Order (query docs-management for current precedence rules).

### Environment Variable Categories

Query Pattern: `docs-management: "settings.md environment variables"`

Categories: authentication, model config, provider settings, proxy, telemetry, tool behavior.

### Plugin Configuration

Query Pattern: `docs-management: "settings.md plugin configuration enabledPlugins"`

Covers: enabled plugins m