spreadsheet

Route tasks to the matching formualizer:spreadsheet operation:

• Explain formulas, drivers, or unexpected totals (read-only): run trace (--roots ... --direction precedents --max-depth 2) to map formula dependencies and inspect (--cells ... or --range ...) to read formulas and stored cached values. Do not run source-recalculate on explanation or read-only requests unless the user asks to verify or repair stale caches, or stored caches are missing.
• Test assumptions or edit cells/formulas: run edit to apply atomic set_cells changes and recalculate in one step, then inspect affected output cells and verify the receipt.
• Calculate a final deliverable from other tools: when creating or modifying a formula-bearing .xlsx with another library, run source-recalculate --output /path/final.xlsx (or --check for read-only verification) after saving final changes and before returning the file.

inspect and trace never evaluate formulas or modify files. Stored formula caches carry freshness: "unverified". Reading or explaining a workbook does not authorize recalculation.

Run locally

Requires Node >=20. The engine is bundled; no install, network access, credentials, or local server is required. Locate this SKILL.md and set CLAUDE_SKILL_DIR to its parent directory.

Check the bundled engine:

node "${CLAUDE_SKILL_DIR}/scripts/xlsx.mjs" doctor

1. Inspect cells or ranges (read-only)

Pass --cells or --range directly (addresses must be sheet-qualified, such as Sheet1!A1 or 'My Sheet'!A1:D20):

node "${CLAUDE_SKILL_DIR}/scripts/xlsx.mjs" inspect /path/input.xlsx --cells "Sheet1!B1" "Sheet1!G12"
node "${CLAUDE_SKILL_DIR}/scripts/xlsx.mjs" inspect /path/input.xlsx --range "Sheet1!A1:M20" --limit 100

Or pass canonical JSON via --json '<JSON>' or a REQUEST.json file. Top-level fields are singular selection and optional page only (never selections or sheets):

{"selection":{"kind":"cells","addresses":["Sheet1!A1","Sheet1!B1"]}}
{"selection":{"kind":"range","address":"Sheet1!A1:D20"},"page":{"limit":50}}