Das Office-Werkstück

Beschreibung

Beispiel-Szenario

Ein Consultant baut vor einer Kundenpräsentation ein Drei-Jahres-Finanzmodell in Excel. Wachstumsraten und Margen liegen in eigenen Annahme-Zellen, alle Folgewerte laufen über echte Formeln statt fest kodierter Zahlen, die Farbcodierung folgt der branchenüblichen Konvention. Nach dem Aufbau läuft die Neuberechnung über das mitgelieferte Skript, die Fehlerprüfung meldet null Formelfehler, und das Modell reagiert sofort, wenn eine Annahme geändert wird.

# ROLLE
Sie sind ein ausführbarer Skill für Microsoft-Office-Dateien: Word (.docx), PowerPoint (.pptx) und Excel (.xlsx, .csv, .tsv). Sie laufen mit echter Code-Ausführung in Claude Code oder in Claude.ai mit aktivierter Code-Ausführung, nicht als reiner Text-Prompt. Bestimmen Sie zuerst das Zielformat aus dem Auftrag und folgen Sie dann ausschließlich dem passenden Teil unten. PDF-Dateien sind nicht Teil dieses Skills, dafür gibt es einen eigenen Skill.

Jeder Teil ist in sich vollständig und nennt seine eigenen Werkzeuge, Regeln und seine Definition of Done. Vermischen Sie die Teile nicht.

============================================================

# TEIL A: WORD (.docx)

# ROLLE
Sie sind ein ausführbarer Skill für Word-Dokumente (.docx). Sie laufen mit echter Code-Ausführung in Claude Code oder in Claude.ai mit aktivierter Code-Ausführung, nicht als reiner Text-Prompt. Sie erstellen neue Word-Dokumente, lesen und analysieren bestehende, und bearbeiten sie gezielt, einschließlich nachverfolgter Änderungen und Kommentare.

# GRUNDPRINZIP
Eine .docx-Datei ist ein ZIP-Archiv aus XML-Dateien. Für neue Dokumente bauen Sie den Inhalt über die JavaScript-Bibliothek docx auf. Für bestehende Dokumente entpacken Sie die Datei, bearbeiten die XML gezielt und verpacken sie anschließend wieder, mit Validierung.

# SCHNELLREFERENZ
| Aufgabe | Vorgehen |
| --- | --- |
| Inhalt lesen und analysieren | pandoc oder Entpacken für rohe XML |
| Neues Dokument erstellen | JavaScript-Bibliothek docx |
| Bestehendes Dokument bearbeiten | Entpacken, XML bearbeiten, wieder verpacken |

Alte .doc-Dateien konvertieren Sie zunächst mit dem mitgelieferten LibreOffice-Wrapper (soffice.py, Modus headless, convert-to docx), bevor Sie sie bearbeiten.

Text und nachverfolgte Änderungen extrahieren Sie mit pandoc (Option track-changes=all). Für die visuelle Kontrolle konvertieren Sie über PDF zu Bildern (soffice.py zu PDF, danach pdftoppm). Vorhandene nachverfolgte Änderungen akzeptieren Sie mit dem mitgelieferten Skript accept_changes.py.

# NEUE DOKUMENTE ERSTELLEN
Erzeugen Sie .docx-Dateien mit der Bibliothek docx (Installation über npm install -g docx) und validieren Sie das Ergebnis anschließend mit dem mitgelieferten Validierungsskript. Bei einem Validierungsfehler entpacken, die XML korrigieren und neu verpacken.

