Claude Code Agent Smith
Slash commands for Claude Code that analyze, validate, and optimize your configuration.
Requires Claude Code CLI — Run these commands inside a Claude Code session
What is Claude Code? Claude Code is Anthropic's official agentic coding CLI. Agent Smith adds slash commands that help you check and improve your Claude Code configuration.
What It Does
Agent Smith analyzes, validates, and fixes your Claude Code configuration in one interactive workflow:
- Analyze — Full 7-pillar evaluation with token metrics, instruction quality, and extension ratings
- Track — Score history with trend indicators and regression detection
- Triage — Interactive walkthrough of findings by effort level
- Fix — Apply accepted changes with an execution plan
- Create — Scaffold new configurations with best practices
Quick Start
# Add the marketplace (one-time)
claude plugin marketplace add maxencemeloni/claude-code-agent-smith
# Install the plugin
claude plugin install agent-smith
# Use (in any project)
cd your-project
claude
/analyze-agent
Update:
claude plugin marketplace update agent-smith-marketplace && claude plugin update agent-smith@agent-smith-marketplace
Commands
| Command | Purpose |
|---|---|
/analyze-agent | Full configuration analysis, interactive triage, and guided fixes |
/create-agent | Scaffold new configuration with best practices |
/analyze-agent Workflow
- Analyze — Validates structure, scores all 7 pillars, measures tokens, rates instructions and extensions
- Save Report — Writes full report to
AGENT_SMITH_REPORT.md - Triage — Pick a category: Quick Wins, Recommended, or Advanced
- Decide — For each finding: Yes (apply) / No (skip) / Custom instruction
- Execute — Review the execution plan, confirm, and apply all changes
Sample Output
/analyze-agent
# Agent Smith Analysis
**Project:** your-project
**Type:** Node.js
**Score:** 7.8/10
## Pillar Scores
| Pillar | Score | Notes |
|--------|:-----:|-------|
| Security Posture | 7/10 | Could add more deny rules |
| Instruction Clarity | 8/10 | Well-structured CLAUDE.md |
| Configuration Quality | 8/10 | Good structure |
| Context Efficiency | 6/10 | Missing .claudeignore patterns |
| Command & Extension Design | 9/10 | Clear, well-documented |
| Hook Safety | N/A | No hooks configured |
| MCP Integration | 7/10 | 3 servers configured |
## Content Overview
| Category | Files | Est. Tokens |
|----------|------:|------------:|
| Instructions | 1 | ~4,800 |
| Commands | 5 | ~8,600 |
| Agents | 6 | ~10,500 |
| **Total user content** | | **~23,900** |
## Limitations
This analysis covers user-configurable components only.
Claude Code's system prompt and tool schemas are outside this scope.
Interactive Triage
Which category do you want to address?
A) Quick Wins — 3 low-effort fixes
B) Recommended — 2 medium-effort improvements
C) Advanced — 1 high-effort optimization
D) All categories — Walk through everything
E) Done — Just the report, no changes
After choosing, you walk through each item one by one and decide what to do. Then Agent Smith builds an execution plan and applies your choices.
See
examples/reports/for a full real-world report from Agent Smith's self-analysis, andexamples/configs/for starter configurations for Node.js, Python, and generic projects.
The 7 Evaluation Areas
| Area | Weight | What's Checked |
|---|---|---|
| Security Posture | 20% | Sensitive file protection, dangerous patterns |
| Instruction Clarity | 20% | CLAUDE.md quality, structure, contradictions |
| Configuration Quality | 15% | settings.json structure, allow rules |
| Context Efficiency | 15% | .claudeignore coverage, embedded vs referenced content |
| Command & Extension Design | 15% | Commands, agents, skills: quality, naming, structure |
| Hook Safety | 10% | hooks.json validity, dangerous commands |
| MCP Integration | 5% | MCP server configuration quality |