anthropics/skills

xlsx

Skill do edycji skoroszytów z uwzględnieniem pól wejściowych, formuł i istniejących zasad.

Zobacz źródło

Szczegółowy opis

Skill rozróżnia tworzenie arkusza, edycję istniejącego skoroszytu i analizę większych zbiorów. Formuły oraz formatowanie obsługuje openpyxl, dane tabelaryczne pandas, a formuły wymagają osobnego przeliczenia. W istniejącym pliku pierwszeństwo mają jego pola wejściowe i zasady, nie nowy styl.

Formuła i zapisany wynik to różne rzeczy. openpyxl zapisuje formuły bez ich obliczania, a odczyt samych wartości nie pokazuje formuł. Pakiet opisuje osobne odczyty, zapis kopii i recalc.py korzystający z LibreOffice. Możliwość otwarcia pliku nie dowodzi poprawności modelu.

Co przygotować

  • Skoroszyt lub dane źródłowe, dokładne nazwy arkuszy i kolumn oraz zakres zmian.
  • Definicje formuł, komórki wejściowe, jednostki i założenia; pliki źródłowe dla odwołań zewnętrznych.

Oczekiwane wyniki

  • Nadal edytowalny skoroszyt z wymaganą strukturą, formułami i formatowaniem.
  • Przy formułach: przeliczone wartości i podsumowanie błędów JSON oraz porównanie z oczekiwanymi wynikami.

Sposób użycia

  1. Sprawdź arkusze, wejścia i konwencje formuł. Gdy potrzebujesz obu widoków, odczytaj osobno formuły i zapisane wyniki.
  2. Zmieniaj tylko wskazane obszary, pozostawiając obliczenia jako formuły. Najpierw sprawdź kilka przykładów na znanych danych.
  3. Zachowaj oryginał i zapisz osobny wynik. Przed przeliczaniem sprawdź łącza zewnętrzne i nieobsługiwane funkcje; ich zapisane wyniki mogą być stare lub nieobecne.
  4. Skrypt przelicza kopię tymczasową, a następnie wstawia obliczone wartości do wybranego pliku, zachowując pozostałe części ZIP. Odczytaj error_summary i not_computed, otwórz plik w docelowym Excelu i sprawdź sumy oraz formatowanie.

Ograniczenia i kontrola

  • Nie zapisuj widoku wczytanego przez data_only=True na pliku z formułami: ten widok zawiera wartości zamiast wyrażeń.
  • Kod 0 ani status success nie dowodzą obliczenia każdej formuły. Sprawdź errors_found i not_computed; przed zmianą formuł odróżnij rzeczywisty błąd od nieobsługiwanej funkcji.
  • Osobno sprawdź wyniki łączy. Dla makr użyj keep_vba, a dla tekstu sformatowanego w razie potrzeby rich_text=True. Zapis openpyxl może utracić kształty, pola tekstowe i fragmentatory; porównaj z oryginałem.

Częste pytania

Czy brak błędów po przeliczeniu dowodzi poprawności modelu?

Nie. Nieobsługiwane funkcje i łącza zewnętrzne mogą zachować stare wartości lub nie mieć wyniku mimo komunikatu o sukcesie. Sprawdź nierozwiązane formuły i porównaj zakresy, jednostki oraz sumy ze znanymi danymi w docelowym Excelu.

Czy nowe funkcje nie działają w samym Excelu?

To nie taki wniosek. Ograniczenia źródła dotyczą konkretnej ścieżki weryfikacji openpyxl i LibreOffice, zwłaszcza nowych funkcji i tablic rozlewanych. Zgodność trzeba sprawdzić w środowisku odbiorcy.

Której wersji źródeł i licencji dotyczy ten opis?

Wersja wskazana w źródłach zawiera Apache 2.0 w LICENSE.txt. Przegląd obejmuje również zaktualizowane instrukcje i narzędzia pomocnicze. Sprawdź warunki dołączone do dokładnie używanej wersji.

Zainstaluj ten Skill

Dodaj Skill z jego zweryfikowanego źródła GitHub za pomocą Skills CLI.

npx skills add https://github.com/anthropics/skills --skill xlsx

Informacje o źródle

Oryginalny dokument Skill

Treść z repozytorium z zachowaniem nagłówków, przykładów, kodu, tabel, linków i obrazów.