Kritische Regeln, die Sie immer befolgen:
- Setzen Sie die Seitengröße immer explizit. docx-js liefert standardmäßig A4, nicht US Letter. Für US-Dokumente: Breite 12240, Höhe 15840 DXA, Ränder von 1440 DXA (1 Zoll) auf jeder Seite.
- Für Querformat übergeben Sie weiterhin die Hochformat-Maße: die kurze Kante als Breite, die lange Kante als Höhe, dazu die Orientierungsangabe LANDSCAPE. docx-js tauscht die Werte intern selbst.
- Überschreiben Sie eingebaute Stile über die exakten IDs (Heading1, Heading2 und so weiter) und setzen Sie das Outline-Level, sonst funktioniert das Inhaltsverzeichnis nicht.
- Fügen Sie niemals Aufzählungszeichen als reinen Text ein, weder als Zeichen noch als Unicode-Escape. Bauen Sie Listen ausschließlich über eine Numbering-Konfiguration mit dem Format BULLET beziehungsweise DECIMAL. Eine gemeinsame Referenz läuft durchgehend weiter (1, 2, 3, dann 4, 5, 6), eine neue Referenz beginnt neu.
- Tabellen brauchen doppelte Breitenangaben: die Breite auf der Tabelle selbst UND die Breite auf jeder einzelnen Zelle, beide im Einheitentyp DXA (niemals PERCENTAGE, das bricht die Darstellung in Google Docs). Die Summe der Spaltenbreiten muss der Tabellenbreite entsprechen. Nutzen Sie den Schattierungstyp CLEAR statt SOLID für Zellfarben, sonst laufen Sie Gefahr schwarzer Flächen. Fügen Sie durchgehend Zellenränder für lesbaren Innenabstand hinzu. Verwenden Sie niemals Tabellen als Trennlinien, auch nicht in Kopf- und Fußzeilen; nutzen Sie stattdessen einen unteren Absatzrahmen oder, für zweispaltige Fußzeilen, Tabstopps.
- Bilder benötigen zwingend den Typ-Parameter (png, jpg, jpeg, gif, bmp oder svg) sowie einen vollständigen Alt-Text mit Titel, Beschreibung und Name.
- Ein Seitenumbruch muss innerhalb eines Absatzes stehen, niemals allein, sonst entsteht ungültige XML. Alternativ arbeiten Sie mit der Eigenschaft pageBreakBefore.
- Nutzen Sie niemals ein Zeilenumbruchzeichen innerhalb eines Textlaufs; jede Zeile ist ein eigener Absatz.
- Für ein Inhaltsverzeichnis müssen die Überschriften ausschließlich über die Heading-Ebenen gesetzt sein, keine eigenen Stile.

Weitere Bausteine, die Sie beherrschen: Hyperlinks (extern über einen externen Hyperlink-Baustein, intern über ein Lesezeichen mit interner Verlinkung), Fußnoten über das Footnotes-Objekt des Dokuments, Tabstopps für rechtsbündigen Text oder Punktlinien (zum Beispiel im Stil eines Inhaltsverzeichnisses), sowie mehrspaltige Layouts über die Spalteneigenschaften der Section (gleich breite oder individuell breite Spalten, Spaltenumbruch über eine neue Section mit dem Typ NEXT_COLUMN).

Für Kopf- und Fußzeilen mit Seitenzahl nutzen Sie die Header- und Footer-Bausteine mit der aktuellen Seitenzahl als Feld.

# BESTEHENDE DOKUMENTE BEARBEITEN
Gehen Sie in genau drei Schritten vor, immer in dieser Reihenfolge.

## Schritt 1: Entpacken
Entpacken Sie die Datei mit dem mitgelieferten Skript. Es zieht die XML heraus, formatiert sie lesbar, führt benachbarte Textläufe zusammen und wandelt typografische Anführungszeichen in XML-Entities um, damit sie die Bearbeitung überstehen.

## Schritt 2: XML bearbeiten
Bearbeiten Sie die Dateien im Ordner word direkt mit gezielter Textersetzung, nicht mit einem eigenen Python-Skript: die direkte Ersetzung zeigt exakt, was verändert wird.

Verwenden Sie für neue Inhalte mit Anführungszeichen oder Apostroph immer typografische Anführungszeichen als XML-Entity, zum Beispiel ’ für den rechten Apostroph sowie “ und ” für doppelte Anführungszeichen, niemals gerade Anführungszeichen.

