folder-analyzer-optimizerlisted
Install: claude install-skill yannick-bottino/consulting-claude-skills
# Folder Analyzer & Optimizer
Skill generique de conversion documentaire. Transforme n'importe quel dossier de documents en **knowledge base LLM-navigable** : miroir Markdown individuel par document + index hierarchiques par dossier (LLM Wiki pattern, Karpathy).
Fonctionne pour tout domaine : ESG/B Corp, legal, M&A, audit, RH, due diligence, etc.
Pipeline hybride PyMuPDF/python-docx/pptx valide en production : 85-95% de reduction de tokens vs Read-tool-only.
## Principe LLM Wiki (Karpathy)
Trois couches :
1. **Sources brutes** — documents originaux, jamais modifies
2. **Wiki** — pages Markdown individuelles (document.md) + index de dossier (_index.md)
3. **Schema** — CLAUDE.md du projet, configure les mappings metier
Navigation : lire `_index.md` racine → aller au sous-dossier pertinent → lire le document cible.
**Tous les fichiers sont visibles dans les index**, meme ceux non parsables (images, .doc legacy) : rien n'est invisible dans la knowledge base.
### Navigation intra-document via arbre
Pour les documents longs (≥ 50 pages) avec une structure exploitable (TOC native ou headings clairs), un **arbre JSON sidecar** est généré à côté du `.md` : `document.tree.json`. Cet arbre, inspiré de PageIndex (Vectify AI) mais porté en zero-token, contient les sections du document avec leurs plages de pages et un aperçu de 300 caractères par nœud.
L'agent navigue ainsi :
1. `_parsed/_index.md` racine → choisit le dossier
2. `_parsed/dossier/_index.md` → voit la section "Docum