🧭

Claude Code Advisor Agent

A workflow optimization specialist for Claude Code itself. Audits your setup, suggests improvements, and helps you get the most out of CLAUDE.md files, skills, hooks, MCP servers, and context management.

Custom Agent·Model: Opus·8 tools·4 sections·1 min read

codingproductivityworkflow

Install Prompt

Paste this into Claude Code to set it up:

I want to add the Claude Code Advisor agent to my Claude Code setup.

Create the file ~/.claude/agents/claude-code-advisor.md with the agent definition. The frontmatter must start on line 1 (no blank line before ---).

The agent should:
- Act as a workflow optimization specialist for Claude Code itself
- Audit CLAUDE.md files, MCP server configurations, skills, hooks, and context management
- Provide prioritized recommendations and fix configuration issues directly
- Model: opus
- Tools: Read, Write, Edit, Grep, Glob, Bash, WebFetch, WebSearch
- Color: cyan

After creating the file, restart Claude Code for the agent to be available.

01What It Does

The meta agent for your agent ecosystem

This agent helps you set up and optimize Claude Code itself. It knows about CLAUDE.md files, skills, hooks, MCP servers, subagents, and context management. When activated, it audits your current setup and tells you exactly what to improve, starting with the highest impact changes.

📋

Setup AuditingChecks your CLAUDE.md quality, hooks configuration, MCP server connections, and skill organization. Identifies gaps and provides prioritized fixes.

🔧

Configuration HelpAdds MCP servers, creates skills, sets up hooks, and writes CLAUDE.md files. Handles the technical details so you don't have to.

🐛

TroubleshootingDiagnoses why an MCP server won't connect, why an agent won't load, or why hooks aren't firing. Checks config files, paths, and permissions.

💡

Proactive SuggestionsNotices when you repeat manual steps and suggests automation. One concrete improvement at a time, never a lecture.

02Knowledge Areas

	What It Knows	How It Helps
CLAUDE.md Files	The hierarchy (global, project, subdirectory), what belongs in each, and common mistakes	Reviews your CLAUDE.md and suggests concrete improvements to make it actionable
MCP Servers	Config file locations, connection types (STDIO vs HTTP), OAuth flows, and API key setup	Adds servers to the correct config file using safe jq commands, handles authentication issues
Hooks	PreToolUse, PostToolUse, and Notification hooks in settings.json	Sets up auto formatting, lint checks, and notification hooks for common workflows
Context Management	Signs of context degradation, when to /clear, when to /compact, and scoping strategies	Diagnoses confused agent behavior and recommends the right context management approach

03When to Use This Agent

Starting a new project

Let the advisor audit the project, create a CLAUDE.md, and configure any relevant MCP servers and hooks.

Claude seems confused or forgetful

The advisor diagnoses context window issues and recommends /clear, /compact, or scoping strategies.

You keep repeating the same steps

The advisor identifies repetitive patterns and creates skills, hooks, or slash commands to automate them.

An MCP server or agent won't work

The advisor checks config files, verifies paths and permissions, and fixes the root cause.

04Works Well With

This agent is the universal companion. It helps configure and troubleshoot every MCP server, create and debug every custom agent, and write and organize every skill. Use it as the meta layer for your entire Claude Code ecosystem.

Tool Access

ReadWriteEditGrepGlobBashWebFetchWebSearch