XLSX creation, editing, and analysis

TaskApproach
Create or edit with formulas/formattingopenpyxl — see gotchas below
Bulk data in or outpandas (read_excel, to_excel)
Quick look at a sheetmarkitdown file.xlsx — ## SheetName per sheet; reads .xlsm too. No cell coordinates, so don't plan edits from it
Read a model (formulas and values)two load_workbook passes — see gotchas
openpyxl, pandas, and markitdown are preinstalled — do not run pip install first; write the script and import directly. Only if an import fails (or the markitdown command is missing): pip install the missing package.
Script paths below are relative to this skill's directory.

Requirements for every output

  • Professional font (Arial, Times New Roman) throughout, unless the user says otherwise.
  • Zero formula errors. Never ship while recalc.py reports errors_found; the one exception is under not_computed below. If you think an error predates you, prove it: load the original with data_only=True and look at that cell. An error you introduced looks exactly like one you inherited.
  • Use formulas, never hardcoded results. Write sheet['B10'] = '=SUM(B2:B9)', not the Python-computed total. The sheet must recalculate when its inputs change.
  • Follow the user's spec literally. Exact tab names, exact column headers, and the formula they spelled out. A redesign that computes something else fails, however elegant.
  • Document every assumption and hardcoded number where the reader will see it — a cell comment, or an adjacent cell at a table's end. Cite a real source when one exists (Source: Company 10-K, FY2024, Page 45, Revenue Note, [SEC EDGAR URL]); when the number came from the user, say so plainly.
  • A workbook you create for someone to fill in* needs a short legend naming which cells to edit, and one example row of realistic values showing the expected format. Never add such a row to a file you were asked to edit.
  • Editing an existing file: match its conventions exactly. They override every guideline here. Find its designated input cells first — a distinct font color, fill, or shading marks them — write only there, and leave every existing formula untouched.

Recalculate (mandatory whenever the file contains formulas)

openpyxl writes formulas as strings with no cached values. Until you recalculate, every formula cell reads back as None to anything reading cached values — pandas, load_workbook(data_only=True), and most previewers.

bash
python scripts/recalc.py output.xlsx [timeout_seconds]   # default 30

LibreOffice computes the formulas on a copy, only their values go into your file, and you get JSON: status (success | errors_found), total_formulas, total_errors, and an error_summary naming up to 100 cells per error type (locations_truncated says how many it withheld — trust total_errors, not the length of the list). Fix what it names and run it again. JSON with an `error` key instead of a `status` means nothing was recalculated, and only that case exits non-zero — errors_found exits 0, so never treat a clean exit as a clean workbook.

A green recalc proves your formulas evaluate, not that they are right.* An off-by-one range or a reference to the wrong row yields a clean, error-free file with wrong numbers. Write 2–3 formulas first and check they pull the values you expect, before building out a grid.

`not_computed` lists formulas LibreOffice cannot evaluate, even on `success`: a function it lacks (_xlfn.XLOOKUP, _xlfn.LET…) or a link to another workbook (='[1]Returns Analysis'!$B$2). They keep what they held: after an openpyxl save, nothing until Excel opens it. For their numbers sooner, read the original with data_only=True; keep the formulas. A sound formula depending on a listed one, directly or not, reports #NAME? too: leave it and tell the user. A cell that tests one (IFERROR(B1,0)) gets LibreOffice's fallback, and a kept value may be stale: say so. After editing sheet XML, delete each changed formula's <v>: a mistake that keeps its value is listed, not reported.

Choosing formulas that survive verification

LibreOffice implements fewer functions than Excel, and a formula it cannot evaluate has no value until Excel opens the file.

  • Prefer Excel-2007-era functions — SUMIFS, INDEX, MATCH, IFERROR, SUMPRODUCT — which need no prefix.
  • Six post-2007 functions work, but only with an `_xlfn.` prefix, because openpyxl writes your formula into the XML verbatim and Excel stores post-2007 names prefixed (its UI hides the prefix): _xlfn.TEXTJOIN, _xlfn.CONCAT, _xlfn.IFS, _xlfn.SWITCH, _xlfn.MAXIFS, _xlfn.MINIFS. Written bare, each yields #NAME?.
  • Never use `XLOOKUP`, `XMATCH`, `SORT`, `FILTER`, `UNIQUE`, or `SEQUENCE`. The runtime's LibreOffice cannot evaluate them, and one that can fills only the top-left cell of their result, since an openpyxl-written file has no spill metadata. Use INDEX/MATCH for lookups, and sort, filter, and de-duplicate in Python before writing the cells.
  • A missing ) is reported as unbalanced brackets. Too few arguments (=ROUND(A1)) is not: LibreOffice returns a value, and Excel may offer to repair the file.

