К основному содержанию
скилл CX Codex

genoffice — скилл для Claude Code: что делает и как установить

Скилл для Claude Code для создания и правки офисных файлов через локальный CLI GenOffice. Собирает презентации и таблицы из данных и меняет форматы документов.

Apache-2.0 ★ 12 746 обновлён 2026-11-11

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add genspark-ai/genoffice --skill genoffice -a claude-code
Открыть на GitHub

Что делает genoffice

Через утилиту genoffice агент собирает презентации pptx по плану и постраничной спецификации, таблицы xlsx с формулами из CSV или JSON и файлы docx из Markdown или HTML. Поддерживается также экспорт в PDF и конвертация между pdf, docx, xlsx, pptx, md, html и csv. Структуру готовых документов читает команда genoffice info <file>.

Внутри всё работает без запуска графического окна на движках самого GenOffice, а флаг --json выдаёт машине структурированный ответ со статусом и кодами выхода от 0 до 4. Почти все операции идут локально. Только команды search, image и media отправляют запрос или файл внешнему провайдеру, который задан в настройках GenOffice.

Без установленного приложения GenOffice с CLI версии от 0.9.0 скилл работать не будет и вернёт код 4. Если команды genoffice нет в PATH, путь к ней лежит в файле ~/.genoffice/launcher (на Windows — %USERPROFILE%\.genoffice\launcher). Ещё одна жёсткая деталь: если целевой файл уже открыт в окне GenOffice или путь вывода занят, запись прервётся с кодом 2.

Какие задачи решает

  • Собрать презентацию pptx из текстового брифа с проверкой структуры каждого слайда
  • Сформировать таблицу xlsx с формулами на основе данных из CSV или JSON
  • Перевести файлы между форматами pdf, docx, xlsx, pptx, md, html и csv
  • Прочитать оглавление и структуру готового документа и внести в него правки

Примеры запросов агенту

  • Собери презентацию deck.pptx по этому брифу с планом слайдов и открой её в GenOffice.
  • Сделай из sales.csv таблицу report.xlsx с формулами итогов по месяцам.
  • Вытащи структуру из contract.docx, обнови второй раздел и конвертируй результат в PDF.

Как установить genoffice

1Через Skills CLI (Vercel)

npx skills add genspark-ai/genoffice --skill genoffice -a claude-code

2Вручную: положить файлы

~/.claude/skills/genoffice/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/genoffice/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о genoffice

Как установить genoffice в Claude Code?

Выполните команду npx skills add genspark-ai/genoffice --skill genoffice -a claude-code. Для работы самого инструмента на компьютере должно быть установлено приложение GenOffice с CLI версии от 0.9.0.

Что делает скилл genoffice?

Он даёт агенту доступ к CLI GenOffice для создания pptx, xlsx, docx и PDF, чтения структуры готовых файлов и их точечного редактирования. Скилл также конвертирует документы между pdf, docx, xlsx, pptx, md, html и csv.

Отправляет ли genoffice документы в облако при работе?

Создание, чтение, правка и конвертация файлов выполняются локально на движках приложения GenOffice. Исключение — команды search, image и media, которые передают запрос или указанный файл настроенному в GenOffice провайдеру.

Исходный текст

SKILL.md · Apache-2.0
---
name: genoffice
description: Create, convert, read and edit Office documents locally with GenOffice's command line. Build a new presentation (pptx) from a brief through a checked outline, per-page spec and render pipeline, a new spreadsheet (xlsx) from CSV or JSON data with formulas, a new Word document (docx) from Markdown or HTML, or a PDF; convert between pdf, docx, xlsx, pptx, md, html and csv; read the structure and text of an existing file (including the user's own docx / xlsx / pptx as source material) and apply structured edits to it. Use whenever the user asks for a slide deck, presentation, spreadsheet, workbook, report, Word document or any real Office file, a format conversion, a rewrite of part of an existing document, or wants the result opened in the GenOffice editor. Documents are processed locally; only search, image and media send the query or the referenced file to the provider configured in GenOffice.
metadata:
  version: 2.70.0
  cli: '>=0.9.0'
