Agent skill

Excel Workbook

by adongwanai in adongwanai/learn-workbuddy

使用此 Skill 创建、检查、编辑和验证 XLSX 工作簿。用户提到 Excel、xlsx、工作簿、工作表、表格,或要求修改、汇总、检查 Excel 文件时使用。只支持基础 XLSX 操作,不处理宏、VBA、图表、数据透视表或外部工作簿引用。

MITAuto-check: notesDocuments & Office

Install Excel Workbook

skills CLI
$ npx skills add adongwanai/learn-workbuddy --skill excel-workbook -a claude-code

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

GitHub CLI
$ gh skill install adongwanai/learn-workbuddy excel-workbook --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/adongwanai/learn-workbuddy.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/excel-workbook .claude/skills/excel-workbook && 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
excel-workbook
GitHub stars
415
Token cost
~597 tokens
SKILL.md length
75 words
Files
2 (incl. scripts)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

使用此 Skill 创建、检查、编辑和验证 XLSX 工作簿。用户提到 Excel、xlsx、工作簿、工作表、表格,或要求修改、汇总、检查 Excel 文件时使用。只支持基础 XLSX 操作,不处理宏、VBA、图表、数据透视表或外部工作簿引用。

  • Works in 6 steps: 先检查,再修改。 → 默认不覆盖原文件;编辑时输入文件和输出文件必须是不同路径。 → 修改现有模板时,只改用户指定的单元格或区域,不重建整个工作簿。 → …
  • Tasks that involve Excel spreadsheets
  • SKILL.md covers 支持范围, 工作原则, 工具脚本 and 重算边界, plus 1 more section
  • Runs Python scripts from its folder

What it does

Excel Workbook is an agent skill from adongwanai/learn-workbuddy. 使用此 Skill 创建、检查、编辑和验证 XLSX 工作簿。用户提到 Excel、xlsx、工作簿、工作表、表格,或要求修改、汇总、检查 Excel 文件时使用。只支持基础 XLSX 操作,不处理宏、VBA、图表、数据透视表或外部工作簿引用。

