agent-xlsx

A small CLI for reading and editing .xlsx files, designed for agents. JSON in, JSON out; A1 range notation everywhere; structured JSON errors on stderr.

📖 Full usage docs live in skills/agent-xlsx/SKILL.md. That file is the skill definition consumed by npx skills add and by Claude agents; it doubles as the human-readable reference.

Install

# Latest release, to a dir on PATH
curl -fsSL https://raw.githubusercontent.com/carderne/agent-xlsx/main/install.sh \
    | bash -s -- ~/.local/bin

Supported targets: Apple Silicon macOS, x86_64 Linux, x86_64 Windows.

As a Claude skill

npx skills add carderne/agent-xlsx

As a pi package

pi install npm:agent-xlsx

Quick taste

agent-xlsx create book.xlsx
agent-xlsx edit   book.xlsx A1:C1 '["name","age","city"]'
agent-xlsx edit   book.xlsx A2:C3 '[["Alice",30,"Berlin"],["Bob",42,"Paris"]]'
agent-xlsx read   book.xlsx A1:C3
# [["name","age","city"],["Alice",30.0,"Berlin"],["Bob",42.0,"Paris"]]

Evals

Currently... it's mostly worse than just Python. Did Anthropic try this already?

task	model	py-fail	cli-fail	py-time	cli-time	py-tokens	cli-tokens	py-turns	cli-turns
bulk_filter_bold	claude-haiku-4-5	0	0	11.2s	+81%	914	+146%	3	+67%
conditional_color	claude-haiku-4-5	0	0	9.1s	+20%	741	+51%	2	+50%
edit_formula_totals	claude-haiku-4-5	0	0	8.2s	-4%	593	-10%	2	0%
edit_sparse	claude-haiku-4-5	0	0	15.0s	-26%	858	-14%	4	0%
moving_avg	claude-haiku-4-5	3	0	11.5s	+100%	947	+123%	2	+250%
reorder_cols	claude-haiku-4-5	0	0	12.0s	+23%	1076	+13%	2	+150%
style_header	claude-haiku-4-5	0	0	7.7s	+13%	529	+16%	2	0%

Building from source

cargo build --release
cargo test