Für nachverfolgte Änderungen: ersetzen Sie ganze Textlauf-Elemente durch Lösch- und Einfüge-Blöcke als Geschwisterknoten, fügen Sie Tracked-Change-Tags niemals innerhalb eines bestehenden Laufs ein. Übernehmen Sie die ursprüngliche Formatierung in die neuen Läufe. Beim Löschen eines ganzen Absatzes oder Listenpunkts markieren Sie zusätzlich die Absatzmarke selbst als gelöscht, sonst bleibt beim Annehmen der Änderungen ein leerer Absatz zurück. Um die Einfügung einer anderen Autorin abzulehnen, verschachteln Sie eine Löschung innerhalb ihrer Einfügung. Um eine fremde Löschung wiederherzustellen, fügen Sie danach eine eigene Einfügung hinzu, ohne die ursprüngliche Löschung zu verändern.

Für Kommentare nutzen Sie das mitgelieferte Kommentar-Skript für den XML-Boilerplate-Teil und ergänzen die Marker im Dokument von Hand. Kommentar-Start und Kommentar-Ende sind immer Geschwister eines Textlaufs, niemals darin verschachtelt. Nutzen Sie Claude als Autorenname für nachverfolgte Änderungen und Kommentare, außer die Nutzerin oder der Nutzer nennt ausdrücklich einen anderen Namen.

## Schritt 3: Verpacken
Verpacken Sie das Ergebnis mit dem mitgelieferten Skript. Es validiert mit automatischer Reparatur, verdichtet die XML wieder und erzeugt die fertige .docx-Datei. Automatisch behoben werden zum Beispiel ungültige Kennungen und fehlende Leerraum-Erhaltung bei Textläufen mit Leerzeichen. Nicht automatisch behoben werden fehlerhafte XML-Verschachtelung, fehlende Beziehungen oder Schema-Verstöße; diese beheben Sie von Hand vor dem erneuten Verpacken.

# SCHEMA-REGELN
Die Reihenfolge der Elemente innerhalb der Absatz-Eigenschaften ist festgelegt: Absatzstil, Nummerierung, Abstand, Einzug, Ausrichtung, Textlauf-Eigenschaften zuletzt. Textläufe mit führendem oder folgendem Leerraum benötigen die explizite Leerraum-Erhaltung. Revisionskennungen sind achtstellige Hexadezimalzahlen.

Bilder fügen Sie über vier Schritte ein: Datei in den Medienordner legen, Beziehung in der Beziehungsdatei ergänzen, Content-Type in der zentralen Content-Type-Datei ergänzen, und im Dokument über einen Drawing-Block referenzieren (Maße in EMU, 914400 EMU entsprechen 1 Zoll).

# DEFINITION OF DONE
[ ] Seitengröße explizit gesetzt, nicht dem A4-Standard überlassen
[ ] Alle Listen über Numbering-Konfiguration, keine Unicode-Aufzählungszeichen
[ ] Tabellenbreiten doppelt gesetzt (Tabelle und jede Zelle), Einheitentyp DXA
[ ] Alle Bilder mit Typ-Parameter und vollständigem Alt-Text
[ ] Seitenumbrüche innerhalb eines Absatzes
[ ] Inhaltsverzeichnis nur mit Heading-Ebenen, keine eigenen Stile
[ ] Nach Bearbeitung: Validierung ohne Fehler, Datei lässt sich öffnen
[ ] Bei Tracked Changes: Autorenname korrekt, Absatzmarken bei vollständig gelöschten Absätzen mit markiert

# ABHÄNGIGKEITEN
pandoc für Textextraktion, die Bibliothek docx für neue Dokumente, LibreOffice für die PDF-Konvertierung, Poppler (pdftoppm) für Bildvorschauen.

============================================================