---

# genoffice — GenOffice from the terminal

`genoffice` is installed with GenOffice. Run `genoffice --version` first. If the command is not found, GenOffice writes the launcher directory to `~/.genoffice/launcher` (Windows: `%USERPROFILE%\.genoffice\launcher`) on every start: read that one line and run `"<dir>/genoffice"` from bash or `"<dir>\genoffice.cmd"` from PowerShell / cmd, quoted, in place of `genoffice` below. Default locations when that file is missing: macOS `/Applications/GenOffice.app/Contents/Resources/cli`, Windows `%LOCALAPPDATA%\Programs\GenOffice\resources\cli`, Linux `/opt/GenOffice/resources/cli`. Every command runs headless on the app's own engines; only `search`, `image` and `media` send data off the machine, to the provider configured in GenOffice.

Always add `--json` when a program reads the output: one JSON object on stdout, `{ "status": "ok" | "partial", "command", "summary", "output_path"?, "warnings"?, "detail"? }` (`partial`: an `apply` with `--best-effort` / `--stop-on-error` wrote the file but lost ops) or `{ "status": "error", "code", "error", "message", "suggestion"?, "detail"? }`. Exit codes: `0` ok, `1` usage or rejected ops, `2` file not found / output exists / file open in GenOffice, `3` conversion failed, `4` app not available. `error` is the machine-readable reason (table under "When a command fails"), `suggestion` the next step in one sentence, including `did you mean "…"?` when a command, option, op name, element id or sheet name is one typo away. `detail` carries facts as fields (`failures[]` with `index`, `op`, `error`, `reason`, `valid_range`, `available`, `supported`, `usage`; `sheets`, `options`, `commands`); never parse `message`.

## Commands

