xlsx
全面支持公式、格式设置、数据分析和可视化的电子表格创建、编辑和分析。当 Claude 需要处理电子表格(.xlsx、.xlsm、.csv、.tsv 等)时,包括:(1) 创建带有公式和格式的电子表格,(2) 读取或分析数据,(3) 修改现有电子表格并保留公式,(4) 电子表格中的数据分析和可视化,或 (5) 重新计算公式
npx skills add https://github.com/anthropics/skills --skill xlsx
README 文档
6,946 字XLSX creation, editing, and analysis
| Task | Approach |
|---|---|
| Create or edit with formulas/formatting | openpyxl — see gotchas below |
| Bulk data in or out | pandas (readexcel, toexcel) |
| 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, andmarkitdownare preinstalled — do not runpip installfirst; write the script and import directly. Only if an import fails (or themarkitdowncommand is missing):pip installthe 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.pyreportserrorsfound; the one exception is undernotcomputedbelow. If you think an error predates you, prove it: load the original withdata_only=Trueand 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, loadworkbook(dataonly=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 | errorsfound), totalformulas, totalerrors, and an errorsummary naming up to 100 cells per error type (locationstruncated says how many it withheld — trust totalerrors, 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.
notcomputed 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 dataonly=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, orSEQUENCE. 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. UseINDEX/MATCHfor lookups, and sort, filter, and de-duplicate in Python before writing the cells. - A missing
)is reported asunbalanced 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=Trueyields cached values with the formulas gone; the default yields formula strings with no values. One pass cannot give you both. data_only=Trueis destructive if you save. That workbook has no formulas left, so saving replaces every one with a literal — permanently.data_only=Trueon a file openpyxl just wrote returnsNoneeverywhere — runrecalc.pyfirst. (A formula whose result is""also reads back asNone.)- Merged cells: write the top-left anchor only. Every other cell in the range is a
MergedCellwhose.valueis read-only. .xlsmloses its macros unless you passkeepvba=Truetoloadworkbook.- 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 anxl/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
loadworkbook(richtext=True); such a.valueis then aCellRichText, not astr. - Every new formula needs its own
number_format(date, %, currency): nothing infers it, so a date shows as45337and 30% as0.3. - On every new chart set
chart.roundedCorners = False,.overlay = Falseon its legend and on each title you gave it (chart.legend,chart.title,chart.xaxis.title…), and, if it has axes (not pie or doughnut),chart.xaxis.delete = Falseandchart.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, setchart.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 =B51.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)
同分类其他技能
查看全部 ›中国金融机构数据爬取与分析综合 Skill v12.1.0。2334家/43大类机构名单、60+财经媒体源舆情、 A股报告/公告/研报、
303 99.4万 MysteelAI - 智能问数我的钢铁网(Mysteel)大宗商品价格行情数据查询技能,基于钢联/隆众数据平台提供专业价格数据服务。覆盖黑色金属、有色金属、能源化工、
9 75万 smart-charts32种图表,3 个主题,2步生成: 1.上传数据 — 将 CSV / Excel / JSON 等格式的数据文件拖入对话框; 2.查看结
149 74.3万 论文配图一键生成论文配图一键生成:一条命令从 JSON/CSV/Excel 生成顶刊级学术图表,科研绘图 与期刊配图全场景覆盖。41 种图表(森林图/K
91 52.8万 smart-chartsIntelligent chart generation and data analysis skill. Reads user-sup
2 37.9万 股票/基金/期货量化分析工具全球智能投研工具(stock-researcher)v14.0:多源数据 + 概率预测 + 批量研究 + 可导出报告。 核心能力: -
152 26.5万