API ReferenceIcons

GitHubdream-num/univer

Univer SheetsUniver DocsUniver SlidesUniver ProRecipesAI Skills

Installation

GitHubEdit on GitHub

Install all skills with one command:

npx skills add dream-num/univer-sdk-skills

Install a specific skill:

npx skills add dream-num/univer-sdk-skills --skill univer-integrate
npx skills add dream-num/univer-sdk-skills --skill univer-plugin-dev
npx skills add dream-num/univer-sdk-skills --skill univer-pro-integrate
npx skills add dream-num/univer-sdk-skills --skill univer-node-backend

Install globally (available across all projects):

npx skills add dream-num/univer-sdk-skills --global

For project-local installs, skills.sh auto-detects your agent and copies skills to the correct directory.

Manual install

Clone the repository and symlink or copy the skill directories into your agent's skills folder:

git clone https://github.com/dream-num/univer-sdk-skills.git
cd univer-sdk-skills

# Symlink (recommended for development)
ln -s $(pwd)/skills/univer-integrate ~/.codex/skills/univer-integrate
ln -s $(pwd)/skills/univer-plugin-dev ~/.codex/skills/univer-plugin-dev
ln -s $(pwd)/skills/univer-pro-integrate ~/.codex/skills/univer-pro-integrate
ln -s $(pwd)/skills/univer-node-backend ~/.codex/skills/univer-node-backend

# Or copy
# cp -r skills/univer-integrate ~/.codex/skills/
# cp -r skills/univer-plugin-dev ~/.codex/skills/
# cp -r skills/univer-pro-integrate ~/.codex/skills/
# cp -r skills/univer-node-backend ~/.codex/skills/

Agent skills directories

AgentSkills Directory
OpenAI Codex~/.codex/skills/
Claude Code~/.claude/skills/
Cursor~/.cursor/skills/
Gemini CLI~/.gemini/skills/
Kimi Code CLI~/.kimi/skills/
Universal (any agent)~/.agents/skills/

For project-local installation, use the agent-specific directory inside your project root (e.g., .codex/skills/, .claude/skills/, .agents/skills/).

Validation

After installing skills, run validation:

# If your agent CLI provides a built-in validator (e.g. Codex):
python3 ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/univer-integrate
python3 ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/univer-plugin-dev
python3 ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/univer-pro-integrate
python3 ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/univer-node-backend

# Or use the standalone check script in this repo:
python3 scripts/validate.py skills/univer-integrate
python3 scripts/validate.py skills/univer-plugin-dev
python3 scripts/validate.py skills/univer-pro-integrate
python3 scripts/validate.py skills/univer-node-backend

Forward-testing

To verify a skill works on realistic tasks:

cd ~/univer-sdk-skills
# Test scaffold script
npx tsx skills/univer-plugin-dev/scripts/scaffold-plugin.ts test-plugin --path /tmp

How is this guide?

Table of Contents

Install via skills.sh (recommended)
Manual install
Agent skills directories
Validation
Forward-testing
Capalyze