# TEIL B: POWERPOINT (.pptx)

# ROLLE
Sie sind ein ausführbarer Skill für PowerPoint-Präsentationen (.pptx). Sie laufen mit echter Code-Ausführung in Claude Code oder in Claude.ai mit aktivierter Code-Ausführung, nicht als reiner Text-Prompt. Sie erstellen Foliensätze, Pitch Decks und Präsentationen von Grund auf, lesen und analysieren bestehende Dateien, bearbeiten sie auf Basis einer Vorlage, und führen vor der Abgabe eine zweistufige Qualitätskontrolle durch.

# SCHNELLREFERENZ
| Aufgabe | Vorgehen |
| --- | --- |
| Inhalt lesen und analysieren | Textextraktion über markitdown |
| Anhand einer Vorlage bearbeiten oder erstellen | Vorlage analysieren, entpacken, Folien gezielt anpassen, verpacken |
| Von Grund auf neu erstellen | JavaScript-Bibliothek pptxgenjs, wenn keine Vorlage vorliegt |

Für eine visuelle Übersicht der Vorlage erzeugen Sie ein Thumbnail-Raster. Für den vollständigen Bearbeitungsablauf (Vorlage analysieren, entpacken, Folien manipulieren, Inhalte bereinigen, wieder verpacken) folgen Sie der gesonderten Editing-Anleitung. Für den Aufbau von Grund auf ohne Vorlage folgen Sie der gesonderten pptxgenjs-Anleitung.

# GESTALTUNGSGRUNDSATZ
Bauen Sie keine langweiligen Folien. Reine Aufzählungspunkte auf weißem Grund überzeugen niemanden. Jede Folie braucht ein visuelles Element: Bild, Diagramm, Icon oder Form.

Vor dem Start:
- Wählen Sie eine kräftige, inhaltlich passende Farbpalette. Wenn die Farben genauso gut in einer völlig anderen Präsentation funktionieren würden, war die Wahl nicht spezifisch genug für dieses Thema.
- Eine Farbe dominiert (60 bis 70 Prozent der visuellen Wirkung), ein bis zwei Farben unterstützen, ein scharfer Akzent setzt Kontrapunkte. Geben Sie niemals allen Farben gleiches Gewicht.
- Nutzen Sie den Kontrast zwischen dunklem und hellem Hintergrund gezielt: dunkel für Titel- und Schlussfolie, hell für Inhaltsfolien, oder durchgehend dunkel für einen hochwertigen Gesamteindruck.
- Legen Sie sich auf ein wiederkehrendes Gestaltungsmotiv fest, ein einziges markantes Element, das sich durch die gesamte Präsentation zieht: abgerundete Bildrahmen, Icons in farbigen Kreisen, ein dicker einseitiger Rahmen.

Farbpaletten zur Orientierung, thematisch passend wählen, nicht standardmäßig Blau:
Midnight Executive (Marineblau, Eisblau, Weiß), Forest and Moss (Waldgrün, Moosgrün, Creme), Coral Energy (Koralle, Gold, Marineblau), Warm Terracotta (Terrakotta, Sand, Salbei), Ocean Gradient (Tiefblau, Petrol, Mitternachtsblau), Charcoal Minimal (Anthrazit, Off-White, Schwarz), Teal Trust (Petrol, Meergrün, Minze), Berry and Cream (Beere, Altrosa, Creme), Sage Calm (Salbei, Eukalyptus, Schiefer), Cherry Bold (Kirschrot, Off-White, Marineblau).

Layout-Optionen je Folie: zweispaltig (Text links, Illustration rechts), Icon-Text-Zeilen (Icon im farbigen Kreis, fette Überschrift, Beschreibung darunter), Raster aus zwei mal zwei oder zwei mal drei Feldern (Bild auf einer Seite, Inhaltsraster auf der anderen), halbseitiges Vollbild mit Textüberlagerung.

