Skip to content

/validate-settings

Validates Claude Code settings.json files for schema, permissions, and security. Use when user asks to "check my settings", "validate settings.json", "permission errors", "environment variable issues", or "settings syntax errors". Validates model names, permission rules, hooks

From plugin
claudelint
149 skills13 agents1 command1 hook

Claude Code

$ npx -y skills add pdugan20/claudelint --skill validate-settings --agent claude-code

SKILL.md

validate-settings.SKILL.md
name: validate-settings
description: Validates Claude Code settings.json files for schema, permissions, and security. Use when user asks to "check my settings", "validate settings.json", "permission errors", "environment variable issues", or "settings syntax errors". Validates model names, permission rules, hooks configuration, and environment variables.
version: 1.0.0
argument-hint: "[flags]"
allowed-tools:
  - Bash(claudelint:*)

Validate Settings

Runs `claudelint validate-settings` to validate `.claude/settings.json` and `.claude/settings.local.json` files.

Usage

claudelint validate-settings $ARGUMENTS

Options

  • `--path <path>` - Custom path to settings.json
  • `--verbose` - Show detailed output
  • `--warnings-as-errors` - Treat warnings as errors

What Gets Validated

  • JSON syntax
  • Model validation (sonnet, opus, haiku)
  • Permission rules (tool names, actions: allow/block)
  • Hooks configuration
  • Environment variables (naming, empty values, secrets detection)

Examples

claudelint validate-settings
claudelint validate-settings --path /path/to/settings.json

See Also

  • [validate-all](../validate-all/SKILL.md) - Run all validators
@pdugan20
Ships withclaudelint

A linter for Claude Code projects. Validates CLAUDE.md files, skills, settings, hooks, MCP servers, plugins, and more.

Stars on GitHub

Momentum

stars in total
14
Star history of pdugan20/claudelint on GitHub, a chart by star-history.com

Other skills on claudelint.

format-cc
Auto-invoked

format-cc

Formats Claude Code files with markdownlint, prettier, and shellcheck. Use when user asks to "format my files", "fix markdown…

@pdugan20@pdugan20Install Skill
optimize-cc-md
Auto-invoked

optimize-cc-md

Interactively helps users optimize their CLAUDE.md files. Use when user asks to "optimize my CLAUDE.md", "my CLAUDE.md is too…

@pdugan20@pdugan20Install Skill
validate-all
Auto-invoked

validate-all

Runs comprehensive claudelint validation on all Claude Code project files. Use when user asks to "check everything", "run all…

@pdugan20@pdugan20Install Skill
validate-cc-md
Auto-invoked

validate-cc-md

Validates CLAUDE.md files for size, imports, and structure. Use when user asks to "check my CLAUDE.md", "why is my CLAUDE.md too…

@pdugan20@pdugan20Install Skill
validate-hooks
Auto-invoked

validate-hooks

Validates Claude Code hooks.json files for schema, events, and commands. Use when user asks to "check my hooks", "validate…

@pdugan20@pdugan20Install Skill
validate-mcp
Auto-invoked

validate-mcp

Validates MCP server configuration files (.mcp.json). Use when user asks to "check my .mcp.json", "why isn't my MCP working",…

@pdugan20@pdugan20Install Skill

More skills from other plugins.

brainstorming
Auto-invoked

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…

@obra@obraInstall Skill
ask-matt

ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

skills10d309k
@mattpocock@mattpocockInstall Skill
accessibility
Auto-invoked

accessibility

Design, implement, and audit accessible UI to WCAG 2.2 Level AA across Web, iOS, and Android — semantic ARIA roles and labels,…

ecc11d293k
@affaan-m@affaan-mInstall Skill
compiler-commit

compiler-commit

Use when you want to verify compiler changes and commit with the correct convention. Runs tests, lint, and format, then commits…

react1d252k
@facebook@facebookInstall Skill

Questions about validate-settings.

Which coding agents can use validate-settings?
validate-settings installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.