thedoublejay

thedoublejay / please-optimize-my-claude

Public

Optimize your CLAUDE.md hierarchy — deduplicate content, detect misplacement, compress bloat, and visualize token usage across global/project/repo levels.

ai ai-tools claude claude-code skills
12
0
100% credibility
Found Apr 10, 2026 at 12 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
AI Summary

A skill for Claude Code that discovers, analyzes, and optimizes hierarchical instruction files to remove duplicates, detect issues, and reduce bloat across global, organization, and project levels.

How It Works

1
😕 Notice bloated instructions

While chatting with your AI helper in projects, you realize the instructions are getting long and repetitive, slowing things down.

2
🔍 Find the optimizer

You discover this friendly tool that cleans up and streamlines your AI instructions across all your work folders.

3
📥 Add the tool easily

With one simple action from a marketplace, you bring the optimizer into your setup.

4
Choose your fixing style
👀
Just peek

See a report of issues without changing anything.

🤔
Review step by step

Go through suggestions and pick what to fix.

⚡
Auto magic

Let it fix everything automatically after a safety backup.

5
📊 See the colorful insights

Get a beautiful visual map of duplicates, waste, and smart suggestions, like a before-and-after savings chart.

6
✅ Apply the fixes

Follow the guide or let it handle the cleanup, with everything safely backed up.

🎉 Enjoy lean AI help

Your AI assistant now loads faster with cleaner instructions, saving time and effort every chat.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 12 to 12 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is please-optimize-my-claude?

This CLI skill scans your CLAUDE.md hierarchy across global, project, and repo levels, deduplicating content, detecting misplacements, compressing bloat, and visualizing token usage so Claude loads leaner instructions on every request. It tackles the hidden cost of bloated files—like org-specific rules polluting your global CLAUDE.md or duplicates tripling token spend. Run `/please-optimize-my-claude analyze` for reports, `auto` to apply fixes, or interactive mode to review changes.

Why is it gaining traction?

Unlike generic optimizers like scikit-optimize or scipy-optimize on GitHub, it targets CLAUDE.md files specifically, with "What Claude Sees" token simulators, security scans for leaked keys, and contradiction detection across the hierarchy. Developers hook on the Unicode bar charts showing before/after savings—up to 45% token cuts—and modes like migration for splitting monoliths. Backup/restore keeps it safe, no lock-in.

Who should use this?

Claude Code users with multi-org setups, where global CLAUDE.md drags personal and work projects alike. Monorepo maintainers fighting stale rules via git blame checks, or teams optimizing CLAUDE.md files before every session to stay under token budgets. Ideal if you're scaling from one file to full hierarchies.

Verdict

With 11 stars and 1.0% credibility, it's immature but boasts strong docs, CI badges, and edge-case handling—test in analyze mode first. Worth it for Claude heavyweights optimizing claude.md bloat; skip if you're not deep in the ecosystem.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.