Agent skill

aai-cli Spreadsheet Editor

by aai-labs in aai-labs/agent-barn

Uses aai-cli to create and edit local Excel and CSV files, manage sheet tabs and read, update or clear cell ranges.

Apache-2.0Auto-check passedDocuments & Office

Install aai-cli Spreadsheet Editor

skills CLI
$ npx skills add aai-labs/agent-barn --skill aai-excel -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aai-labs/agent-barn aai-excel --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aai-labs/agent-barn.git skills-src && mkdir -p .claude/skills && cp -r skills-src/api/domains/agents/aai_cli_skills/bundled/skills/aai-excel .claude/skills/aai-excel && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
aai-excel
GitHub stars
109
Token cost
~608 tokens
SKILL.md length
347 words
Files
2 (incl. references)
Skills in repo
12
Repo updated
First seen
Licence
Apache-2.0

At a glance

Uses aai-cli to create and edit local Excel and CSV files, manage sheet tabs and read, update or clear cell ranges.

  • Creating a new spreadsheet file from the command line
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Reading or updating cell ranges in an .xlsx or .csv file
  • Adding, renaming or deleting sheet tabs in a workbook

What it does

The skill works on local files through `aai-cli excel`, with no account, profile or credentials involved. It reads and writes `.xlsx`, `.xlsm`, `.csv` and `.tsv`, while `.xls`, `.xlsb` and `.ods` are read-only and must be saved as `.xlsx` or `.csv` before editing. `workbook create` starts a file, `sheets list` shows tab names and data extent, `sheets add`, `delete` and `rename` change tabs, and `values` commands read, update or clear ranges.

Ranges use A1 notation such as `'Sheet1'!A1:D5`, open column or row ranges or a bare sheet name, and `values update` takes a JSON array of row arrays written from the range's top-left cell. Renaming or deleting a tab is refused if formulas point to it unless `--force` is passed, and editing an `.xlsx` rewrites the workbook, so writes that would lose charts, pivot tables or similar features are refused. A CSV is one sheet named after the file. Output is JSON on stdout and structured errors go to stderr.

When your agent uses it

  • Creating a new spreadsheet file from the command line
  • Reading or updating cell ranges in an .xlsx or .csv file
  • Adding, renaming or deleting sheet tabs in a workbook

Example prompts

  • “Create sales.xlsx with a Q1 sheet and write these rows starting at A1.”
  • “Read A1:D20 from the Summary tab of budget.xlsx.”
  • “Rename the Draft tab in report.xlsx to Final, and warn me if formulas reference it.”
  • “Clear the values in B2:B50 of inventory.csv.”

Requirements

  • aai-cli installed and available on the command line

What it can do on your machine

Read from SKILL.md and the folder at commit df5e0a7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

aai-cli Spreadsheet Editor loads about 608 tokens when it runs, and up to ~3.2k if it reads all its reference files. Until then it costs about 44 tokens; SKILL.md has 347 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~44
When it runs · the whole SKILL.md, loaded when a task matches
~608
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from aai-labs/agent-barn at commit df5e0a7, republished under its Apache-2.0 licence (© aai-labs). 347 words, ~608 tokens.

Download SKILL.mdSave it as .claude/skills/aai-excel/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
aai-excel
description
Use aai-cli to create local spreadsheet files, manage their sheet tabs, and read, update, or clear cell values — Excel (.xlsx/.xlsm) and delimited text (.csv/.tsv).

aai-cli Excel

Use this skill when working with spreadsheet files on disk through aai-cli excel.

Read and write .xlsx, .xlsm, .csv, .tsv. Read-only: .xls (Excel 97–2003), .xlsb, .ods — to edit one, save it as .xlsx or .csv first.

These are local files. There is no account, profile, or credential involved — do not pass --profile, and do not ask the user to authenticate. Just point the command at a file path.

Use workbook create to start a new file, sheets list to discover tab names and how far each one's data extends, sheets add/delete/rename to change the tabs of an existing .xlsx, then values commands to read, update, or clear ranges.

Ranges use A1 notation and accept the same forms as Google Sheets: 'Sheet1'!A1:D5, a single cell, an open column range (B:C), an open row range (2:5), or a bare sheet name for everything in use. values update expects --values as a JSON array of row arrays, and writes starting at the range's top-left cell.