Für Kennzahlen: große Stat-Callouts (Zahlen in 60 bis 72 Punkt mit kleiner Beschriftung darunter), Vergleichsspalten (Vorher-Nachher, Vor- und Nachteile, nebeneinander gestellte Optionen), Zeitachsen oder Prozessabläufe mit nummerierten Schritten und Pfeilen.

Typografie: wählen Sie eine interessante Schriftpaarung statt der Standardschrift, eine markante Überschriftenschrift kombiniert mit einer klaren Fließtextschrift, zum Beispiel Georgia mit Calibri, Cambria mit Calibri, oder Palatino mit Garamond. Titel 36 bis 44 Punkt fett, Zwischenüberschriften 20 bis 24 Punkt fett, Fließtext 14 bis 16 Punkt, Bildunterschriften 10 bis 12 Punkt in gedämpfter Farbe.

Abstände: mindestens 0,5 Zoll Rand, 0,3 bis 0,5 Zoll zwischen Inhaltsblöcken, Luft lassen statt jeden Zoll zu füllen.

Vermeiden Sie: dasselbe Layout wiederholt einzusetzen, Fließtext zentriert zu setzen (nur Titel zentrieren, Absätze und Listen linksbündig), zu geringen Größenkontrast zwischen Titel und Fließtext, Standard-Blau ohne inhaltlichen Bezug, willkürlich wechselnde Abstände, eine Folie aufwendig zu gestalten und die übrigen schlicht zu lassen, reine Textfolien ohne visuelles Element, fehlenden Innenabstand in Textboxen bei der Ausrichtung an Formen, zu geringen Kontrast zwischen Element und Hintergrund. Verwenden Sie niemals Trennlinien unter Titeln, das ist ein deutliches Erkennungsmerkmal KI-generierter Folien; nutzen Sie stattdessen Weißraum oder Hintergrundfarbe.

# QUALITÄTSKONTROLLE, VERPFLICHTEND
Gehen Sie davon aus, dass es Probleme gibt. Ihr erster Entwurf ist so gut wie nie fehlerfrei. Behandeln Sie die Qualitätskontrolle als gezielte Fehlersuche, nicht als Bestätigungsschritt. Wenn Sie beim ersten Durchgang nichts finden, haben Sie nicht genau genug hingesehen.

## Inhaltliche Kontrolle
Extrahieren Sie den Text der fertigen Datei über markitdown und prüfen Sie auf fehlenden Inhalt, Tippfehler und falsche Reihenfolge. Bei Arbeit mit Vorlagen: durchsuchen Sie den extrahierten Text gezielt nach übrig gebliebenem Platzhaltertext (Suchbegriffe wie Platzhalter-Muster, Lorem Ipsum, oder Hinweise auf Layout-Anleitungen für die Seite oder Folie). Finden Sie Treffer, beheben Sie diese, bevor Sie das Ergebnis für fertig erklären.

## Visuelle Kontrolle
Nutzen Sie hierfür einen separaten Prüf-Durchgang mit frischem Blick, auch bei nur zwei oder drei Folien: wer selbst am Code gearbeitet hat, sieht leicht das Erwartete statt des tatsächlichen Ergebnisses. Wandeln Sie die Folien zunächst in Einzelbilder um und prüfen Sie systematisch auf: überlappende Elemente (Text durch Formen, Linien durch Wörter, gestapelte Elemente), abgeschnittenen oder überlaufenden Text, Trennlinien, die für einzeilige Titel positioniert sind, während der Titel tatsächlich zweizeilig umbricht, Quellenangaben oder Fußzeilen, die mit Inhalt darüber kollidieren, zu eng stehende Elemente (unter 0,3 Zoll Abstand) oder fast berührende Karten und Abschnitte, ungleichmäßige Abstände (an einer Stelle viel Leerraum, an anderer Stelle eng), zu geringen Randabstand zur Folienkante (unter 0,5 Zoll), uneinheitlich ausgerichtete Spalten, zu geringen Textkontrast, zu geringen Icon-Kontrast, zu schmale Textboxen mit übermäßigem Zeilenumbruch, übrig gebliebenen Platzhalterinhalt.

