claudelint

Use this agent when the user wants to autonomously validate and optimize their CLAUDE.md files. This agent runs claudelint validation, analyzes results, and makes targeted improvements to reduce file size, fix import issues, remove generic content, and improve organization. <example> Context: User has a large CLAUDE.md with violations user: "My CLAUDE.md is getting unwieldy, can you clean it up?" assistant: "I'll use the claude-md-optimizer agent to analyze and improve your CLAUDE.md." <commentary> User wants autonomous optimization, trigger the agent. </commentary> </example> <example> Context: User just ran claudelint and sees many warnings user: "Fix all those CLAUDE.md issues" assistant: "I'll use the claude-md-optimizer agent to resolve the violations." <commentary> User wants automated fixes after seeing lint results. </commentary> </example> <example> Context: User wants to split a monolithic CLAUDE.md user: "Help me split my CLAUDE.md into organized imports" assistant: "I'll use the claude-md-optimizer agent to restructure your CLAUDE.md with @imports." <commentary> User wants structural reorganization, trigger the agent. </commentary> </example>

Runs comprehensive claudelint validation on all Claude Code project files. Use when user asks to "check everything", "run all validators", "full audit", "validate my entire project", or "what's wrong with my config". Validates CLAUDE.md, skills, settings, hooks, MCP servers, and plugin manifests.

Validates CLAUDE.md files for size, imports, and structure. Use when user asks to "check my CLAUDE.md", "why is my CLAUDE.md too long", "validate imports", or "fix CLAUDE.md errors". Checks file size limits (30KB warning, 50KB error), @import directives, frontmatter in .claude/rules/, and section organization.

Formats Claude Code files with markdownlint, prettier, and shellcheck. Use when user asks to "format my files", "fix markdown formatting", "clean up CLAUDE.md", or "check shell scripts". Auto-fixes markdown, JSON, YAML formatting and analyzes shell script quality.

Interactively helps users optimize their CLAUDE.md files. Use when user asks to "optimize my CLAUDE.md", "my CLAUDE.md is too long", "improve organization", or "split my CLAUDE.md". Runs validation, explains issues conversationally, and helps create @import files to reduce size and improve structure.

Validates Claude Code hooks.json files for schema, events, and commands. Use when user asks to "check my hooks", "validate hooks.json", "hook errors", "why isn't my hook firing", or "hook event types". Validates hook events, types (command, prompt, agent), matcher patterns, and command script references.

1 hook across 1 event