Was macht claude-code-md-hook?
Konvertiert Datei-Lesevorgänge in Markdown und Strukturindizes für Claude Code, um den Kontextverbrauch bei großen PDFs, DOCX, XLSX, PPTX und HTML zu reduzieren.
Funktionsweise
Dieses Skill installiert einen Hook in Claude Code, der automatisch erkennt, wenn eine Datei mit einer der unterstützten Erweiterungen gelesen wird. Statt die gesamte Datei im Rohformat zu laden, wird sie in eine Markdown-Darstellung mit einem Inhaltsverzeichnis umgewandelt. Der Index enthält Abschnittsüberschriften, Seitenzahlen (bei PDFs) und andere strukturelle Metadaten, sodass Claude Code schnell auf relevante Teile zugreifen kann, ohne den gesamten Inhalt verarbeiten zu müssen.
Unterstützte Formate
| Format | Erweiterungen | Konvertierung |
|---|---|---|
.pdf | Markdown mit Seiten- und Abschnittsindex | |
| DOCX | .docx | Markdown mit Überschriftenhierarchie |
| XLSX | .xlsx | Markdown-Tabellen mit Blattindex |
| PPTX | .pptx | Markdown mit Folienübersicht |
| HTML | .html, .htm | Markdown mit Link- und Abschnittsindex |
Installation
- Fügen Sie das Skill zu Ihrem Claude Code-Projekt hinzu (z. B. über die Datei
skills.jsonoder das CLI-Tool). - Starten Sie Claude Code neu, um den Hook zu aktivieren.
- Lesen Sie eine unterstützte Datei mit dem Befehl
/readoder durch natürliche Sprachaufforderung.
Verwendung
# Beispiel: Claude Code eine PDF-Datei geben lassen
/read path/to/large-document.pdf
Claude Code gibt dann eine Zusammenfassung mit dem Strukturindex und dem Markdown-Inhalt zurück.
Konfiguration
Um das Verhalten anzupassen, können Sie Umgebungsvariablen setzen:
MD_HOOK_MAX_SIZE=5000 # Maximale Anzahl von Zeichen für den Index (Standard: 2000)
MD_HOOK_INCLUDE_RAW=false # Ob der rohe Markdown-Inhalt angehängt werden soll (Standard: true)
Lizenz
MIT