feat: Add multi-agent-guide skill and update reference-curator configs
- Add 91-multi-agent-guide skill for setting up multi-agent collaboration with templates for AGENTS.md, Claude, Gemini, Codex configs, and CI/CD - Add USER-GUIDE.md for reference-curator documentation - Update default paths in reference-curator configs to use ~/Documents/05_AI Agent/10_Reference Library/ - Update settings-audit-report.md Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -1,112 +1,212 @@
|
||||
# Claude Code Settings Audit Report
|
||||
|
||||
**Generated:** 2026-01-20 17:49:51
|
||||
**Generated:** 2026-01-29
|
||||
**Project:** our-claude-skills
|
||||
|
||||
---
|
||||
|
||||
## Token Budget Summary
|
||||
|
||||
| Component | Tokens | % of 200K | Status |
|
||||
|-----------|--------|-----------|--------|
|
||||
| CLAUDE.md | 1,738 | 0.9% | 🟢 |
|
||||
| MCP Servers | 61,500 | 30.8% | 🟡 |
|
||||
| **Baseline Total** | **63,238** | **31.6%** | 🔴 |
|
||||
| **Available for Work** | **136,762** | **68.4%** | — |
|
||||
| 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 |
|
||||
|
||||
**Target:** Baseline under 30% (60,000 tokens), Available over 70%
|
||||
**Assessment:** Excellent token efficiency. ~95% of context available for conversation.
|
||||
|
||||
---
|
||||
|
||||
## Overall Health: 🔴 Critical
|
||||
## Overall Health: 🟢 Good
|
||||
|
||||
- Critical Issues: 1
|
||||
- Warnings: 13
|
||||
- Passing Checks: 56
|
||||
- Critical Issues: 0
|
||||
- Warnings: 2
|
||||
- Passing Checks: 24
|
||||
|
||||
---
|
||||
|
||||
## MCP Server Analysis
|
||||
|
||||
**Servers:** 10 configured
|
||||
### 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 |
|
||||
|
||||
**Active:** 10 | **Disabled:** 0
|
||||
### 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
|
||||
|
||||
| Server | Tokens | Instructions | Status |
|
||||
|--------|--------|--------------|--------|
|
||||
| filesystem | ~4,000 | ✅ | always |
|
||||
| sqlite | ~5,000 | ✅ | lazy |
|
||||
| playwright | ~13,500 | ✅ | always |
|
||||
| figma | ~5,000 | ✅ | lazy |
|
||||
| osascript | ~5,000 | ✅ | lazy |
|
||||
| firecrawl | ~6,000 | ✅ | lazy |
|
||||
| google-analytics | ~5,000 | ✅ | lazy |
|
||||
| chrome-devtools | ~8,000 | ✅ | always |
|
||||
| exa | ~5,000 | ✅ | lazy |
|
||||
| dtm-agent | ~5,000 | ✅ | lazy |
|
||||
**Note:** Plugins use deferred tool loading via Tool Search, which is efficient.
|
||||
|
||||
---
|
||||
|
||||
## CLAUDE.md Analysis
|
||||
|
||||
- **/Users/ourdigital/.claude/CLAUDE.md**: 110 lines, ~800 tokens 🟢
|
||||
- **/Users/ourdigital/Project/claude-skills/CLAUDE.md**: 150 lines, ~938 tokens 🟢
|
||||
### 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: 18
|
||||
- Skills: 28
|
||||
- Agents: 5
|
||||
### 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
|
||||
|
||||
- Baseline uses 31.6% of context - target is under 30%
|
||||
None found.
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ Warnings
|
||||
|
||||
- Command 'settings-audit': Missing YAML frontmatter
|
||||
- Command 'settings-audit': Too long: 120 lines (max 100)
|
||||
- Skill 'jamie-youtube-manager': Too long: 526 lines (max 500)
|
||||
- Agent 'data-analyst': Missing frontmatter
|
||||
- Agent 'data-analyst': Tools not restricted (consider limiting)
|
||||
- Agent 'seo-advisor': Missing frontmatter
|
||||
- Agent 'seo-advisor': Tools not restricted (consider limiting)
|
||||
- Agent 'python-coach': Missing frontmatter
|
||||
- Agent 'python-coach': Tools not restricted (consider limiting)
|
||||
- Agent 'gtm-manager': Missing frontmatter
|
||||
- *...and 3 more*
|
||||
### 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."
|
||||
```
|
||||
|
||||
## ✅ Passing
|
||||
**Impact:** Tool Search may not route requests accurately to these servers.
|
||||
|
||||
- MCP 'filesystem': Has serverInstructions
|
||||
- MCP 'sqlite': Has serverInstructions
|
||||
- MCP 'playwright': Has serverInstructions
|
||||
- MCP 'figma': Has serverInstructions
|
||||
- MCP 'osascript': Has serverInstructions
|
||||
- *...and 51 more*
|
||||
### 2. Project CLAUDE.md exceeds 200 lines
|
||||
**Current:** 232 lines | **Target:** <200 lines
|
||||
|
||||
**Impact:** Minor token overhead (~500 extra tokens).
|
||||
|
||||
---
|
||||
|
||||
## Recommendations
|
||||
|
||||
1. **Fix:** Baseline uses 31.6% of context - target is under 30%
|
||||
### 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
|
||||
|
||||
---
|
||||
|
||||
## Next Steps
|
||||
## Auto-Fix Available
|
||||
|
||||
1. Run `python3 scripts/auto_fix.py` to preview fixes
|
||||
2. Run `python3 scripts/auto_fix.py --apply` to apply fixes
|
||||
3. Re-run audit to verify improvements
|
||||
Run `/settings-audit --fix` to apply:
|
||||
1. ✅ Update `google-analytics` serverInstructions
|
||||
2. ✅ Update `dtm-agent` serverInstructions
|
||||
|
||||
---
|
||||
|
||||
*Generated by Claude Code Settings Optimizer*
|
||||
## 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*
|
||||
|
||||
Reference in New Issue
Block a user