Its SKILL.md is about 600 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/workbook_tool.py`).

It sits in Documents & Office, covering Excel spreadsheets. It works with Microsoft Excel, DeepSeek, OpenAI and Python. The repository describes itself as: 从 0 复刻 WorkBuddy-style 桌面 AI 助手 Harness:24 章 Python 教程,覆盖 Agent Loop、工具调用、记忆系统、Sidecar、沙盒审计、DeepSeek/OpenAI 评测轨迹. The licence is MIT.

When your agent uses it

  • Tasks that involve Excel spreadsheets

Example prompts

  • “/excel-workbook”

Requirements

  • Python 3
  • Pre-approved tools (allowed-tools): Bash

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. 先检查,再修改。
  2. 默认不覆盖原文件;编辑时输入文件和输出文件必须是不同路径。
  3. 修改现有模板时,只改用户指定的单元格或区域,不重建整个工作簿。
  4. 日期、数字和公式要保持正确的数据类型。公式字符串被写入不等于公式已经计算。
  5. 修改后必须重新打开输出文件并验证。
  6. 没有 Excel、WPS 或 LibreOffice 重算结果时,不要声称公式结果已经验证。

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    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

Excel Workbook loads about 597 tokens when it runs. Until then it costs about 34 tokens; SKILL.md has 75 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~34
When it runs · the whole SKILL.md, loaded when a task matches
~597

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash

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); the scripts in this folder are not scanned.

SKILL.md

The full file from adongwanai/learn-workbuddy at commit 3889dd1, republished under its MIT licence (© adongwanai). 75 words, ~597 tokens.

Download SKILL.mdSave it as .claude/skills/excel-workbook/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
excel-workbook
description
使用此 Skill 创建、检查、编辑和验证 XLSX 工作簿。用户提到 Excel、xlsx、工作簿、工作表、表格,或要求修改、汇总、检查 Excel 文件时使用。只支持基础 XLSX 操作,不处理宏、VBA、图表、数据透视表或外部工作簿引用。
allowed-tools
Bash

Excel 工作簿基础操作

当用户要求创建、检查、编辑或验证 .xlsx 文件时使用本 Skill。

支持范围

支持以下基础操作:

  • 检查工作簿、工作表、行列范围、公式、日期和合并单元格;
  • 创建包含表头、数据和简单公式的新工作簿;
  • 编辑单元格、追加行和基础数字格式;
  • 保留已有工作表、公式、日期、数据类型和未修改区域的基础样式;
  • 重新打开输出文件,验证关键内容;
  • 设置 Excel/WPS 打开文件时自动重算的标记。

当前版本只支持 .xlsx。不处理 .xlsm 宏、VBA、图表、数据透视表、 Power Query、外部工作簿引用或复杂财务模型。

工作原则

  1. 先检查,再修改。
  2. 默认不覆盖原文件;编辑时输入文件和输出文件必须是不同路径。
  3. 修改现有模板时,只改用户指定的单元格或区域,不重建整个工作簿。
  4. 日期、数字和公式要保持正确的数据类型。公式字符串被写入不等于公式已经计算。
  5. 修改后必须重新打开输出文件并验证。
  6. 没有 Excel、WPS 或 LibreOffice 重算结果时,不要声称公式结果已经验证。

工具脚本

脚本位于当前 Skill 的 scripts/workbook_tool.py:

text
python scripts/workbook_tool.py inspect input.xlsx
python scripts/workbook_tool.py create output.xlsx --spec spec.json
python scripts/workbook_tool.py edit input.xlsx output.xlsx --operations operations.json
python scripts/workbook_tool.py validate output.xlsx --expect expectations.json
python scripts/workbook_tool.py recalc output.xlsx

所有命令默认输出 JSON,便于继续检查和记录。

创建数据格式

create 的 spec 使用以下结构:

json
{
  "sheet": "销售数据",
  "headers": ["日期", "商品", "金额", "含税金额"],
  "rows": [
    [
      {"date": "2026-09-16"},
      "A",
      100,
      {"formula": "=C2*1.1"}
    ]
  ],
  "column_widths": {"A": 14, "C": 12, "D": 14}
}

日期使用 {"date": "YYYY-MM-DD"},公式使用 {"formula": "=..."}。

编辑数据格式

edit 的 operations 使用以下结构:

json
{
  "set_cells": [
    {"sheet": "销售数据", "cell": "C2", "value": 120},
    {"sheet": "销售数据", "cell": "D2", "formula": "=C2*1.1"},
    {"sheet": "销售数据", "cell": "A2", "date": "2026-09-17"}
  ],
  "append_rows": [
    {
      "sheet": "销售数据",
      "values": [{"date": "2026-09-18"}, "B", 80, {"formula": "=C3*1.1"}]
    }
  ],
  "number_formats": [
    {"sheet": "销售数据", "cell": "C2", "format": "#,##0.00"}
  ]
}
验证数据格式

validate 的 expectations 使用以下结构:

json
{
  "sheets": ["销售数据"],
  "cells": {
    "销售数据!C2": 120,
    "销售数据!D2": "=C2*1.1",
    "销售数据!A2": {"date": "2026-09-17"}
  },
  "required_formulas": ["销售数据!D2"]
}

重算边界

recalc 会先设置:

text
calcMode=auto
fullCalcOnLoad=true
forceFullCalc=true

如果本机存在 LibreOffice,脚本会尝试执行无界面重算;否则返回 unavailable,并明确说明只设置了 Excel/WPS 打开时重算标记。

交付格式

完成后说明:

text
输入文件:
输出文件:
执行操作:
保留内容:
验证结果:
未完成的检查:

© adongwanai, MIT. 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 (scripts) in skills/excel-workbook of adongwanai/learn-workbuddy.

  • SKILL.md
  • scripts/workbook_tool.py

Open the folder on GitHubat commit 3889dd1

Compare with similar skills

Excel Workbook 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.

Excel Workbook compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Excel Workbook this skilladongwanai/learn-workbuddy415—~597Automated safety check: NotesMIT
Markitdownaipoch/medical-research-skills1.9k—~1.3kAutomated safety check: PassMIT
Openai Spreadsheettrailofbits/skills-curated513—~1.3kAutomated safety check: NotesCC-BY-SA-4.0
XLSXrvdbreemen/OTGW-firmware20735 repos~2.9kAutomated safety check: PassProprietary
PipesHub Excel Spreadsheet Builderpipeshub-ai/pipeshub-ai3.8k—~1.8kAutomated safety check: PassApache-2.0
Documentszhongkaifu/TensorSharp563—~4.2kAutomated safety check: PassBSD-3-Clause

Similar skills

  • Markitdown

    aipoch/medical-research-skills

    Convert files and Office documents into clean Markdown when you need LLM-friendly, token-efficient text (e.g., for summarization, search, RAG ingestion, or dataset preparation).

    1.9k GitHub stars~1.3k tokensUpdated 23 days ago
    Documents & OfficeAuto-check passed
  • Openai Spreadsheet

    trailofbits/skills-curated

    Official

    A skill your agent uses when tasks involve creating, editing, analyzing, or formatting spreadsheets (.xlsx, .csv, .tsv) using Python (openpyxl, pandas), especially when formulas, references, and…

    513 GitHub stars~1.3k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check: notes
  • 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
  • PipesHub Excel Spreadsheet Builder

    pipeshub-ai/pipeshub-ai

    Creates and edits .xlsx workbooks with real Excel formulas rather than hardcoded computed values, defaulting to exceljs in TypeScript with a static formula-safety check.

    3.8k GitHub stars~1.8k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Documents

    zhongkaifu/TensorSharp

    Read and write real documents on the device - PDF, XLSX, DOCX, PPTX and CSV.

    563 GitHub stars~4.2k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Mineru

    Nebutra/MinerU-Skill

    An AI-Native skill for parsing PDF / Office / image files into clean Markdown with MinerU — a fast, zero-config document parser for AI agents.

    123 GitHub stars~1.4k tokensUpdated 16 days ago
    Documents & OfficeAuto-check passed

Questions about Excel Workbook

What does Excel Workbook do?

使用此 Skill 创建、检查、编辑和验证 XLSX 工作簿。用户提到 Excel、xlsx、工作簿、工作表、表格,或要求修改、汇总、检查 Excel 文件时使用。只支持基础 XLSX 操作,不处理宏、VBA、图表、数据透视表或外部工作簿引用。. Excel Workbook is an agent skill from adongwanai/learn-workbuddy.

When should I use Excel Workbook?

Excel Workbook fits situations like: tasks that involve Excel spreadsheets.

How do I install Excel Workbook in Claude Code?

Run `npx skills add adongwanai/learn-workbuddy --skill excel-workbook -a claude-code`. Or copy the skill folder (skills/excel-workbook in adongwanai/learn-workbuddy) into .claude/skills/excel-workbook in your project. Claude Code loads it when a task matches its description.

How do I install Excel Workbook in Codex?

Run `npx skills add adongwanai/learn-workbuddy --skill excel-workbook -a codex`. Or copy the skill folder (skills/excel-workbook in adongwanai/learn-workbuddy) into .agents/skills/excel-workbook in your project. Codex loads it when a task matches its description.

Can I use Excel Workbook 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 adongwanai/learn-workbuddy --skill excel-workbook -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/excel-workbook, .gemini/skills/excel-workbook, .github/skills/excel-workbook and .opencode/skills/excel-workbook in your project.

What does Excel Workbook need to run?

Going by SKILL.md and its folder, Excel Workbook needs Python for the scripts in its folder. Our summary lists: Python 3. Its frontmatter pre-approves these tools: Bash.

Does Excel Workbook 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 Excel Workbook safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Excel Workbook use?

Excel Workbook is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Excel Workbook use?

About 597 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.

What are the alternatives to Excel Workbook?

Skills that share tags, products or a category with Excel Workbook: Markitdown (aipoch/medical-research-skills, 1.9k stars), Openai Spreadsheet (trailofbits/skills-curated, 513 stars), XLSX (rvdbreemen/OTGW-firmware, 207 stars) and PipesHub Excel Spreadsheet Builder (pipeshub-ai/pipeshub-ai, 3.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Excel Workbook?

adongwanai (a GitHub user) maintains it in adongwanai/learn-workbuddy, which has 415 GitHub stars. The repository was last updated on October 10, 2026.

Source: adongwanai/learn-workbuddy on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.