# Claude Code Settings Audit Report
**Generated:** 2026-01-29
**Project:** our-claude-skills

---

## Token Budget Summary

| Component | Lines | Est. Tokens | % of 200K | Status |
|-----------|-------|-------------|-----------|--------|
| Global CLAUDE.md | 118 | ~1,200 | 0.6% | ✅ OK |
| Project CLAUDE.md | 232 | ~2,500 | 1.3% | ⚠️ WARN |
| MCP Servers (11) | — | ~1,000 | 0.5% | ✅ OK |
| Commands (7) | 716 | ~1,800 | 0.9% | ✅ OK |
| Skills (1 loaded) | 480 | ~3,000 | 1.5% | ✅ OK |
| Agents (5) | 195 | ~500 | 0.3% | ✅ OK |
| **Baseline Total** | — | **~10,000** | **5%** | — |
| **Available for Work** | — | **~190,000** | **95%** | ✅ OK |

**Assessment:** Excellent token efficiency. ~95% of context available for conversation.

---

## Overall Health: 🟢 Good

- Critical Issues: 0
- Warnings: 2
- Passing Checks: 24

---

## MCP Server Analysis

### Server Configuration Summary

| Server | serverInstructions | Load Strategy | Status |
|--------|-------------------|---------------|--------|
| filesystem | ✅ Custom | always | ✅ OK |
| sqlite | ✅ Custom | always | ✅ OK |
| playwright | ✅ Custom | always | ✅ OK |
| firecrawl | ✅ Custom | always | ✅ OK |
| google-analytics | ⚠️ Generic | always | ⚠️ WARN |
| chrome-devtools | ✅ Custom | autoStart: false | ✅ OK |
| exa | ✅ Custom | always | ✅ OK |
| dtm-agent | ⚠️ Generic | always | ⚠️ WARN |
| slack | ✅ Custom | always | ✅ OK |
| n8n-instance | ✅ Custom | always | ✅ OK |

### Plugins Enabled (5)
- commit-commands@claude-plugins-official
- figma@claude-plugins-official
- frontend-design@claude-plugins-official
- Notion@claude-plugins-official
- playwright@claude-plugins-official

**Note:** Plugins use deferred tool loading via Tool Search, which is efficient.

---

## CLAUDE.md Analysis

### Global CLAUDE.md (`~/.claude/CLAUDE.md`)
| Metric | Value | Target | Status |
|--------|-------|--------|--------|
| Lines | 118 | <200 | ✅ OK |
| Bytes | 4,652 | — | — |
| Est. Tokens | ~1,200 | <3,000 | ✅ OK |
| Structure | Good | — | ✅ OK |

**Contents:**
- User profile & workspaces (3 Google accounts)
- n8n workflow automation config
- Pending setup notes (Gemini CLI)
- Notion database schema reference
- GTM debugging workflow directive

### Project CLAUDE.md (`./CLAUDE.md`)
| Metric | Value | Target | Status |
|--------|-------|--------|--------|
| Lines | 232 | <200 | ⚠️ WARN |
| Bytes | 9,269 | — | — |
| Est. Tokens | ~2,500 | <3,000 | ✅ OK |
| Structure | Good | — | ✅ OK |

**Contents:**
- Repository overview
- Custom skills summary (29 skills)
- Dual-platform skill structure
- Directory layout
- Creating new skills guide

---

## Extensions Analysis

### Commands (7 files)
| Command | Lines | Frontmatter | Status |
|---------|-------|-------------|--------|
| settings-audit.md | 119 | ✅ Yes | ✅ OK |
| web-crawler.md | 79 | ✅ Yes | ✅ OK |
| reference-discovery.md | 72 | ✅ Yes | ✅ OK |
| content-repository.md | 94 | ✅ Yes | ✅ OK |
| content-distiller.md | 92 | ✅ Yes | ✅ OK |
| markdown-exporter.md | 138 | ✅ Yes | ✅ OK |
| quality-reviewer.md | 122 | ✅ Yes | ✅ OK |

**All commands under 150 lines with proper YAML frontmatter.**

### Skills (1 installed)
| Skill | SKILL.md Lines | Total Files Lines | Status |
|-------|----------------|-------------------|--------|
| jamie-brand-guardian | 480 | 4,141 | ✅ OK |

**Note:** SKILL.md is 480 lines (under 500 limit). Total includes reference files (guides, templates, fact-sheets) which are only loaded on demand.

### Agents (5 files)
| Agent | Lines | Tools Restricted | Status |
|-------|-------|------------------|--------|
| data-analyst.md | 39 | ✅ Yes | ✅ OK |
| seo-advisor.md | 28 | ✅ Yes | ✅ OK |
| python-coach.md | 36 | ✅ Yes | ✅ OK |
| gtm-manager.md | 53 | ✅ Yes | ✅ OK |
| data-engineer.md | 39 | ✅ Yes | ✅ OK |

**All agents under 60 lines with appropriate tool restrictions.**

---

## ❌ Critical Issues

None found.

---

## ⚠️ Warnings

### 1. Generic serverInstructions on 2 MCP servers
**Affected:** `google-analytics`, `dtm-agent`

Both servers have placeholder instructions:
```json
"serverInstructions": "External tool: {server-name}. Use when this functionality is needed."
```

**Impact:** Tool Search may not route requests accurately to these servers.

### 2. Project CLAUDE.md exceeds 200 lines
**Current:** 232 lines | **Target:** <200 lines

**Impact:** Minor token overhead (~500 extra tokens).

---

## Recommendations

### Priority 1: Fix MCP serverInstructions

**google-analytics:**
```json
"serverInstructions": "Google Analytics data retrieval. Use for: GA4 reports, traffic analysis, conversion data, audience insights. Keywords: analytics, GA4, traffic, sessions, users, conversions, pageviews"
```

**dtm-agent:**
```json
"serverInstructions": "GTM container management via API. Use for: tag configuration, trigger management, variable setup, container publishing. Keywords: GTM, tag, trigger, variable, container, workspace, version"
```

### Priority 2: Consider CLAUDE.md optimization
Move these sections to a separate `REFERENCE.md` or link:
- Detailed directory layout (lines 167-218)
- Full skill tables could link to the AUDIT_REPORT.md instead

---

## Auto-Fix Available

Run `/settings-audit --fix` to apply:
1. ✅ Update `google-analytics` serverInstructions
2. ✅ Update `dtm-agent` serverInstructions

---

## Configuration Highlights

### Environment Variables
```json
{
  "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "64000",
  "MAX_THINKING_TOKENS": "31999"
}
```

### Settings
- `alwaysThinkingEnabled`: true ✅

---

## Summary

| Category | Score | Notes |
|----------|-------|-------|
| Token Efficiency | 🟢 Excellent | 95% context available |
| MCP Configuration | 🟡 Good | 2 servers need better instructions |
| CLAUDE.md | 🟢 Good | Slightly over line target but well-structured |
| Extensions | 🟢 Excellent | All properly formatted |
| **Overall** | 🟢 **A-** | Minor improvements suggested |

**Your Claude Code setup is well-optimized.** The 2 MCP server instruction warnings are minor and mainly affect Tool Search routing accuracy for those specific servers.

---

*Generated by Claude Code Settings Audit Skill*