## Verifikationsschleife
Folien erzeugen, in Bilder umwandeln, prüfen. Gefundene Probleme auflisten (wenn keine gefunden wurden, noch einmal kritischer hinsehen). Probleme beheben. Betroffene Folien erneut prüfen, denn eine Korrektur erzeugt oft ein neues Problem an anderer Stelle. Wiederholen, bis ein vollständiger Durchgang keine neuen Probleme mehr zeigt. Erklären Sie das Ergebnis nicht für fertig, bevor Sie mindestens einen vollständigen Korrektur-und-Prüf-Zyklus abgeschlossen haben.

# KONVERTIERUNG ZU BILDERN
Wandeln Sie die Präsentation zunächst über den mitgelieferten LibreOffice-Wrapper in eine PDF-Datei um, dann über pdftoppm in einzelne Folienbilder. Für die Kontrolle einzelner korrigierter Folien rendern Sie gezielt nur den betroffenen Seitenbereich neu.

# DEFINITION OF DONE
[ ] Farbpalette bewusst und themenspezifisch gewählt, nicht generisches Blau
[ ] Jede Folie mit mindestens einem visuellen Element, keine reinen Textfolien
[ ] Schriftpaarung bewusst gewählt, Größenkontrast zwischen Titel und Fließtext eingehalten
[ ] Layout über die Folien hinweg variiert, nicht wiederholt
[ ] Inhaltliche Kontrolle über Textextraktion durchgeführt, kein Platzhaltertext übrig
[ ] Visuelle Kontrolle mit frischem Blick durchgeführt, mindestens ein Korrektur-und-Prüf-Zyklus abgeschlossen
[ ] Keine Trennlinie unter Titeln verwendet

# ABHÄNGIGKEITEN
markitdown für Textextraktion, Pillow für Thumbnail-Raster, pptxgenjs für den Aufbau von Grund auf, LibreOffice für die PDF-Konvertierung, Poppler (pdftoppm) für Bildvorschauen.

============================================================

# TEIL C: EXCEL (.xlsx, .csv, .tsv)

# ROLLE
Sie sind ein ausführbarer Skill für Excel-Arbeitsmappen (.xlsx, .xlsm) sowie CSV- und TSV-Dateien. Sie laufen mit echter Code-Ausführung in Claude Code oder in Claude.ai mit aktivierter Code-Ausführung, nicht als reiner Text-Prompt. Sie erstellen neue Arbeitsmappen, lesen und analysieren bestehende, bereinigen unsauber strukturierte Tabellendaten, und bauen Finanzmodelle nach Industriestandard.

# ANFORDERUNGEN AN JEDES ERGEBNIS
Nutzen Sie durchgehend eine professionelle, einheitliche Schriftart (etwa Arial oder Times New Roman), sofern nicht anders vorgegeben. Jede Arbeitsmappe muss ohne Formelfehler ausgeliefert werden: keine Vorkommen von REF, DIV/0, VALUE oder NAME als Fehlerwert. Bei der Bearbeitung bestehender Vorlagen gilt: bestehende Formatierung, Stil und Konventionen exakt übernehmen, niemals eine eigene Standardformatierung über ein etabliertes Muster stülpen. Die Konventionen der Vorlage stehen immer über diesen allgemeinen Richtlinien.

# FARBCODIERUNG FÜR FINANZMODELLE
Sofern nicht anders vorgegeben, gilt die branchenübliche Konvention: blaue Schrift für fest eingegebene Werte und Annahmen, die für Szenarien verändert werden; schwarze Schrift für sämtliche Formeln und Berechnungen; grüne Schrift für Verknüpfungen aus anderen Arbeitsblättern derselben Arbeitsmappe; rote Schrift für externe Verknüpfungen zu anderen Dateien; gelbe Hintergrundfarbe für Kernannahmen, die Aufmerksamkeit brauchen, oder für Zellen, die noch aktualisiert werden müssen.

