b6a478e1df
## 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>
120 lines
2.8 KiB
Markdown
120 lines
2.8 KiB
Markdown
---
|
|
description: Audit Claude Code settings for token efficiency. Analyzes MCP servers, CLAUDE.md, extensions and provides optimization recommendations.
|
|
argument-hint: [--fix] [--tokens-only]
|
|
allowed-tools: Read, Glob, Grep, Bash, Write
|
|
---
|
|
|
|
# Claude Code Settings Audit
|
|
|
|
Audit your Claude Code configuration to optimize token usage and performance.
|
|
|
|
## Arguments
|
|
- `--fix`: Apply safe fixes automatically (with backup)
|
|
- `--tokens-only`: Quick token budget check only
|
|
|
|
## Audit Process
|
|
|
|
### 1. Token Budget Check
|
|
|
|
Calculate current baseline token usage:
|
|
|
|
```bash
|
|
# Quick estimation
|
|
echo "=== Token Budget Estimation ==="
|
|
```
|
|
|
|
**Targets:**
|
|
- CLAUDE.md: <3,000 tokens (~200 lines)
|
|
- MCP with Tool Search: <10,000 tokens
|
|
- Working space: >70% of 200K context
|
|
|
|
### 2. MCP Server Analysis
|
|
|
|
Check locations:
|
|
- `~/.claude/settings.json`
|
|
- `./.claude/settings.json`
|
|
|
|
For each server, evaluate:
|
|
- [ ] Has `serverInstructions` (CRITICAL for Tool Search)
|
|
- [ ] Appropriate load strategy (always/lazy/disable)
|
|
- [ ] Token impact estimation
|
|
|
|
**Server Token Estimates:**
|
|
| Server | Tokens | Strategy |
|
|
|--------|--------|----------|
|
|
| Playwright | ~13,500 | always |
|
|
| Notion | ~5,000 | always |
|
|
| GitHub | ~18,000 | lazy |
|
|
| PostgreSQL | ~8,000 | lazy |
|
|
| Zapier | ~25,000+ | disable |
|
|
|
|
### 3. CLAUDE.md Analysis
|
|
|
|
Check:
|
|
- `~/.claude/CLAUDE.md` (global)
|
|
- `./CLAUDE.md` (project)
|
|
|
|
Evaluate:
|
|
- [ ] Line count (critical if >200)
|
|
- [ ] Token estimate (critical if >3,000)
|
|
- [ ] Good structure (headers, lists, not wall of text)
|
|
- [ ] No redundant information
|
|
- [ ] No information Claude already knows
|
|
|
|
### 4. Extensions Analysis
|
|
|
|
**Commands** (`~/.claude/commands/`):
|
|
- Has YAML frontmatter with description?
|
|
- Under 100 lines?
|
|
|
|
**Skills** (`~/.claude/skills/`):
|
|
- Has SKILL.md?
|
|
- Under 500 lines?
|
|
|
|
**Agents** (`~/.claude/agents/`):
|
|
- Tools appropriately restricted?
|
|
|
|
## Output Format
|
|
|
|
```markdown
|
|
# Settings Audit Report
|
|
Generated: [timestamp]
|
|
|
|
## Token Budget Summary
|
|
| Component | Tokens | % of 200K | Status |
|
|
|-----------|--------|-----------|--------|
|
|
| CLAUDE.md | X | Y% | OK/WARN/CRITICAL |
|
|
| MCP Servers | X | Y% | OK/WARN/CRITICAL |
|
|
| Extensions | X | Y% | OK/WARN/CRITICAL |
|
|
| **Baseline** | **X** | **Y%** | — |
|
|
| **Available** | **X** | **Y%** | — |
|
|
|
|
## Critical Issues
|
|
[Must fix immediately]
|
|
|
|
## Warnings
|
|
[Should address soon]
|
|
|
|
## Recommendations
|
|
1. [Prioritized action]
|
|
2. [...]
|
|
|
|
## Auto-Fix Available
|
|
[List of safe fixes that can be applied with --fix]
|
|
```
|
|
|
|
## Quick Fixes
|
|
|
|
If `--fix` is provided:
|
|
1. Add `serverInstructions` to MCP servers missing them
|
|
2. Add frontmatter to commands missing it
|
|
3. Create backup before any changes
|
|
|
|
## Execution
|
|
|
|
1. Run token budget analysis first
|
|
2. Analyze each component
|
|
3. Generate prioritized report
|
|
4. Offer auto-fix if issues found
|
|
5. Save report to `./settings-audit-report.md`
|