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>
This commit is contained in:
Andrew Yim
2026-02-03 16:48:06 +07:00
committed by GitHub
parent 0bc24d00b9
commit b6a478e1df
72 changed files with 4770 additions and 803 deletions

View File

@@ -0,0 +1,119 @@
---
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`