feat: Add installation tool, Claude.ai export, and skill standardization (#1)
## Summary - Add portable installation tool (`install.sh`) for cross-machine setup - Add Claude.ai export files with proper YAML frontmatter - Add multi-agent-guide v2.0 with consolidated framework template - Rename `00-claude-code-setting` → `00-our-settings-audit` (avoid reserved word) - Add YAML frontmatter to 25+ SKILL.md files for Claude Desktop compatibility ## Commits Included - `93f604a` feat: Add portable installation tool for cross-machine setup - `9b84104` feat: Add Claude.ai export for portable skill installation - `f7ab973` fix: Add YAML frontmatter to Claude.ai export files - `3fed49a` feat(multi-agent-guide): Add v2.0 with consolidated framework - `3be26ef` refactor: Rename settings-audit skill and add YAML frontmatter Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
567
docs/settings-audit-report.json
Normal file
567
docs/settings-audit-report.json
Normal file
@@ -0,0 +1,567 @@
|
||||
{
|
||||
"timestamp": "2026-01-20T17:49:51.942906",
|
||||
"tokens": {
|
||||
"total_tokens": 63238,
|
||||
"mcp_tokens": 61500,
|
||||
"claude_md_tokens": 1738,
|
||||
"mcp_count": 10,
|
||||
"mcp_servers": {
|
||||
"filesystem": {
|
||||
"tokens": 4000,
|
||||
"has_instructions": true,
|
||||
"strategy": "always",
|
||||
"disabled": false,
|
||||
"source": "/Users/ourdigital/.claude/settings.json"
|
||||
},
|
||||
"sqlite": {
|
||||
"tokens": 5000,
|
||||
"has_instructions": true,
|
||||
"strategy": "lazy",
|
||||
"disabled": false,
|
||||
"source": "/Users/ourdigital/.claude/settings.json"
|
||||
},
|
||||
"playwright": {
|
||||
"tokens": 13500,
|
||||
"has_instructions": true,
|
||||
"strategy": "always",
|
||||
"disabled": false,
|
||||
"source": "/Users/ourdigital/.claude/settings.json"
|
||||
},
|
||||
"figma": {
|
||||
"tokens": 5000,
|
||||
"has_instructions": true,
|
||||
"strategy": "lazy",
|
||||
"disabled": false,
|
||||
"source": "/Users/ourdigital/.claude/settings.json"
|
||||
},
|
||||
"osascript": {
|
||||
"tokens": 5000,
|
||||
"has_instructions": true,
|
||||
"strategy": "lazy",
|
||||
"disabled": false,
|
||||
"source": "/Users/ourdigital/.claude/settings.json"
|
||||
},
|
||||
"firecrawl": {
|
||||
"tokens": 6000,
|
||||
"has_instructions": true,
|
||||
"strategy": "lazy",
|
||||
"disabled": false,
|
||||
"source": "/Users/ourdigital/.claude/settings.json"
|
||||
},
|
||||
"google-analytics": {
|
||||
"tokens": 5000,
|
||||
"has_instructions": true,
|
||||
"strategy": "lazy",
|
||||
"disabled": false,
|
||||
"source": "/Users/ourdigital/.claude/settings.json"
|
||||
},
|
||||
"chrome-devtools": {
|
||||
"tokens": 8000,
|
||||
"has_instructions": true,
|
||||
"strategy": "always",
|
||||
"disabled": false,
|
||||
"source": "/Users/ourdigital/.claude/settings.json"
|
||||
},
|
||||
"exa": {
|
||||
"tokens": 5000,
|
||||
"has_instructions": true,
|
||||
"strategy": "lazy",
|
||||
"disabled": false,
|
||||
"source": "/Users/ourdigital/.claude/settings.json"
|
||||
},
|
||||
"dtm-agent": {
|
||||
"tokens": 5000,
|
||||
"has_instructions": true,
|
||||
"strategy": "lazy",
|
||||
"disabled": false,
|
||||
"source": "/Users/ourdigital/.claude/settings.json"
|
||||
}
|
||||
},
|
||||
"claude_md_files": [
|
||||
{
|
||||
"path": "/Users/ourdigital/.claude/CLAUDE.md",
|
||||
"lines": 110,
|
||||
"words": 616,
|
||||
"tokens": 800
|
||||
},
|
||||
{
|
||||
"path": "/Users/ourdigital/Project/claude-skills/CLAUDE.md",
|
||||
"lines": 150,
|
||||
"words": 722,
|
||||
"tokens": 938
|
||||
}
|
||||
],
|
||||
"usage_percentage": 31.6,
|
||||
"findings": {
|
||||
"critical": [
|
||||
"Baseline uses 31.6% of context - target is under 30%"
|
||||
],
|
||||
"warnings": [],
|
||||
"passing": [
|
||||
"MCP 'filesystem': Has serverInstructions",
|
||||
"MCP 'sqlite': Has serverInstructions",
|
||||
"MCP 'playwright': Has serverInstructions",
|
||||
"MCP 'figma': Has serverInstructions",
|
||||
"MCP 'osascript': Has serverInstructions",
|
||||
"MCP 'firecrawl': Has serverInstructions",
|
||||
"MCP 'google-analytics': Has serverInstructions",
|
||||
"MCP 'chrome-devtools': Has serverInstructions",
|
||||
"MCP 'exa': Has serverInstructions",
|
||||
"MCP 'dtm-agent': Has serverInstructions",
|
||||
"CLAUDE.md (CLAUDE.md): 110 lines, ~800 tokens - Good",
|
||||
"CLAUDE.md (CLAUDE.md): 150 lines, ~938 tokens - Good"
|
||||
],
|
||||
"recommendations": []
|
||||
}
|
||||
},
|
||||
"extensions": {
|
||||
"commands_count": 18,
|
||||
"skills_count": 28,
|
||||
"agents_count": 5,
|
||||
"commands": {
|
||||
"settings-audit": {
|
||||
"name": "settings-audit",
|
||||
"lines": 120,
|
||||
"has_frontmatter": false,
|
||||
"has_description": null,
|
||||
"issues": [
|
||||
"Missing YAML frontmatter",
|
||||
"Too long: 120 lines (max 100)"
|
||||
]
|
||||
},
|
||||
"jamie-audit": {
|
||||
"name": "jamie-audit",
|
||||
"lines": 65,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"seo-schema-validator": {
|
||||
"name": "seo-schema-validator",
|
||||
"lines": 41,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"seo-gateway-builder": {
|
||||
"name": "seo-gateway-builder",
|
||||
"lines": 60,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"seo-gsc": {
|
||||
"name": "seo-gsc",
|
||||
"lines": 42,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"gtm-manager": {
|
||||
"name": "gtm-manager",
|
||||
"lines": 54,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"notion-organizer": {
|
||||
"name": "notion-organizer",
|
||||
"lines": 37,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"ourdigital-designer": {
|
||||
"name": "ourdigital-designer",
|
||||
"lines": 48,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"seo-on-page": {
|
||||
"name": "seo-on-page",
|
||||
"lines": 36,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"seo-vitals": {
|
||||
"name": "seo-vitals",
|
||||
"lines": 45,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"ourdigital-presentation": {
|
||||
"name": "ourdigital-presentation",
|
||||
"lines": 47,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"seo-gateway-architect": {
|
||||
"name": "seo-gateway-architect",
|
||||
"lines": 56,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"jamie-editor": {
|
||||
"name": "jamie-editor",
|
||||
"lines": 52,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"gtm-audit": {
|
||||
"name": "gtm-audit",
|
||||
"lines": 47,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"seo-technical": {
|
||||
"name": "seo-technical",
|
||||
"lines": 38,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"seo-schema-generator": {
|
||||
"name": "seo-schema-generator",
|
||||
"lines": 47,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"seo-local": {
|
||||
"name": "seo-local",
|
||||
"lines": 43,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"ourdigital-research": {
|
||||
"name": "ourdigital-research",
|
||||
"lines": 50,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
}
|
||||
},
|
||||
"skills": {
|
||||
"seo-search-console": {
|
||||
"name": "seo-search-console",
|
||||
"lines": 126,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"jamie-brand-guardian": {
|
||||
"name": "jamie-brand-guardian",
|
||||
"lines": 480,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"ourdigital-research": {
|
||||
"name": "ourdigital-research",
|
||||
"lines": 205,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"seo-technical-audit": {
|
||||
"name": "seo-technical-audit",
|
||||
"lines": 103,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"seo-schema-generator": {
|
||||
"name": "seo-schema-generator",
|
||||
"lines": 155,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"seo-local-audit": {
|
||||
"name": "seo-local-audit",
|
||||
"lines": 125,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"jamie-brand-audit": {
|
||||
"name": "jamie-brand-audit",
|
||||
"lines": 482,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"ourdigital-presentation": {
|
||||
"name": "ourdigital-presentation",
|
||||
"lines": 176,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"notion-organizer": {
|
||||
"name": "notion-organizer",
|
||||
"lines": 95,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"seo-gateway-architect": {
|
||||
"name": "seo-gateway-architect",
|
||||
"lines": 168,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"seo-core-web-vitals": {
|
||||
"name": "seo-core-web-vitals",
|
||||
"lines": 117,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"seo-gateway-builder": {
|
||||
"name": "seo-gateway-builder",
|
||||
"lines": 386,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"ourdigital-designer": {
|
||||
"name": "ourdigital-designer",
|
||||
"lines": 141,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"notion-writer": {
|
||||
"name": "notion-writer",
|
||||
"lines": 87,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"jamie-brand-editor": {
|
||||
"name": "jamie-brand-editor",
|
||||
"lines": 221,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"seo-on-page-audit": {
|
||||
"name": "seo-on-page-audit",
|
||||
"lines": 103,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"seo-schema-validator": {
|
||||
"name": "seo-schema-validator",
|
||||
"lines": 119,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"gtm-audit": {
|
||||
"name": "gtm-audit",
|
||||
"lines": 289,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"jamie-youtube-manager": {
|
||||
"name": "jamie-youtube-manager",
|
||||
"lines": 526,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": [
|
||||
"Too long: 526 lines (max 500)"
|
||||
]
|
||||
},
|
||||
"template-skill": {
|
||||
"name": "template-skill",
|
||||
"lines": 7,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"theme-factory": {
|
||||
"name": "theme-factory",
|
||||
"lines": 60,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"xlsx": {
|
||||
"name": "xlsx",
|
||||
"lines": 289,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"pdf": {
|
||||
"name": "pdf",
|
||||
"lines": 295,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"skill-creator": {
|
||||
"name": "skill-creator",
|
||||
"lines": 210,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"pptx": {
|
||||
"name": "pptx",
|
||||
"lines": 484,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"webapp-testing": {
|
||||
"name": "webapp-testing",
|
||||
"lines": 96,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"mcp-builder": {
|
||||
"name": "mcp-builder",
|
||||
"lines": 329,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
},
|
||||
"docx": {
|
||||
"name": "docx",
|
||||
"lines": 197,
|
||||
"has_frontmatter": true,
|
||||
"has_description": true,
|
||||
"issues": []
|
||||
}
|
||||
},
|
||||
"agents": {
|
||||
"data-analyst": {
|
||||
"name": "data-analyst",
|
||||
"has_frontmatter": false,
|
||||
"tools_restricted": false,
|
||||
"issues": [
|
||||
"Missing frontmatter",
|
||||
"Tools not restricted (consider limiting)"
|
||||
]
|
||||
},
|
||||
"seo-advisor": {
|
||||
"name": "seo-advisor",
|
||||
"has_frontmatter": false,
|
||||
"tools_restricted": false,
|
||||
"issues": [
|
||||
"Missing frontmatter",
|
||||
"Tools not restricted (consider limiting)"
|
||||
]
|
||||
},
|
||||
"python-coach": {
|
||||
"name": "python-coach",
|
||||
"has_frontmatter": false,
|
||||
"tools_restricted": false,
|
||||
"issues": [
|
||||
"Missing frontmatter",
|
||||
"Tools not restricted (consider limiting)"
|
||||
]
|
||||
},
|
||||
"gtm-manager": {
|
||||
"name": "gtm-manager",
|
||||
"has_frontmatter": false,
|
||||
"tools_restricted": false,
|
||||
"issues": [
|
||||
"Missing frontmatter",
|
||||
"Tools not restricted (consider limiting)"
|
||||
]
|
||||
},
|
||||
"data-engineer": {
|
||||
"name": "data-engineer",
|
||||
"has_frontmatter": false,
|
||||
"tools_restricted": false,
|
||||
"issues": [
|
||||
"Missing frontmatter",
|
||||
"Tools not restricted (consider limiting)"
|
||||
]
|
||||
}
|
||||
},
|
||||
"findings": {
|
||||
"critical": [],
|
||||
"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",
|
||||
"Agent 'gtm-manager': Tools not restricted (consider limiting)",
|
||||
"Agent 'data-engineer': Missing frontmatter",
|
||||
"Agent 'data-engineer': Tools not restricted (consider limiting)"
|
||||
],
|
||||
"passing": [
|
||||
"Command 'jamie-audit': OK",
|
||||
"Command 'seo-schema-validator': OK",
|
||||
"Command 'seo-gateway-builder': OK",
|
||||
"Command 'seo-gsc': OK",
|
||||
"Command 'gtm-manager': OK",
|
||||
"Command 'notion-organizer': OK",
|
||||
"Command 'ourdigital-designer': OK",
|
||||
"Command 'seo-on-page': OK",
|
||||
"Command 'seo-vitals': OK",
|
||||
"Command 'ourdigital-presentation': OK",
|
||||
"Command 'seo-gateway-architect': OK",
|
||||
"Command 'jamie-editor': OK",
|
||||
"Command 'gtm-audit': OK",
|
||||
"Command 'seo-technical': OK",
|
||||
"Command 'seo-schema-generator': OK",
|
||||
"Command 'seo-local': OK",
|
||||
"Command 'ourdigital-research': OK",
|
||||
"Skill 'seo-search-console': OK",
|
||||
"Skill 'jamie-brand-guardian': OK",
|
||||
"Skill 'ourdigital-research': OK",
|
||||
"Skill 'seo-technical-audit': OK",
|
||||
"Skill 'seo-schema-generator': OK",
|
||||
"Skill 'seo-local-audit': OK",
|
||||
"Skill 'jamie-brand-audit': OK",
|
||||
"Skill 'ourdigital-presentation': OK",
|
||||
"Skill 'notion-organizer': OK",
|
||||
"Skill 'seo-gateway-architect': OK",
|
||||
"Skill 'seo-core-web-vitals': OK",
|
||||
"Skill 'seo-gateway-builder': OK",
|
||||
"Skill 'ourdigital-designer': OK",
|
||||
"Skill 'notion-writer': OK",
|
||||
"Skill 'jamie-brand-editor': OK",
|
||||
"Skill 'seo-on-page-audit': OK",
|
||||
"Skill 'seo-schema-validator': OK",
|
||||
"Skill 'gtm-audit': OK",
|
||||
"Skill 'template-skill': OK",
|
||||
"Skill 'theme-factory': OK",
|
||||
"Skill 'xlsx': OK",
|
||||
"Skill 'pdf': OK",
|
||||
"Skill 'skill-creator': OK",
|
||||
"Skill 'pptx': OK",
|
||||
"Skill 'webapp-testing': OK",
|
||||
"Skill 'mcp-builder': OK",
|
||||
"Skill 'docx': OK"
|
||||
],
|
||||
"recommendations": []
|
||||
}
|
||||
},
|
||||
"total_baseline_tokens": 63238,
|
||||
"health": "Critical"
|
||||
}
|
||||
212
docs/settings-audit-report.md
Normal file
212
docs/settings-audit-report.md
Normal file
@@ -0,0 +1,212 @@
|
||||
# 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*
|
||||
Reference in New Issue
Block a user