xls-skill

Excel-Arbeitsmappen (.xlsx/.xlsm/.xls) in KI-lesbares Markdown konvertieren – inklusive aller Bilder, die genau dort bleiben, wo sie hingehören: auch Bilder, die IN Zellen eingebettet sind (WPS Office =DISPIMG und Microsoft 365 „Place in Cell“), die normale Excel-Reader übersehen – plus schwebende Bilder, Textfelder, Formeln, verborgene Struktur und OCR. Ideal zum Lesen, Konvertieren, Prüfen oder Beantworten von Fragen zu Tabellen mit Fotos, Etiketten, Logos, Screenshots, Zeichnungen oder Signaturen.

Was ist xls-skill?

Dieses Skill (xls-skill) ist ein Werkzeug, das Excel-Arbeitsmappen (.xlsx/.xlsm/.xls) in vollständiges Markdown konvertiert – und dabei alle Bilder, selbst eingebettete, in ihren Zellen platziert. Normale Excel-Reader wie openpyxl oder pandas ignorieren zwei wichtige Bildarten: In-Zell-Bilder (über WPS Offices `=DISPIMG` oder Microsoft 365 'Place in Cell') und schwebende Bilder/Formen über dem Raster. Das Skill extrahiert alle Bilder, speichert sie als Dateien und schreibt sie als Markdown-Bilder in die entsprechende Zelle der Markdown-Tabelle zurück. Es unterstützt die Arbeit mit dem Agenten durch eine Vielzahl von Ausgabedateien: eine Haupt-Markdown-Datei, eine Bilder-Markdown-Datei, einen Bilder-Ordner, CSV-Manifeste für Bilder, Formeln und Formen sowie einen detaillierten Umwandlungsbericht. Der Agent muss nach der Konvertierung den Bericht prüfen, gegebenenfalls Bilder betrachten, etwaige OCR-Hinweise nutzen und Lücken ehrlich melden. Das Skill erkennt Einschränkungen (z.B. keine extrahierten Bilder in Kopf-/Fußzeilen) und weist auf Bedingungen hin, die Überprüfungen erfordern (z.B. Excel-Installation für .xls). Es ist ideal für alle Szenarien, in denen Tabellen mit visuellen Inhalten wie Fotos, Logos, Unterschriften oder Diagrammen analysiert werden müssen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hougw/xls-skill/tree/HEAD

Installed? Explore more Produktivität & Zusammenarbeit skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Vorschau

Aus dem Skill-README

Parts!B2

Dokumentation

xls-skill: Excel -> Markdown, Bilder in ihren Zellen behalten

Warum dieses Skill existiert

Die meisten Excel-Reader (openpyxl, pandas, CSV-Export) sehen nur Zellwerte. Zwei Arten von Bildern gehen verloren:

  1. In-Zell-Bilder. Das Bild ist der Inhalt einer Zelle.
    • WPS Office „in Zelle einbetten“: Die Zelle zeigt nur =DISPIMG("ID_...",1); das Bild befindet sich in xl/cellimages.xml.
    • Microsoft 365 „Place in Cell“ / IMAGE: Die Zelle zeigt #WERT!; das Bild wird über xl/metadata.xml und xl/richData/ erreicht.
  2. Schwebende Bilder und Textfelder, die über dem Raster gezeichnet sind (Prozessfotos, Etiketten, Formularnummern).

Dieses Skill extrahiert alle, speichert jedes Bild als Datei und schreibt es in die Markdown-Tabelle an die Zelle, in der es sich befindet, sodass ein Leser die Tabelle und ihre Bilder zusammen sieht:

| # | A | B | C | D |
|---|---|---|---|---|
| 2 | Bracket | ![Parts!B2](images/01_Parts_B2_cell1.png) | Bracket \| In-Zell-Bild | 4 |

Ausführung

python <skill-verzeichnis>/scripts/xlsx_to_md.py <datei-oder-ordner> [...] -o <ausgabe-verzeichnis> [--ocr auto|off] [--ocr-lang eng+chi_sim]
  • Akzeptiert .xlsx, .xlsm, .xls oder Ordner (rekursiv). Gibt eine Zeile pro Arbeitsmappe mit Bildanzahlen aus.
  • Benötigt Python 3.9+ und openpyxl. Optional: Pillow (Bildgrößen), Tesseract OCR (Text in Bildern), Microsoft Excel oder LibreOffice (zum Öffnen von .xls).
  • Selbsttest: python <skill-verzeichnis>/tests/run_tests.py erstellt synthetische WPS- und Microsoft-365-Arbeitsmappen und prüft, ob jedes Bild in seiner Zelle landet.

Was Sie pro Arbeitsmappe erhalten (<ausgabe-verzeichnis>/<name>/)

