xlsx-author

xlsx-author

Gebruik deze skill wanneer je headless draait (managed-agent-modus of Claude Code zonder open Office-sessie) en je een Excel-werkblad als bestand moet leveren, niet als bewerking in een geopende werkmap.

Output-contract

• Schrijf naar ./out/<naam>.xlsx. Maak ./out/ aan als die nog niet bestaat.
• Retourneer het relatieve pad in je slot-bericht zodat de orchestratie-laag het bestand kan ophalen.
• Geen Nederlandse vs. Engelse Excel-overweging in formules: gebruik altijd Engelse formule-namen (=SUM, =IF) — openpyxl schrijft die en Excel-NL converteert automatisch.

Hoe je de werkmap bouwt

Schrijf een kort Python-script en draai het met Bash. Gebruik openpyxl:

from openpyxl import Workbook
from openpyxl.styles import Font, PatternFill

wb = Workbook()
inputs = wb.active
inputs.title = "Invoer"
inputs["B2"] = "Omzet"
inputs["C2"] = 1_250_000   # bedrag in euro's
inputs["C2"].font = Font(color="0000FF")   # blauw = hardcoded invoer

calc = wb.create_sheet("Berekening")
calc["B2"] = "Omzet × (1 + groei)"
calc["C2"] = "=Invoer!C2*(1+Invoer!C3)"     # zwart = formule

wb.save("./out/model.xlsx")

Conventies (parallel aan excel-controle)

• Blauw / zwart / groen. Blauw = hardcoded invoer, zwart = formule, groen = link naar ander tabblad of bestand.
• Geen hardcodes in berekeningscellen. Elke berekeningscel is een formule; elke invoer staat op een Invoer-tabblad.
• Benoemde bereiken (named ranges) voor waarden waar je in een rapport of memo naar verwijst.
• Aansluitings-checks. Voeg een Controles-tabblad toe dat aansluitingen toetst (balans sluit, cashflow tikt naar eindsaldo, etc.) en het resultaat als TRUE/FALSE laat zien.
• Eén model per bestand. Niet toevoegen aan een bestaande werkmap tenzij expliciet gevraagd.
• Bedragen in euro's, geen valuta-conversies tenzij gevraagd. Format-code voor cellen: € #,##0;[Red]€ -#,##0 voor financiële weergave.

Voorbeeld: maandelijks variantie-rapport

from openpyxl import Workbook
from openpyxl.styles import Font

wb = Workbook()
inv = wb.active; inv.title = "Invoer"
inv["A1"] = "P&L-regel"; inv["B1"] = "Actueel"; inv["C1"] = "Budget"
inv["A2"] = "Omzet";       inv["B2"] = 245_000; inv["C2"] = 230_000
inv["A3"] = "Inkoopwaarde"; inv["B3"] = 142_000; inv["C3"] = 138_000
for r in (2, 3):
    inv[f"B{r}"].font = Font(color="0000FF")
    inv[f"C{r}"].font = Font(color="0000FF")

var = wb.create_sheet("Variantie")
var["A1"] = "P&L-regel"; var["B1"] = "Verschil"; var["C1"] = "Verschil %"
var["A2"] = "=Invoer!A2";  var["B2"] = "=Invoer!B2-Invoer!C2"; var["C2"] = "=B2/Invoer!C2"
var["A3"] = "=Invoer!A3";  var["B3"] = "=Invoer!B3-Invoer!C3"; var["C3"] = "=B3/Invoer!C3"

wb.save("./out/variantie-rapport.xlsx")

Wanneer je deze skill NIET gebruikt

Als de mcp__office__excel_*-tools beschikbaar zijn (Claude Cowork-modus, of Microsoft 365-add-in in Excel), gebruik die. Die schrijven direct in de geopende werkmap van de gebruiker, met review-momenten. Deze skill is de bestand-producerende fallback voor headless sessies.