| Command                                                                                                                                                                                                                                                          | What it does                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `genoffice info <file> [--password <pw>]`                                                                                                                                                                                                                        | Metadata and structure summary (docx blocks and headings, pptx slides, xlsx sheets, pdf pages)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `genoffice convert <file> --to <fmt> [--out <path>] [--force]`                                                                                                                                                                                                   | `pdf→docx/pptx/xlsx`, `csv→xlsx`, `xls/xlsb/ods→xlsx`, `md→docx/html`, `docx→html/md`, `html→docx`, `xlsx→csv` (`--sheet`), and `docx/xlsx/pptx/md/html→pdf`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `genoffice create --type pptx --ops <file> --out <path>`                                                                                                                                                                                                         | New deck from a list of slide ops                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `genoffice create --type pptx --spec <dir\|file> [--outline <file>] --out <path> [--render [dir]] [--audit]`                                                                                                                                                     | New deck from page spec files (one per slide, name order) or one deck spec file: px-positioned text, shapes and images (the designed-deck path, see below)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `genoffice create --type xlsx --from <data.csv \| table.json> [--header] [--decimal ,] --out <path>`                                                                                                                                                             | New workbook from CSV or a 2-D array / `{sheets:[{name,rows}]}`; `"=..."` cells are formulas; `--header` freezes row 1 and filters the range                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `genoffice create --type docx --from <text.md \| fragment.html> [--no-generator-fields] --out <path>`                                                                                                                                                            | New Word document from Markdown or a restricted-HTML fragment                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `genoffice create --type pdf --from <document> --out <path>`                                                                                                                                                                                                     | PDF printed by the GenOffice renderer from any md/html/docx/xlsx/pptx file                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `genoffice slides read <pptx> [--slide n] [--full \| --max-chars n] [--layouts] [--units in\|cm\|pt\|px]` / `genoffice slides apply <pptx> --ops <file> [--dry-run]`                                                                                             | Inspect ids, geometry (`box` and `size` in EMU, or converted with `unit` named when `--units` is given) and text previews (clipped to 300 characters, ending in `…(+n chars)` with `truncated: true`; `--max-chars` moves the cap, `--full`: whole text, every table row, speaker notes), then edit with ops Text elements carry `effective` (first run's font size/family/color/bold/italic and paragraph align) with `src` naming where each value comes from: `run`, `paragraph defRPr`, `shape lstStyle`, `layout placeholder`, `master placeholder`, `master titleStyle`/`bodyStyle`, `presentation defaultTextStyle`, `theme major`/`minor`; `setFont` writes the run level and overrides all of them, `applyTheme` changes the theme fonts and colors. Elements with a hyperlink carry `link` (`url`, `slide` jump or a PowerPoint `action`: `nextslide` / `previousslide` / `firstslide` / `lastslide` / `lastslideviewed` / `endshow`); `setLink` and `setText` run `link` fields write the same three kinds.                                                                                                                                                      |
| `genoffice slides audit <pptx> [--slide n]` / `genoffice slides render <pptx> --out <dir> [--scale 2]`                                                                                                                                                           | Geometry audit (`out_of_bounds`, `off_slide`, `text_overflow`, `text_overflow_width`, `overlap`, `picture_distorted` = box aspect off the cropped source by >5%): `issues[]` with a `code`, `level`, `path` (`s_n/e_*`) and, except for overlap, a `suggest` `setTransform` op you can pass to `slides apply` as is; one PNG per slide to look at                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `genoffice render <file> --out <dir> [--page n] [--scale 2] [--el e_12 [--pad px]] [--grid [--cols 4] [--tile 320]]`                                                                                                                                             | One PNG per page of a docx, xlsx, pptx, md, html or pdf file, laid out by the GenOffice renderer: look at it before reporting a document or workbook as done; `--el` (pptx) also writes the page cropped to one element (`<stem>-NN-e_12.png`, ids from `slides read`) so a small box is legible; `--grid` also writes every page onto one contact sheet (`<stem>-grid.png`, row-major, tile positions in `grid.tiles`) to see a whole deck at once                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `genoffice slides check <outline.json\|page.json>` / `genoffice slides replace <pptx> --slide n --spec <page.json>`                                                                                                                                              | Validate a deck outline (exit 1 on errors) or build-and-audit one page file and check it against its outline entry and style.md; rebuild one slide from its page file, other slides untouched                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `genoffice sheet read <xlsx> [--sheet name] [--range A1:D20] [--cols A,C:E] [--max-rows n] [--where formula\|error\|empty\|number\|text] [--stats] [--formats]` / `genoffice sheet apply <xlsx> --ops <file> \| --cells <file>` / `genoffice sheet check <xlsx>` | Read a range plus `features` (panes, filter, charts, tables, rule counts for the sheet; merges and links in the range; `--formats` adds cell formats, widths, heights); keep the output small with `--cols` (only those columns, named in `columns`), `--max-rows` (`rowsShown` / `rowsTotal` and a `note` with the `--range` to continue), `--where` (only cells of one kind as `{ref, value, formula}`, no grid) or `--stats` (counts, used range and the sheet list, no cells); edit with the workbook DSL or by cell address; `check` lists formula errors, references to missing sheets, broken defined names, chart ranges off the data, `###` columns (with a `set_col_width` suggestion), placeholder text and existing rules                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `genoffice sheet links <xlsx> [--update] [--break indices]`                                                                                                                                                                                                      | External `[n]` links: list them (stored path, resolved path, whether the file exists, source sheet names); `--update` re-reads reachable sources and writes the computed values as the formulas' cached `<v>` (formula text untouched; unreachable links keep their cache); `--break indices` turns those formulas into their cached literals, removes the links' parts and renumbers the surviving `[m]`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `genoffice docs read <docx> [--range a-b] [--html] [--full \ / `genoffice docs compare <original.docx> <revised.docx> --out <redline.docx> [--author name] [--date <iso>] [--granularity word                                                                    | char] [--ignore formatting,case,whitespace]`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | --max-chars n] [--comments] [--revisions] [--header-footer] [--sections] [--fields] [--notes] [--properties]`/`genoffice docs apply <docx> --ops <file> [--dry-run]`/`genoffice docs check <docx>`; `compare` writes the redline of two documents — the revised one with the differences as tracked insertions and deletions (`--author`, `--date`, `--granularity word | char`, `--ignore formatting,case,whitespace`), which `--json` reports as counts | Read blocks by index (previews are clipped to 200 characters and end in `…(+n chars)` with `truncated: true`; `--max-chars` moves the cap, `--full` lifts it; plus comment threads, tracked changes, header/footer text, page setup per section, fields with their cached results, footnotes/endnotes, document properties), then edit with ops (incl. `set_properties` for the core/app/custom document metadata — custom values may be strings, numbers or booleans, an existing typed property keeps its vt type (i4/i8/r8/bool/filetime/date) when the value fits, and `--properties` also reports each custom value's `customTypes`; a `create --type docx` file carries Word-like docProps/core.xml + app.xml — `wrap_content_control` / `unwrap_content_control` for block-level w:sdt controls — the read items carry `contentControl` (outermost) plus `contentControls` (outer → inner chain) and `inlineContentControls` for run-level controls, and unwrap takes a nested tag too, `applyStyle`, `insertField` for SEQ / REF / DATE / PAGE… fields, `insertBookmark`, `updateFields`), restricted HTML, `insert_image` / `insert_picture` (sized, floating) / `insert_text_box`, `insert_chart` / `edit_chart`, `set_header_footer`, `set_watermark` (text, or a washed-out picture via `image`), `define_style`, `set_page_setup` / `insert_section_break`, `add_comment` / `reply_comment` / `resolve_comment` / `delete_comment`, `accept_changes` / `reject_changes` (selector: `all`, `ids` from `--revisions`, `author`, `type`, `blockIndex`, `blockRange`, `before`; `apply --track [--author name]` records the batch's own edits as tracked changes), `insert_footnote` / `insert_endnote` / `edit_note` / `delete_note`; `--styles` lists style ids; `check` lists fields without results (a fresh TOC), references to missing bookmarks, a TOC that no longer matches the headings, missing images, empty charts or headings, level skips, placeholder text, pending tracked changes and open comments |
| `genoffice merge <template.docx\|pptx\|xlsx> --data <values.json \| inline JSON> --out <path> [--force] [--strict]`                                                                                                                                              | Fill `{{key}}` placeholders in a Word, PowerPoint or Excel template from a JSON object (nested objects flatten to dotted keys `a.b`; whitespace inside the braces is tolerated) through the engines' own find/replace (Word, PowerPoint: text, tables, speaker notes) and typed `set_cell` writes (Excel: a whole-cell placeholder takes the value's type, a number stays a number; substituted text stays text even when it starts with `=`). `detail.used_keys`, `detail.unused_keys` and `detail.unresolved_placeholders[]` (`{placeholder, key, reason: no_key \| split_placeholder \| unreachable_nested, location}` — block index / slide + element id / sheet + cell) tell what happened; unresolved placeholders stay in place with a `unresolved_placeholder` warning unless `--strict` makes them an error. `split_placeholder` = Word split the `{{…}}` over runs with different formatting; retype it in the template in one run (PowerPoint fills a placeholder that spans runs). `unreachable_nested` = inside a nested pptx group (or a table in a group), which deck `findReplace` does not reach; ungroup it. A Word table nothing fills is left untouched |
| `genoffice pdf read <pdf> [--page n \| --range a-b] [--password <pw>] [--full \| --max-chars n]`                                                                                                                                                                 | Text layer of a PDF page by page: 1-based `page`, `width_pt` / `height_pt`, `text` clipped to 4000 characters ending in `…(+n chars)` with `truncated: true` (`--max-chars` moves the cap, `--full` lifts it and reads every page), plus page count, `encrypted` and title / author / producer metadata; without `--page` / `--range` the first 20 pages come back and `detail.truncated` names the rest; scanned pages have empty text (`convert --to docx` runs OCR)...

