doc-coauthoring
OfficialStructured three-stage workflow for co-authoring documentation with context gathering, iterative drafting, and reader testing.
Documents
Create, edit, and analyze Excel and CSV files with verified formulas and professional formatting.
Processes .xlsx, .xlsm, .csv, and .tsv files using openpyxl for formula-driven editing and pandas for bulk data operations. Includes a mandatory LibreOffice recalculation step to verify formula evaluation and catch errors before delivery. Enforces professional formatting standards, documents all assumptions in-cell, and preserves existing file conventions when editing.
| 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, 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.
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.sheet['B10'] = '=SUM(B2:B9)', not the Python-computed total. The sheet must recalculate when its inputs change.Source: Company 10-K, FY2024, Page 45, Revenue Note, [SEC EDGAR URL]); when the number came from the user, say so plainly.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 ``: a mistake that keeps its value is listed, not reported.
LibreOffice implements fewer functions than Excel, and a formula it cannot evaluate has no value until Excel opens the file.
SUMIFS, INDEX, MATCH, IFERROR, SUMPRODUCT — which need no prefix._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?.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.) is reported as unbalanced brackets. Too few arguments (=ROUND(A1)) is not: LibreOffice returns a value, and Excel may offer to repair the file.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.)MergedCell whose .value is read-only..xlsm loses its macros unless you pass keep_vba=True to load_workbook.='Assumptions Inputs'!$B$5. Unquoted, it evaluates to #VALUE!.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.'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.load_workbook(rich_text=True); such a .value is then a CellRichText, not a str.number_format (date, %, currency): nothing infers it, so a date shows as 45337 and 30% as 0.3.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.DateAxis, set chart.y_axis.crossAx = 500, or Excel may offer to repair the file.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.
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)
Structured three-stage workflow for co-authoring documentation with context gathering, iterative drafting, and reader testing.
Create, edit, read, and validate .pptx and .potx files programmatically with built-in safety checks.
Retrieves authoritative OpenAI developer documentation, model selection guidance, and Codex configuration details with citations.
Identifies language and framework security risks and suggests fixes for Python, JavaScript/TypeScript, and Go.
Use when a user asks to debug or fix failing GitHub PR checks that run in GitHub Actions; use `gh` to inspect checks and logs, summarize failure context, draft a fix plan, and implement only after exp
Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors/fonts that you can apply to any artifact t
Structured three-stage workflow for co-authoring documentation with context gathering, iterative drafting, and reader testing.
Programmatically create, edit, and validate Word documents with correct formatting and tracked changes.
Read, create, merge, split, and modify PDF files using Python libraries and command-line tools.
Create, edit, read, and validate .pptx and .potx files programmatically with built-in safety checks.
Generates original p5.js algorithmic art with seeded randomness and interactive parameter controls from a custom computational philosophy.
Create, test, and iteratively improve agent skills with built-in evaluation workflows.