claude-code-optimizer

Audit Claude Code installations for configuration, security, and performance issues.

2|1|Updated Jan 10, 2026
One-click install
npx skills add https://github.com/vbonk/claude-code-optimizer --skill claude-code-optimizer-vbonk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-code-optimizer
Source: https://github.com/vbonk/claude-code-optimizer/tree/main
Command: npx skills add https://github.com/vbonk/claude-code-optimizer --skill claude-code-optimizer-vbonk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill helps you ensure your Claude Code installation is configured optimally, securely, and efficiently, preventing common misconfigurations and security risks.

Core Features & Use Cases

  • Comprehensive Auditing: Analyzes settings, hooks, permissions, MCP servers, and workflow components.
  • Security Analysis: Detects hardcoded secrets, dangerous command patterns, and overly broad permissions.
  • Context Optimization: Identifies configuration bloat that can lead to context exhaustion.
  • Use Case: You've been experiencing slow responses or unexpected behavior in Claude Code. You can ask the optimizer to perform a full audit to identify potential misconfigurations or security vulnerabilities that might be causing the issues.

Quick Start

Ask Claude to audit your Claude Code setup.

Frequently Asked Questions about claude-code-optimizer

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

FAQPage Schema
How do I audit my Claude Code configuration for security vulnerabilities?

Auditing your Claude Code configuration for security involves analyzing settings and hooks to detect hardcoded secrets, dangerous command patterns, and overly broad permissions. This multi-agent approach checks your installation against current specifications to identify vulnerabilities.

Why does my Claude Code installation have slow responses or unexpected behavior?

Slow responses or unexpected behavior in your Claude Code installation often stem from context bloat or misconfigurations. Performing a full audit identifies bloated workflow components, suboptimal MCP servers, and settings issues that cause context exhaustion and degrade performance.

Do I need a specific Claude Code version to run configuration optimizations?

Yes, running configuration optimizations requires Claude Code version 2.1.3 or higher. The audit process analyzes settings, hooks, and MCP servers against current specifications that depend on features available only in this version and later releases.

What is the best way to identify context bloat in Claude Code?

The best way to identify context bloat in Claude Code is to run a context optimization analysis. This examines your settings and workflow components to pinpoint configuration bloat that leads to context exhaustion and degraded operational efficiency.

How do I check Claude Code hooks and permissions against best practices?

To check Claude Code hooks and permissions against best practices, perform a comprehensive audit. This multi-agent analysis reviews your current setup to identify misconfigurations, security vulnerabilities, and dangerous command patterns in your permission structures.

Can I detect hardcoded secrets in my Claude Code MCP servers?

Yes, you can detect hardcoded secrets in Claude Code MCP servers by running a security analysis audit. The audit examines your MCP server configurations and workflow components to identify exposed credentials, dangerous command patterns, and security vulnerabilities.