© genspark-ai · Apache-2.0 · genspark-ai/genoffice

Похожие скиллы

Все скиллы по теме «Документы и офис» →
office-productivity sickn33 Скилл office-productivity проводит агента через семь фаз офисной работы: от документов и таблиц до презентаций и конвертации форматов. CX Codex +1 1 600установок jetformat Jetformat Направляет агента к локальному jetformat для обработки Office-файлов и PDF. Конвертирует Word, Excel и PowerPoint в PDF и извлекает текст. CX Codex ★ 1 596звёзд репо convert-documents-to-markdown firecrawl Скилл convert-documents-to-markdown для Claude Code конвертирует офисные документы, таблицы и PDF в GitHub-Flavored Markdown через утилиту anydoc. Извлекает данные из DOCX и XLSX без ручной вычитки. CX Codex +1 13 700установок office-oxide-mcp Aimino-Tech MCP-сервер office-oxide-mcp на Rust для локальной сборки и редактирования файлов Excel, Word, PowerPoint и PDF. Сервер заполняет бланки и формирует отчёты без сторонних облачных сервисов. CX Codex +1 ★ 165звёзд репо shuck-file Shan-Zhu MCP-сервер shuck-file превращает Word, PDF, Excel, PowerPoint и CSV в чистый Markdown. Большие файлы отдаёт картой разделов, чтобы агент читал только нужное. CX Codex +1 ★ 6звёзд репо doc-extract официальный anthropics Скилл doc-extract для Claude Code конвертирует бинарные документы в чистый текст без сохранения файлов на диск. Агент запускает его при обработке договоров или медицинских вложений в формате PDF, DOCX, XLSX, PPTX, RTF и HTML. CX Codex +1 110установок