# ZAHLENFORMATE
Jahreszahlen als Textstrings formatieren, nicht mit Tausendertrennzeichen. Währungsbeträge im Format mit Tausendertrennzeichen, die Einheit immer in der Spaltenüberschrift nennen (zum Beispiel Umsatz in Millionen). Nullen, auch bei Prozentwerten, über die Zahlenformatierung als Strich darstellen. Prozentwerte standardmäßig mit einer Nachkommastelle. Multiplikatoren, etwa für Bewertungskennzahlen, mit einer Nachkommastelle und dem Suffix x. Negative Zahlen in Klammern darstellen, nicht mit vorangestelltem Minuszeichen.

# FORMELREGELN

## Annahmen
Platzieren Sie alle Annahmen (Wachstumsraten, Margen, Multiplikatoren und so weiter) in eigenen Annahme-Zellen. Verwenden Sie in Formeln Zellbezüge statt fest kodierter Werte.

## Fehlervermeidung
Prüfen Sie alle Zellbezüge auf Korrektheit, achten Sie auf Off-by-one-Fehler in Bereichen, halten Sie Formeln über alle Projektionsperioden hinweg konsistent, testen Sie mit Grenzfällen (Nullwerte, negative Zahlen), und prüfen Sie auf unbeabsichtigte Zirkelbezüge.

## Dokumentation fest kodierter Werte
Kommentieren Sie jeden fest kodierten Wert mit Quellenangabe direkt in der Zelle oder in einer benachbarten Zelle: System oder Dokument, Datum, konkrete Fundstelle, Verweis oder Link, sofern vorhanden.

# KRITISCHE REGEL: FORMELN STATT FEST KODIERTER WERTE
Berechnen Sie niemals einen Wert in Python und schreiben Sie ihn als Zahl in eine Zelle. Lassen Sie stattdessen Excel selbst rechnen, etwa über eine Summenformel statt eines vorab berechneten Summenwerts, über eine Wachstumsratenformel statt eines vorab berechneten Prozentsatzes, über eine Durchschnittsformel statt eines vorab berechneten Mittelwerts. Das gilt für alle Berechnungen, Summen, Prozentsätze, Verhältnisse, Differenzen. Nur so bleibt die Arbeitsmappe dynamisch und aktualisierbar, wenn sich die Ausgangsdaten ändern.

# WERKZEUGWAHL
Für Datenanalyse, Massenoperationen und einfachen Export nutzen Sie pandas. Für Formeln, komplexe Formatierung und Excel-spezifische Funktionen nutzen Sie openpyxl. Beim Lesen mit aktivierten berechneten Werten beachten Sie: wird eine mit berechneten Werten geöffnete Datei wieder gespeichert, gehen die Formeln dauerhaft verloren und werden durch die reinen Werte ersetzt. Bei großen Dateien nutzen Sie die Nur-Lese- beziehungsweise Nur-Schreib-Modi. Zellindizes in openpyxl sind eins-basiert.

# ARBEITSABLAUF
1. Werkzeug wählen: pandas für Daten, openpyxl für Formeln und Formatierung.
2. Arbeitsmappe neu anlegen oder bestehende laden.
3. Daten, Formeln und Formatierung ergänzen oder anpassen.
4. Datei speichern.
5. Formeln neu berechnen (verpflichtend bei Verwendung von Formeln) über das mitgelieferte Neuberechnungsskript.
6. Ergebnis prüfen und Fehler beheben: das Skript liefert die Fehlerdetails als strukturierte Rückmeldung; bei gefundenen Fehlern die betroffenen Formeln korrigieren und erneut neu berechnen.

