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:
Andrew Yim
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