openpyxl gotchas

  • Reading a model takes two loads. data_only=True yields cached values with the formulas gone; the default yields formula strings with no values. One pass cannot give you both.
  • `data_only=True` is destructive if you save. That workbook has no formulas left, so saving replaces every one with a literal — permanently.
  • `data_only=True` on a file openpyxl just wrote returns `None` everywhere — run recalc.py first. (A formula whose result is "" also reads back as None.)
  • Merged cells: write the top-left anchor only. Every other cell in the range is a MergedCell whose .value is read-only.
  • `.xlsm` loses its macros unless you pass `keep_vba=True` to load_workbook.
  • A sheet name containing a space must be quoted in a cross-sheet reference: ='Assumptions Inputs'!$B$5. Unquoted, it evaluates to #VALUE!.
  • Saving an upload drops its text boxes, shapes and slicers. First search xl/drawings/ for <xdr:sp (with the space) and look for an xl/slicers/ part; if found, tell the user or edit the sheet XML directly.
  • Nothing mends a malformed workbook: an unclosed quote in a number format ('0.00 "USD'), a defined name starting with =, or duplicate or empty table headers are saved as written, and Excel may offer to repair the file.
  • Partly bold or italic cell text is flattened unless load_workbook(rich_text=True); such a .value is then a CellRichText, not a str.
  • Every new formula needs its own `number_format` (date, %, currency): nothing infers it, so a date shows as 45337 and 30% as 0.3.
  • On every new chart set `chart.roundedCorners = False`, `.overlay = False` on its legend and on each title you gave it (`chart.legend`, `chart.title`, `chart.x_axis.title`…), and, if it has axes (not pie or doughnut), `chart.x_axis.delete = False` and `chart.y_axis.delete = False`, or Excel may draw the title or legend over the plot, round the frame, or draw no axes.
  • With a `DateAxis`, set `chart.y_axis.crossAx = 500`, or Excel may offer to repair the file.

Financial models

Unless the user says otherwise, or the existing file already does something else.

Color: blue text (0,0,255) for hardcoded inputs and scenario levers · black for formulas · green (0,128,0) for links to another sheet · red (255,0,0) for links to another file · yellow fill (255,255,0) for key assumptions and cells the user should fill in.

Numbers: currency $#,##0, with the unit named in the header (Revenue ($mm)) · zeros render as -, including in percentages ($#,##0;($#,##0);-) · negatives in parentheses · percentages 0.0%, stored as fractions (0.15 renders 15.0%; storing 15 renders 1500.0%) · valuation multiples 0.0x · years as text ("2024", never 2,024).

Structure: every assumption in its own labeled cell, referenced by the formulas that use it (=B5*(1+$B$6), never =B5*1.05) · formulas consistent across every projection period, since a lone edited cell mid-row is the commonest silent error · guard denominators that can be zero.

Dependencies

openpyxl, pandas, markitdown (pip, preinstalled — install only if an import fails or the command is missing) · LibreOffice (soffice, auto-configured for sandboxed environments via scripts/office/soffice.py)

Powiązane zadania

z tego samego repozytorium

Więcej Skills

Wszystkie Skills
anthropics
Oficjalne

frontend-design

Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.

Instalacje łącznie
1,1 mln
GitHub Stars
198,4 tys.
Aktualizacja
16 lis
anthropics
Oficjalne

skill-creator

Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.

Instalacje łącznie
438,8 tys.
GitHub Stars
198,4 tys.
Aktualizacja
16 lis
anthropics
Oficjalne

pptx

Use this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the u

Instalacje łącznie
260,8 tys.
GitHub Stars
198,4 tys.
Aktualizacja
16 lis
anthropics
Oficjalne

webapp-testing

Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.

Instalacje łącznie
211 tys.
GitHub Stars
198,4 tys.
Aktualizacja
16 lis