our-claude-skills/docs/settings-audit-report.md

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:

"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:

"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:

"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

{
  "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