Index of every page on this site: llms.txt
All skills
anthropics avatar

/xlsx

@e4bb5d9 official
by Anthropicanthropics/skills198k stars
23,193
Run it yourself

Use this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.

Use this Skill: https://skilld.dev/gh/anthropics/skills/xlsx

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈240 tokens for metadata: the name and description. ≈2.2k when used: this file.

Description uses 11.9% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈955 characters, or 11.9%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

XLSX creation, editing, and analysis

Task Approach
Create or edit with formulas/formatting openpyxl — see gotchas below
Bulk data in or out pandas (read_excel, to_excel)
Quick look at a sheet markitdown 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.

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)

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts3d5 checks · Risk SAFE
  • Gen Agent Trust Hub4d

    This skill provides comprehensive tools for creating, editing, and analyzing Excel spreadsheets and other Office documents. It includes advanced functionality for formula recalculation using LibreOffice and rigorous XML validation. To ensure compatibility with restricted or sandboxed environments, the skill employs techniques like runtime compilation of shims and dynamic macro generation. These operations are well-documented and align with the skill's primary purpose of robust document processing.

  • Socket3d

    No alerts

  • Snyk4d

    Risk: LOW · No issues

  • Runlayer8mo

    6/53 files flagged

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at e4bb5d9. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 5 days ago.

Activeupdated last week
  • xlsx
  • csv
  • tsv
  • spreadsheet
  • data-cleaning
  • excel
  • openpyxl
  • pandas
  • formatting

README badge

README badge for anthropics/skills/xlsx

Reads, writes, edits, and creates .xlsx, .xlsm, .csv, and .tsv files; applies formulas, formatting, and color-coding standards for financial models. Use this skill when a spreadsheet file is the primary input or output, including data cleaning, restructuring, charting, and format conversion.

Generated from the current SKILL.md.

Does this skill work with CSV and TSV files?
Yes. The skill handles .xlsx, .xlsm, .csv, and .tsv files. It can open, edit, and convert between these tabular formats.
Can I use this skill to create formulas in Excel files?
Yes. The skill uses openpyxl to create and edit formulas, and includes a recalc.py script to evaluate them. All formulas must be verified for errors (#REF!, #DIV/0!, etc.) before delivery.
What if the user wants output in Google Sheets or a database?
This skill does not trigger for those deliverables. It only applies when the primary output is a spreadsheet file (.xlsx, .csv, .tsv, or .xlsm).
Does this skill clean up messy or malformed data?
Yes. The skill handles restructuring messy tabular data—misaligned rows, junk headers, or inconsistent formatting—into proper spreadsheets.
Should I hardcode calculated values or use formulas?
Always use Excel formulas, not hardcoded values from Python. This keeps the spreadsheet dynamic and updateable. Use scripts/recalc.py to compute formula results.

Generated from the current SKILL.md. These answers refresh after source changes.