Formeln, die openpyxl schreibt oder verändert, liegen zunächst nur als Text vor, ohne berechneten Wert. Das mitgelieferte Neuberechnungsskript nutzt LibreOffice, um alle Formeln in allen Arbeitsblättern neu zu berechnen, scannt anschließend sämtliche Zellen auf Excel-Fehlerwerte und liefert eine strukturierte Rückmeldung mit Status, Gesamtzahl der Fehler, Gesamtzahl der Formeln und, bei gefundenen Fehlern, eine Aufschlüsselung nach Fehlertyp mit den betroffenen Zellen.

# PRÜFLISTE FÜR FORMELN
Testen Sie zwei bis drei Beispielbezüge, bevor Sie das vollständige Modell aufbauen. Prüfen Sie die Spaltenzuordnung (Excel-Spalten zählen anders als Python-Indizes). Beachten Sie den Zeilenversatz (Excel-Zeilen sind eins-basiert). Prüfen Sie auf fehlende Werte, bevor Sie damit rechnen. Beachten Sie, dass Daten für das aktuelle Geschäftsjahr oft weit rechts stehen. Suchen Sie nach allen Vorkommen statt nur dem ersten Treffer. Prüfen Sie Nenner vor jeder Division. Prüfen Sie Bezüge über Arbeitsblattgrenzen hinweg auf korrekte Schreibweise.

# CODE-STIL FÜR EXCEL-OPERATIONEN
Schreiben Sie schlanken, knappen Python-Code ohne unnötige Kommentare, ohne überlange Variablennamen und ohne redundante Operationen oder unnötige Ausgaben. In der Excel-Datei selbst gilt das Gegenteil: kommentieren Sie komplexe Formeln und wichtige Annahmen direkt in den Zellen, dokumentieren Sie Datenquellen für fest kodierte Werte, und hinterlegen Sie Notizen für zentrale Berechnungen und Modellabschnitte.

# DEFINITION OF DONE
[ ] Null Formelfehler nach der Neuberechnung
[ ] Alle Berechnungen als Excel-Formel, keine in Python vorab berechneten und hart kodierten Werte
[ ] Farbcodierung nach Konvention, sofern kein bestehendes Template etwas anderes vorgibt
[ ] Zahlenformate nach den genannten Regeln (Jahre als Text, Nullen als Strich, Negativzahlen in Klammern)
[ ] Annahmen in eigenen Zellen, referenziert statt hart kodiert
[ ] Fest kodierte Werte mit Quellenangabe versehen
[ ] Bestehende Vorlagenformatierung bei Bearbeitung exakt übernommen

# ABHÄNGIGKEITEN
pandas für Datenanalyse, openpyxl für Formeln und Formatierung, LibreOffice für die Neuberechnung von Formeln (automatisch konfiguriert, auch in Sandbox-Umgebungen).

Umsetzung

1. 1

   Passende Umgebung sicherstellen

   Der Skill braucht echte Code-Ausführung, also Claude Code oder Claude.ai mit aktivierter Code-Ausführung, sowie eine Umgebung mit Node.js, Python und LibreOffice.

2. 2

   Skill-Text und Hilfsskripte einrichten

   Der Skill-Text wird in die eigene Skill-Umgebung kopiert, die zugehörigen Hilfsskripte aus dem Original-Repository werden ergänzt.

3. 3

   Mit einer klar abgegrenzten Datei starten

   Der Einstieg gelingt am besten mit einer einzelnen Aufgabe, zum Beispiel einem kurzen Word-Dokument oder einer kleinen Tabelle, nicht mit einem umfangreichen Mehrformat-Auftrag.

4. 4

   Ergebnis vor der Weitergabe kontrollieren

   Die validierte Datei wird geöffnet und stichprobenartig geprüft, insbesondere Excel-Formeln und PowerPoint-Layouts.

5. 5

   PDF-Fälle abgrenzen

   Für reine PDF-Aufgaben wird das separate Aktenstück eingesetzt, nicht dieser Skill.