Andrew Yim
e519a49cc4
Run the additive migration pass from SKILL-MIGRATION-GUIDE: generate a root SKILL.md for every skill that lacked one, copied from its desktop/SKILL.md (or code/SKILL.md), with name set to the directory name and description + body preserved verbatim. - scripts/migrate_skill_root.py: the reusable, non-destructive migrator (dry-run default). - 61 new root SKILL.md (desktop source for most; code/SKILL.md for 61/62/92). - Untouched: 16/17/95 (already had root); desktop/ and code/ packaging left intact. - All 64 root SKILL.md validate: frontmatter <=1024, kebab name, description present. Still MANUAL (no SKILL.md source — commands/README only), need hand-authored root SKILL.md: 81-mac-optimizer, 90-reference-curator, 91-multi-agent-guide, 94-dintel-bootstrap. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Claude Settings Optimizer
Self-audit and optimize Claude configuration for maximum token efficiency.
Supports both Claude Code (CLI) and Claude Desktop (App).
Purpose
- Diagnose all Claude errors (8 categories covered)
- Analyze token usage across MCP servers, CLAUDE.md, and extensions
- Troubleshoot MCP connection issues
- Identify optimization opportunities
- Auto-fix common issues with backup safety (Code version)
- Keep working context at 70%+ of 200K limit
Platform Versions
| Version | Path | Use Case |
|---|---|---|
| Claude Code | code/ |
CLI with automated scripts |
| Claude Desktop | desktop/ |
App-based manual guidance |
Claude Code Quick Start
# Install
cd custom-skills/00-our-settings-audit/code
chmod +x install.sh
./install.sh
# Run audit
python3 scripts/run_audit.py
# Apply fixes
python3 scripts/auto_fix.py --apply
Claude Desktop Quick Start
Covers 8 error categories:
| Category | Example Errors |
|---|---|
| Context/Input | "Exceed response limit" |
| Output | "Response could not be fully generated" |
| Length/File | "Message will exceed length limit", "Files larger than 10mb" |
| Usage Limits | "5-hour limit reached", "X messages left" |
| Server/Capacity | "Unexpected capacity constraints" |
| MCP Connection | "Error connecting to [ServerName]" |
| Account | "Account has been disabled", login errors |
| Output Quality | Output cutoff, gibberish, mixed languages |
When encountering any error:
- Use the Quick Diagnosis Tree in
desktop/SKILL.md - Follow category-specific troubleshooting steps
- Apply prevention checklist recommendations
For MCP issues, share your config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
What Gets Analyzed
| Component | Checks |
|---|---|
| MCP Servers | serverInstructions presence, token estimates, load strategy |
| CLAUDE.md | Line count, token estimate, structure quality |
| Commands | Frontmatter, description, size limits |
| Skills | SKILL.md presence, size limits |
| Agents | Tool restrictions |
Target Metrics
| Metric | Target | Max |
|---|---|---|
| CLAUDE.md tokens | 2,000 | 3,000 |
| MCP tokens (with Tool Search) | 5,000 | 10,000 |
| Baseline total | <30% | <40% |
| Available for work | >70% | — |
Files
00-our-settings-audit/
├── README.md
├── code/ # Claude Code (CLI)
│ ├── CLAUDE.md # Skill directive
│ ├── install.sh # Installation script
│ ├── commands/
│ │ └── settings-audit.md # /settings-audit command
│ ├── scripts/
│ │ ├── run_audit.py # Main orchestrator
│ │ ├── analyze_tokens.py # Token analysis
│ │ ├── analyze_extensions.py
│ │ └── auto_fix.py # Auto-fix with backup
│ └── references/
│ └── token-optimization.md
│
└── desktop/ # Claude Desktop (App)
├── skill.yaml # Skill metadata
├── SKILL.md # Diagnosis workflow (8 error categories)
├── references/
│ ├── config-locations.md # Config file paths
│ ├── mcp-token-estimates.md # Token budget guide
│ └── our-settings-audit.md # Claude.ai project reference
└── examples/
└── sample-audit-report.md # Example output
Auto-Fix Capabilities
Safe (automatic with backup):
- Add serverInstructions to MCP servers
- Add frontmatter to commands
Manual review required:
- Disabling MCP servers
- Restructuring CLAUDE.md
- Removing extensions
Requirements
- Python 3.8+
- PyYAML (optional, for better frontmatter parsing)