A .csv/.tsv file is a single sheet named after the file (sales.csv → sales), so --sheets does not apply when creating one and the sheets add/delete/rename commands do not either.

Tab names follow Excel's rules: at most 31 characters, and never : \ / ? * [ ]. A workbook must keep at least one tab.

Renaming or deleting a tab does not update formulas that point at it. If any formula references the tab, the command is refused with the offending cells listed; either fix those formulas first, or pass --force and repair them afterwards. Named ranges and autofilters are handled correctly and never block the command.

Editing an .xlsx rewrites the whole workbook, which cannot preserve charts, pivot tables, form controls, external links, custom XML or sensitivity labels. Writes to such a workbook are refused with a message naming what would be lost; pass --force only if losing those is genuinely acceptable, or copy the values into a new file instead. Plain data workbooks are unaffected.

Successful output is JSON on stdout. Errors are structured JSON on stderr. See the command reference for command shapes, response notes, and examples.

© aai-labs, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in api/domains/agents/aai_cli_skills/bundled/skills/aai-excel of aai-labs/agent-barn.

  • SKILL.md
  • references/command-reference.md

Open the folder on GitHubat commit df5e0a7

Compare with similar skills

aai-cli Spreadsheet Editor next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

aai-cli Spreadsheet Editor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
aai-cli Spreadsheet Editor this skillaai-labs/agent-barn109—~608Automated safety check: PassApache-2.0
Excel Spreadsheet Creation and Editinganthropics/skills180k4 repos~2.1kAutomated safety check: PassProprietary
XLSXrvdbreemen/OTGW-firmware20735 repos~2.9kAutomated safety check: PassProprietary
MinerU Document Readeropendatalab/MinerU81k—~9.4kAutomated safety check: WarnCustom licence
Data Table Managern8n-io/n8n207k—~2.3kAutomated safety check: PassCustom licence
Instrument Data To Allotropeaws-samples/amazon-bedrock-agents-healthcare-lifesciences2742 repos~2.7kAutomated safety check: PassApache-2.0

Similar skills

  • Official

    Creates, edits and analyzes spreadsheets (.xlsx, .xlsm, .csv, .tsv) with openpyxl and pandas, writing live formulas and recalculating to confirm zero formula errors.

    180k GitHub starsUsed in 4 repos~2.1k tokens
    Documents & OfficeAuto-check passed
  • XLSX

    rvdbreemen/OTGW-firmware

    Use this skill any time a spreadsheet file is the primary input or output.

    207 GitHub starsUsed in 35 repos~2.9k tokens
    Documents & OfficeAuto-check passed
  • MinerU Document Reader

    opendatalab/MinerU

    Reads, OCRs, searches and cites local documents through the mineru CLI, covering PDF, images, Office files, EPUB, HTML and CSV.

    81k GitHub stars~9.4k tokensUpdated yesterday
    Documents & OfficeAuto-check: warnings
  • Official

    Load before calling data-tables or parse-file. An agent skill from n8n-io/n8n.

    207k GitHub stars~2.3k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Instrument Data To Allotrope

    aws-samples/amazon-bedrock-agents-healthcare-lifesciences

    Official

    Convert laboratory instrument output files (PDF, CSV, Excel, TXT) to Allotrope Simple Model (ASM) JSON format or flattened 2D CSV.

    274 GitHub starsUsed in 2 repos~2.7k tokens
    Documents & OfficeAuto-check passed
  • Excel Workbook Editor

    HKUDS/DeepTutor

    Reads, creates and edits Excel workbooks with openpyxl, including formulas, styles, charts and CSV or TSV tables, with advice on formula values openpyxl cannot compute.

    41k GitHub stars~1.9k tokensUpdated 2 days ago
    Documents & OfficeAuto-check passed

More from aai-labs/agent-barn

