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.9 KiB

Raw Blame History

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)

3.9 KiB Raw Blame History