Skip to content
Development
Auto-invokedWhat is this?This plugin ships a FLOW.md router the engine fires, so the matching skill runs itself. No slash command to remember.Learn how →Skill

/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

Boost this skill
@pdugan20pdugan20@pdugan20
From plugin
claudelint
129 skills13 agents1 command1 hook
Install
$ npx -y skills add pdugan20/claudelint --skill validate-settings --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/validate-settings

Context preview

The summary Claude sees to decide when to auto-load this skill.

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

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
Read it on GitHub ↗
Ships withclaudelint

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

Get the whole plugin, auto-invoked
Stats
TypeScriptJavaScriptNodeBashGitHub
+3 tags
MarkdownAnthropicMCP
12
Stars
3
Forks
Active
Maintenance
TypeScript
Language
MIT
License
2d ago
Last commit
7mo ago
Created

Repo: pdugan20/claudelint

In this plugin
13 agents9 skills1 command1 hook
See everything inside

Other skills on claudelint.

See all 9 skills in claudelint