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

2.8 KiB

Raw Blame History

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:

# 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

# 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:

Add serverInstructions to MCP servers missing them
Add frontmatter to commands missing it
Create backup before any changes

Execution

Run token budget analysis first
Analyze each component
Generate prioritized report
Offer auto-fix if issues found
Save report to ./settings-audit-report.md

2.8 KiB Raw Blame History