---
slug: "skills-dream-num"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/dream-num/skills@main/README.md"
repo: "https://github.com/dream-num/skills"
source_file: "README.md"
branch: "main"
---
# Univer CLI Skill

![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)
![Skills](https://img.shields.io/badge/skills-1-0a7ea4.svg)
![Support](https://img.shields.io/badge/support-Claude%20Code%20%7C%20Codex%20%7C%20Cursor-1f6feb.svg)
![OS](https://img.shields.io/badge/os-Linux%20%7C%20macOS-555.svg)

Languages: [English](https://github.com/dream-num/skills/blob/HEAD/README.md) | [简体中文](https://github.com/dream-num/skills/blob/HEAD/README.zh-CN.md)

The official Univer CLI Skill for Claude Code, Codex, and Cursor. Give your agent a `.univer`
file and describe the result you want; the Skill guides it through authoring, verification, and
visual review with Univer CLI.

Learn more about Univer at [univer.ai](https://univer.ai).

## What You Can Do

- **Build spreadsheets** — edit values and formulas, apply formatting, and work with tables,
  charts, and shapes.
- **Create documents and slides** — author rich content, arrange layouts, and review rendered
  output.
- **Manage structured data** — create Base tables, fields, records, and views.
- **Use an open canvas** — create Board canvases and add visual elements.
- **Work safely with agents** — isolate changes in worktrees, read back stored models, and hand off
  a browser review link.
- **Exchange Excel files** — import and export `.xlsx` while keeping the working model in a
  structured `.univer` file.

## Version-Matched Guidance

This repository installs the Univer CLI entry Skill. It guides agents to load core guidance and the
relevant Unit Skill from your installed CLI, keeping commands and Facade APIs aligned with that
version.

The available Unit Skills cover Sheet, Doc, Slide, Base, and Board:

```bash
univer skills list
univer skills get core
univer skills get board
```

## Install

Install Univer CLI:

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

Install the Skill:

```bash
npx skills add dream-num/skills
```

### Manual installation

```bash
git clone https://github.com/dream-num/skills.git
cd skills

# Claude Code
mkdir -p ~/.claude/skills
cp -R skills/univer-cli ~/.claude/skills/

# Codex
mkdir -p ~/.codex/skills
cp -R skills/univer-cli ~/.codex/skills/

# Cursor
mkdir -p ~/.cursor/skills
cp -R skills/univer-cli ~/.cursor/skills/
```

## Example Prompts

```text
Use univer-cli to inspect this .univer file and update the formulas and formatting on its pricing sheet.
```

```text
Use univer-cli to create a Board, insert a shape, and open the viewer for review.
```

```text
Use univer-cli to create a Base with a contacts table, add a record, and verify the stored model.
```

## Requirements

- Linux or macOS
- Node.js and npm
- Univer CLI available as `univer`

## Contributing

- The entry Skill lives at [`skills/univer-cli/SKILL.md`](https://github.com/dream-num/skills/blob/HEAD/skills/univer-cli/SKILL.md).
- Version-matched operational Skills and resources ship with the Univer CLI package.
- Run `npm run validate` before publishing Skill changes.

## License

This repository is licensed under the [Apache-2.0 License](https://github.com/dream-num/skills/tree/HEAD/LICENSE).