office-artifacts

Create, read, and edit LibreOffice ODF and OOXML office documents with the office_artifact tool.

19.1k|3.8k|Updated Jun 10, 2024
One-click install
npx skills add https://github.com/agent0ai/agent-zero --skill office-artifacts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: office-artifacts
Source: https://github.com/agent0ai/agent-zero/tree/main/plugins/_office/skills/office-artifacts
Command: npx skills add https://github.com/agent0ai/agent-zero --skill office-artifacts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Working with real Office files (ODT, ODS, ODP, DOCX, XLSX, PPTX) requires structured operations that plain text editing cannot handle, such as writing spreadsheet cells, building slides, and embedding charts. This Skill gives the agent a consistent workflow for creating, reading, and editing genuine Office packages in LibreOffice Desktop without mishandling formats or opening UI surfaces the user did not request.

Core Features & Use Cases

  • Format-aware document handling: Uses ODF (ODT/ODS/ODP) as the first-class format and switches to DOCX/XLSX/PPTX only when OOXML compatibility is explicitly needed.
  • Structured edit operations: Supports set_text, append_text, replace_text, set_cells, append_rows, set_slides, append_slide, and create_chart for embedded XLSX charts.
  • Version control: Provides version_history and restore_version actions to audit or roll back saved changes.
  • Use Case: Ask the agent to build a budget spreadsheet; it creates an ODS file, writes real cells from CSV or Markdown table content, and can later add a line chart or update specific cells by address.

Quick Start

Ask the agent to create an ODS spreadsheet named Budget with monthly revenue figures and then add a line chart of the data.

Frequently Asked Questions about office-artifacts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an Office document with the office_artifact tool?

Call office_artifact with action create, a kind such as document, a title, a format like odt, and initial content. For spreadsheets, content can be CSV, TSV, or a Markdown table and the tool writes real cells rather than text blobs.

How do I edit cells in an ODS or XLSX spreadsheet?

Use the edit action with operation set_cells and provide a cells map such as {"Sheet1!B2": 12500}. You can reference the file by file_id from prior tool output or by its full path.

Should I use ODF or DOCX/XLSX/PPTX formats?

ODF formats (ODT, ODS, ODP) are first-class and preferred by default. Use DOCX, XLSX, or PPTX only when the user explicitly requests OOXML compatibility or provides an existing file in that format.

Can I add charts to Excel XLSX files?

Yes, the create_chart operation supports embedded charts in XLSX workbooks, including line, bar, column, pie, area, scatter, stock, ohlc, and candlestick types. Provide data_range, categories, position, and optional title and dimensions.

Does editing an office file open the Desktop UI automatically?

No. Creating or editing an artifact saves the file and updates its state without opening the Desktop surface. The open action or open_in_desktop options are used only when the user explicitly asks to view the document.

When should I use text_editor instead of office_artifact?

Use text_editor for Markdown and plain text writing where no binary Office format is requested. Reserve office_artifact for deliverables that must be real Office packages like ODT, ODS, or ODP files.