Skip to content
Skills Library
Documents & office · Automation

univer-cli

/univer-cli

Use when installing or operating Univer CLI for .univer files, spreadsheets, documents, slides, Base databases, Board canvases, cross-Unit embedding, worktrees, Facade authoring, inspection, verification, import/export, screenshots, or viewer handoff.

Repository
skills ↗
Licence
Apache-2.0
Last repository change
14.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 14.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

Use when installing or operating Univer CLI for .univer files, spreadsheets, documents, slides, Base databases, Board canvases, cross-Unit embedding, worktrees, Facade authoring, inspection, verification, import/export, screenshots, or viewer handoff.

Original author description

Use when installing or operating Univer CLI for .univer files, spreadsheets, documents, slides, Base databases, Board canvases, cross-Unit embedding, worktrees, Facade authoring, inspection, verification, import/export, screenshots, or viewer handoff.

How it works

  1. Keep the CLI current
  2. Start here
  3. Core Model
  4. Unit Skills
  5. Task Routing
  6. Why Univer CLI
  7. Diagnose
Original SKILL.md headings · 121 lines, 682 words
SKILL.md preview
---
name: univer-cli
description: "Use when installing or operating Univer CLI for .univer files, spreadsheets, documents, slides, Base databases, Board canvases, cross-Unit embedding, worktrees, Facade authoring, inspection, verification, import/export, screenshots, or viewer handoff."
hidden: true
---

# Univer CLI

Terminal-native authoring and inspection for multi-Unit `.univer` files. The CLI provides isolated
worktrees, version-matched Facade guidance, model readback, and browser review.

Install:

```bash
npm install -g univer-cli
univer doctor
```

## Keep the CLI current

Use these commands to compare the installed CLI with the latest public release:

```bash
univer --version
npm view univer-cli@latest version --registry=https://registry.npmjs.org/
```

When a newer version is available, complete the current Univer task before updating:

```bash
univer update
univer doctor --json
univer skills get core
```

If `univer update` reports that the shared daemon must stop, rerun it with `--force` after confirming
that stopping the daemon is safe. Reload core and the target Unit Skill after every update.

## Start here

This file is the discovery entry, not the operational guide. Before using Univer commands for a
task, load the complete core Skill from the installed CLI:

```bash
univer skills get core          # shared model, workflow, evidence, and handoff
univer skills get core --full   # include direct references and templates
```

Runtime Skills ship with the CLI so their commands and Facade APIs match the installed version.

## Core Model

- A `.univer` path is the authoritative multi-Unit target. Always address the file explicitly.
- A Unit is a top-level Sheet, Doc, Slide, Base, or Board identified by `unitId`; sheet names, pages,
  tables, ranges, shapes, and records live inside that Unit.
- `trunk` is the reviewed main line. A worktree is an isolated scope for agent changes; there is no
  implicit current worktree.
- Command success is not correctness evidence. Read back the target model, verify task-specific
  assertions, and inspect rendered output when appearance matters.

Use public CLI and Facade surfaces. The worktree commit path is the durable write boundary, and
merge remains an explicit review decision.

## Unit Skills

After core, load the Skill matching the target top-level Unit before authoring:

```bash
univer skills get sheet
univer skills get doc
univer skills get slide
univer skills get base
univer skills get board
```

Use `univer skills list` to discover the installed set. Each Unit Skill owns its creation recipe,
Facade entrypoints, readback guidance, and visual verification requirements.

For cross-Unit composition, load the additional Topic Skill after the host and child Unit Skills:

```bash
univer skills get embed
```

For a cross-Unit formula in a Sheet cell or formula-driven Shape, load its Topic Skill after the
Host and Sheet or Base Source Unit Skills:

```bash
univer skills get cross-unit-formula
```

## Task Routing

| Task | Load and use |
| --- | --- |
| Inspect or edit spreadsheet values, formulas, formatting, charts, or tables | core + `sheet` |
| Create or refine document paragraphs, rich text, tables, charts, or page layout | core + `doc` |
| Build or review presentation pages, shapes, text, or images | core + `slide` |
| Create or edit structured Base tables, fields, records, or views | core + `base` |
| Create or edit a Board canvas, charts, and other elements | core + `board` |
| Embed one Unit inside another Unit | core + host Unit + child Unit + `embed` |
| Read a Sheet range or Base table column from a Sheet cell or formula-driven Shape | core + Host Unit + Source Unit + `cross-unit-formula` |

## Why Univer CLI

- One `.univer` target can contain Sheet, Doc, Slide, Base, and Board Units addressed by `unitId`.
- Worktrees isolate agent changes until review and merge.
- Offline `api show` / `api find` resolves exact Facade symbols for the installed SDK.
- Runtime readback and the viewer verify the stored model and rendered result.
- Import/export and screenshots use the product runtime rather than unrelated file writers.

Do not edit `.univer` storage directly or substitute unrelated writers. Follow the loaded core and
Unit Skills for the supported path.

## Diagnose

```bash
univer --help
univer doctor
univer skills list
univer skills path
```

Use `univer help <command>` for exact syntax. If the CLI is unavailable or `doctor` reports a
blocking runtime failure, stop and report the diagnostic instead of switching tools.

Versions

The database has no other skills named univer-cli.

Database snapshot: 13.11.2026 · package version a64f94badea6 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100univer-workspace-cli
    Use when installing or operating the independent Univer Workspace CLI application (`univer-workspace-cli`) for remote Workspace files, Personal or Team Spaces, task Worktrees, Sheet/Doc/Slide/Base/Board Units, Facade authoring, inspection, verification, import/export,…
  • 100univer-integrate
    Integrate Univer Sheets, Docs, or Slides into React, Vue 3, HTML, or Node.js projects. Use when embedding Univer, choosing preset or plugin mode, initializing instances, configuring themes/locales/workers, or manipulating workbooks, worksheets, ranges, formulas, permissions, and…
  • 95google
    Google Workspace CLI for Gmail, Calendar, Drive, Docs, Sheets, and Slides using gogcli. Use when asked to search email, schedule meetings, manage files, edit documents, update spreadsheets, or create presentations.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.