Oda's Office skills build Word, Excel and PowerPoint files in your workspace, and check a finished file before you open it. This page covers what the skills make, what each check confirms, and what the check cannot tell you.
office-docx
for Word, office-pptx for PowerPoint and office-xlsx for Excel. If the file needs your
company's data, get the numbers into the chat first.Each skill brings the rules for its kind of file: reports, letters and formatted tables in Word; slide decks with text, tables, images and charts in PowerPoint; workbooks with cell values, formulas and formatting in Excel. The user-level flow, from asking for a file to receiving it, is in Company data, documents and reports, and the skills that ship with Oda are in Bundled skills.
Oda can check a finished file before you open it. Ask in the chat, for example Check that the report contains the payment terms or Check that the presentation has 12 slides.
The check is read-only: it reads the file's structure, never changes the file and never renders it.
It covers Word, Excel and PowerPoint files (., . and .) and reports these checks:
| Check | What it confirms |
|---|---|
package | The file is a readable Office package, and its parts and relationships are present. |
contains | The text you asked it to find is in the file, as a text presence check (--contains TEXT). |
count | The number of slides or sheets, when you ask for a count (--count N). |
output | The check's report was saved. |
The check answers with a report: a verdict of pass or fail, the individual checks with their statuses, and a summary of what the file contains.
pass when every check passed and fail when one did not.skipped instead of a pass or fail.formulas_evaluated: False records that formula results were not calculated.A wrong request is refused with a message that names the rule behind it:
input must be ..--count must be non-negative and applies only to slides or sheets.--out must differ from the input document.The check is structural, so it does not judge:
A passing check says the file's structure and text are in order. Open the file to see how it looks.
The check runs on Oda's bundled runtime, not on software already installed on your computer. It needs Python 3.9 or later, and it uses only the Python standard library, so nothing extra is installed for it.
The first document task prepares the runtime, and the chat shows a step called Load workspace dependencies; later tasks reuse it. The details, and what happens if the copy cannot be prepared, are in Bundled Python and Node.js.
Yes. Name the file, or mention it with @, and ask for the check. The check reads the file as it is and never changes it.
Word, Excel and PowerPoint files: ., . and .. Older, encrypted and macro-enabled
files need their own workflow, and renaming a file does not convert it, so save or export the file
as a modern format first.
No. The check is structural and never renders the file: pagination, clipped text, fonts and chart appearance are outside it. Open the file to see the result.
No. Counting applies to slides or sheets only, and a request to count a Word file is refused with
--count must be non-negative and applies only to slides or sheets.
No. The report records formulas_evaluated: False. A formula cell can look empty or stale in
another tool until the workbook is opened and recalculated in Excel.
In a file of its own, separate from the document. The check never writes over the file it reads, and
a request that would do so is refused with --out must differ from the input document.
No. The check runs on Oda's bundled runtime, which includes Python 3.9 or later, and nothing is installed into your own setup. See Bundled Python and Node.js.
The report names the check that failed and what it found. Ask Oda to fix the file and check it again.