DateiInhalt
<name>.mdArbeitsmappenindex, dann jedes Blatt als vollständige Markdown-Tabelle (ohne Kürzung) mit Bildern inline in ihren Zellen; Blattangaben (ausgeblendeter Zustand, zusammengeführte Bereiche, ausgeblendete Zeilen/Spalten, Kommentare, Textfelder, Diagrammanzahl) oberhalb jeder Tabelle
<name>.images.mdEin Eintrag pro Bild: das Bild, Blatt!Zelle, Art, Größe, umgebender Zellentext, OCR-Text und ein Platzhalter für die Beschreibung
images/Jedes Bild als Datei, benannt `_<zelle
sheets_csv/Blattwerte; Bildzellen enthalten [image: images/...]
image_manifest.csvBlatt, Zelle, Art (in-cell (WPS DISPIMG) / in-cell (Microsoft 365) / floating), Datei, Paketkomponente, Alternativtext, Größe, OCR, umgebender Text
formula_manifest.csvFormeltext und zwischengespeicherter Wert pro Zelle
shapes_manifest.csvText aus schwebenden Textfeldern/Formen mit Ankerzelle
conversion_report.jsonAnzahl, Warnungen, review_required

Arbeitsablauf für den Agenten

  1. Konvertieren. Führen Sie das Skript mit der/den Arbeitsmappe(n) aus.
  2. Zuerst den Bericht lesen. Öffnen Sie conversion_report.json. Handeln Sie jede Warnung:
    • image not found in package -> Die Zelle ist als [image missing: ID] markiert; sagen Sie dies, raten Sie nicht das Bild.
    • .emf/.wmf saved as-is -> Konvertieren Sie zu PNG (z. B. Pillow unter Windows, LibreOffice anderswo), bevor Sie es ansehen.
    • charts > 0 -> Diagramme werden gezählt, nicht dargestellt; öffnen oder exportieren Sie das Blatt, wenn das Diagramm wichtig ist.
    • OCR übersprungen oder eine Sprache fehlt -> Verlassen Sie sich darauf, die Bilder selbst anzusehen.
  3. Die Bilder ansehen. Öffnen Sie jede in <name>.images.md aufgeführte Datei und ersetzen Sie jeden description-Platzhalter mit dem, was das Bild zeigt: Objekt, lesbarer Text (Etiketten, Modellnummern, Markierungen), Symbole und wie es mit den benachbarten Zellen zusammenhängt. OCR ist ein Hinweis, nicht die Antwort; kleiner Etiketten-Text erfordert oft einen Ausschnitt oder Zoom.
  4. Aus Tabelle und Bildern gemeinsam antworten. Verwenden Sie die Markdown-Tabelle für genaue Zellwerte, Formeln und Struktur; verwenden Sie die Bilder für „Wie sieht es aus / was steht auf dem Teil?“. Zitieren Sie Blatt!Zelle für beides.
  5. Lücken ehrlich melden. Wenn in Schritt 2 etwas ungelöst blieb, markieren Sie die Arbeitsmappe als überprüfungsbedürftig.

Regeln

  • Eine CSV- oder reine Wertetabelle ist kein vollständiger Beleg, wenn die Arbeitsmappe Bilder, Textfelder, Farben oder versteckte Inhalte hat. Prüfen Sie die Blattangaben und Manifeste.
  • Ordnen Sie jedes Bild seiner Zelle und den Nachbarn zu; verlassen Sie sich niemals nur auf die Bildreihenfolge.
  • Wichtiger Text kann außerhalb von Zellen stehen: Textfelder (Formularnummern, Revisionsmarkierungen), Kommentare, Kopf-/Fußzeilen. Textfelder und Kommentare werden extrahiert; Kopf-/Fußzeilen nicht – prüfen Sie diese in Excel, wenn eine Dokumentnummer fehlt.
  • Farbe kann Daten sein (Bestanden/Nicht bestanden, Risikostufe, Status). Dieses Skript dekodiert keine Füllungen oder bedingte Formatierung; wenn Farben eine Bedeutung haben, prüfen Sie sie mit openpyxl oder einem Seitenexport und geben Sie die Zuordnung an.
  • Zusammengeführte Bereiche behalten ihren Wert nur in der oberen linken Zelle; lesen Sie die Zeile merged:, bevor Sie leere Zellen interpretieren.
  • Ausgeblendete Blätter, Zeilen und Spalten werden konvertiert und aufgelistet, nicht verworfen. Sagen Sie, wenn eine Antwort aus versteckten Inhalten stammt.
  • Vertrauen Sie nicht auf mojibake-Pfade in einem Terminal; überprüfen Sie den tatsächlichen Pfad, bevor Sie eine Datei als fehlend melden.

Einschränkungen

  • Schwebende Bilder werden in ihrer linken oberen Ankerzelle verlinkt; ein Bild, das sich über viele Zellen erstreckt, wird mit seiner to_cell im Manifest aufgeführt.
  • Gruppierte Formen werden gelesen, aber Pfeile und Sprechblasen, die als separate Formen gezeichnet sind, behalten ihre Beziehung zu einem Foto nur in einer Seitenwiedergabe. Wenn das Layout wichtig ist („Welcher Pfeil zeigt wohin?“), exportieren Sie das Blatt mit Excel oder LibreOffice als PDF/PNG und betrachten Sie es zusammen mit dem Markdown.
  • Bilder in Kopf-/Fußzeilen (VML) und in Kommentaren werden nicht extrahiert.
  • .xls benötigt Microsoft Excel (Windows, pywin32) oder LibreOffice zur Konvertierung; ohne diese werden nur Zellwerte gelesen und der Bericht sagt dies.

Verwandte Skills