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
2026-02-03 16:48:06 +07:00
committed by GitHub
parent 0bc24d00b9
commit b6a478e1df
72 changed files with 4770 additions and 803 deletions

View 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"
}

View 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*