All 12 skills in this repo
  • aai-cli Microsoft 365

    aai-labs/agent-barn

    Guides work with Outlook, OneDrive, SharePoint, Teams, Excel, To Do and Planner through aai-cli's Microsoft Graph commands, starting from which service owns the data.

    109 GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • aai-cli Google Drive

    aai-labs/agent-barn

    Finds, inspects, downloads and uploads Google Drive files from the command line with aai-cli, including exports of Docs, Sheets and Slides, and read-only sharing checks.

    109 GitHub stars~463 tokensUpdated today
    Auto-check passed
  • OpenPanel Analytics Reader

    aai-labs/agent-barn

    Reads OpenPanel analytics through aai-cli: projects, raw event exports, aggregated insights for pages, referrers, devices and geography, and user profiles.

    109 GitHub stars~469 tokensUpdated today
    Auto-check passed
  • Aai Pipedrive

    aai-labs/agent-barn

    Use aai-cli to manage Pipedrive leads, persons, organizations, deals, labels, activities, notes, file attachments, field definitions, users, pipelines and stages, deal flow/stage history, and synced…

    109 GitHub stars~518 tokensUpdated today
    Auto-check passed
  • Aai Bitbucket

    aai-labs/agent-barn

    Use aai-cli to inspect and manage Bitbucket repositories, pull requests, branches, commits, source files, comments, and pipelines.

    109 GitHub stars~256 tokensUpdated today
    Auto-check passed
  • Aai Confluence

    aai-labs/agent-barn

    Use aai-cli to inspect and manage Confluence spaces, pages, comments, attachments, and page moves.

    109 GitHub stars~199 tokensUpdated today
    Auto-check passed

Works with

Questions about aai-cli Spreadsheet Editor

What does aai-cli Spreadsheet Editor do?

Uses aai-cli to create and edit local Excel and CSV files, manage sheet tabs and read, update or clear cell ranges. The skill works on local files through `aai-cli excel`, with no account, profile or credentials involved.csv` before editing.

When should I use aai-cli Spreadsheet Editor?

aai-cli Spreadsheet Editor fits situations like: creating a new spreadsheet file from the command line; reading or updating cell ranges in an .xlsx or .csv file; adding, renaming or deleting sheet tabs in a workbook.

How do I install aai-cli Spreadsheet Editor in Claude Code?

Run `npx skills add aai-labs/agent-barn --skill aai-excel -a claude-code`. Or copy the skill folder (api/domains/agents/aai_cli_skills/bundled/skills/aai-excel in aai-labs/agent-barn) into .claude/skills/aai-excel in your project. Claude Code loads it when a task matches its description.

How do I install aai-cli Spreadsheet Editor in Codex?

Run `npx skills add aai-labs/agent-barn --skill aai-excel -a codex`. Or copy the skill folder (api/domains/agents/aai_cli_skills/bundled/skills/aai-excel in aai-labs/agent-barn) into .agents/skills/aai-excel in your project. Codex loads it when a task matches its description.

Can I use aai-cli Spreadsheet Editor in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aai-labs/agent-barn --skill aai-excel -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/aai-excel, .gemini/skills/aai-excel, .github/skills/aai-excel and .opencode/skills/aai-excel in your project.

What does aai-cli Spreadsheet Editor need to run?

SKILL.md names no scripts, command-line tools or credentials: aai-cli Spreadsheet Editor is instructions for the agent only. Our summary lists: aai-cli installed and available on the command line.

Does aai-cli Spreadsheet Editor access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is aai-cli Spreadsheet Editor safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does aai-cli Spreadsheet Editor use?

aai-cli Spreadsheet Editor is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does aai-cli Spreadsheet Editor use?

About 608 tokens (SKILL.md is roughly 2.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.6k tokens, read only when the agent opens those files.

What are the alternatives to aai-cli Spreadsheet Editor?

Skills that share tags, products or a category with aai-cli Spreadsheet Editor: Excel Spreadsheet Creation and Editing (anthropics/skills, 180k stars), XLSX (rvdbreemen/OTGW-firmware, 207 stars), MinerU Document Reader (opendatalab/MinerU, 81k stars) and Data Table Manager (n8n-io/n8n, 207k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains aai-cli Spreadsheet Editor?

aai-labs (a GitHub organization) maintains it in aai-labs/agent-barn, which has 109 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 9, 2026.

Source: aai-labs/agent-barn on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.