Из того же набора65

Весь набор →
table Промпт table для Claude Code редактирует таблицы в презентации: меняет ячейки, размеры, объединения и оформление. Запускается по просьбе изменить существующую таблицу. GP ChatGPT ★ 12 746звёзд репо writing Промпт writing задаёт агенту правила правки таблиц: формулы вместо посчитанных вручную чисел, пакетные операции вместо поячеечных записей. GP ChatGPT ★ 12 746звёзд репо text Задаёт правила изменения и форматирования текста на слайдах через setText и setFont. Редактирует презентации с сохранением стилей. GP ChatGPT ★ 12 746звёзд репо base Промпт base помогает Claude Code читать и менять книги в совместимом с Excel приложении через инструменты. Он пригодится для правок таблиц, анализа данных и создания документов. GP ChatGPT ★ 12 746звёзд репо slide Промпт slide для Claude Code, описывает страничные операции презентации: удалить, продублировать, вставить по макету, перенести, сменить фон. Правит колоды из чата. GP ChatGPT ★ 12 746звёзд репо insert Промпт insert задаёт правила вставки блоков, фигур и коннекторов на слайды презентаций. Он нужен для точного позиционирования элементов через команды genoffice. GP ChatGPT ★ 12 746звёзд репо system Промпт system задаёт правила для создания презентаций и редактирования слайдов в GenOffice Slides. Он пригодится, если вы хотите, чтобы ассистент выбирал подходящий способ работы с колодой. GP ChatGPT ★ 12 746звёзд репо element Промпт element даёт агенту операции для изменения элементов в презентациях: заливка, обводка, перемещение, поворот, группировка, удаление. GP ChatGPT ★ 12 746звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой