Files

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

2026-02-03 16:48:06 +07:00

3.2 KiB

Raw Blame History

Claude Code Settings Optimizer

Self-audit and optimize Claude Code configuration for maximum token efficiency and performance.

Core Focus

Token Budget Management - Keep baseline under 30% of 200K context
MCP Tool Loading Strategy - Essential tools always, others lazy-loaded
CLAUDE.md Optimization - Concise, structured, under 200 lines
Context Preservation - Maintain original prompt context throughout session

Quick Commands

# Run full audit
python3 scripts/run_audit.py

# Check token usage only
python3 scripts/analyze_tokens.py

# Auto-fix with preview
python3 scripts/auto_fix.py

# Apply fixes
python3 scripts/auto_fix.py --apply

Audit Scope

1. Token Usage Analysis

Component	Target	Max	Action if Exceeded
CLAUDE.md	2,000	3,000	Compress/split
MCP Servers	5,000	10,000	Enable Tool Search, add serverInstructions
Skills metadata	500	1,000	Reduce descriptions
Working space	>140,000	—	Goal: 70%+ available

2. MCP Server Strategy

Load Strategy Classification:

Strategy	Criteria	Action
`always`	Essential for daily work (Playwright, Notion)	Keep loaded
`lazy`	Occasionally needed (GitHub, Slack)	Load on demand
`disable`	Rarely used or token-heavy (Zapier 50+ tools)	Turn off

Critical Check: Every MCP server MUST have serverInstructions for Tool Search to work efficiently.

3. CLAUDE.md Health

Check for:

Line count (warn >200)
Token estimate (warn >3,000)
Structure quality (headers, lists vs wall of text)
Redundant information
Information Claude already knows (don't repeat)

4. Extension Efficiency

Commands: Has frontmatter? Under 100 lines?
Skills: SKILL.md present? Under 500 lines?
Agents: Tools restricted appropriately?

Output Report

# Claude Code Settings Audit

## Token Budget
- Baseline usage: X / 200,000 (Y%)
- Available for work: Z tokens

## Health Status
- Overall: [Good/Needs Attention/Critical]
- MCP Servers: X configured, Y missing instructions
- CLAUDE.md: X lines, ~Y tokens

## Findings
### Critical (must fix)
### Warnings (should fix)
### Passing (good)

## Recommendations
[Prioritized action items]

Auto-Fix Capabilities

Safe fixes applied automatically (with backup):

Add serverInstructions to MCP servers
Add frontmatter to commands missing it
Suggest CLAUDE.md compression

Manual review required:

Disabling MCP servers
Restructuring CLAUDE.md content
Removing unused extensions

Best Practices

Token Optimization Principles

CLAUDE.md: Only include what Claude doesn't already know
MCP Servers: Use serverInstructions for Tool Search discovery
Skills: Keep SKILL.md brief, details in references/
Context: Run /compact at 70% usage, /clear between unrelated tasks

Ideal Configuration

Context Budget: 200,000 tokens
├── System prompt: ~5,000 (fixed)
├── CLAUDE.md: ~2,000 (your control)
├── MCP tools: ~5,000 (with Tool Search)
├── Skills: ~500 (metadata only)
└── Available: ~187,500 (93.75%)

3.2 KiB Raw Blame History