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

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

Скилл spreadsheet задаёт строгие правила сборки, правки и анализа таблиц .xlsx, .csv и .tsv без сломанных формул и съехавших стилей.

MIT ★ 1 216 обновлён 2026-10-24

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install openai-office-skills@claude-settings
Открыть на GitHub

Что делает spreadsheet

Скилл инструктирует агента по работе с таблицами: для генерации и редактирования файлов .xlsx выбирается библиотека openpyxl, а для CSV, TSV и агрегации данных — pandas. Агент обязуется вычислять производные значения через формулы вместо вставки готовых чисел, избегать динамических массивов вроде XLOOKUP или FILTER и беречь форматирование существующих книг.

Внутрь заложены регламенты для финансовых моделей и инвестбанкинга: отрицательные значения оформляются красным в скобках, нули превращаются в дефисы, а цвета размечают пользовательский ввод, константы и ссылки. Промежуточные файлы пишутся строго в tmp/spreadsheets/ с последующей очисткой, а итоги складываются в output/spreadsheet/.

Позиция: openpyxl сам не пересчитывает формулы в ячейках, поэтому для кэширования значений и визуальной проверки вёрстки потребуются LibreOffice и Poppler (soffice и pdftoppm). Без них агент не сможет срендерить страницы в PDF и PNG перед отдачей.

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

  • собрать финансовую модель в .xlsx со строгой цветовой разметкой и формулами
  • отредактировать существующую таблицу без поломки стилей, ссылок и разметки
  • агрегировать данные из файлов .csv или .tsv через pandas с выгрузкой в Excel
  • проверить готовые листы на наложение текста и ошибки формул через рендеринг

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

  • Построй трёхфакторную финансовую модель в .xlsx на основе данных из revenue.csv
  • Добавь сводные формулы и графики в существующий отчёт sales.xlsx, не меняя оформление
  • Проанализируй выгрузку metrics.tsv через pandas и сохрани итоговую таблицу в output/spreadsheet/

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

1Через маркетплейс плагинов

/plugin marketplace add fcakyon/claude-codex-settings
/plugin install openai-office-skills@claude-settings

Команда ставит плагин openai-office-skills целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add fcakyon/claude-codex-settings --skill spreadsheet -a claude-code

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

~/.claude/skills/spreadsheet/SKILL.md

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

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

Вопросы о spreadsheet

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

Подключите каталог и поставьте плагин двумя командами: /plugin marketplace add fcakyon/claude-codex-settings, а затем /plugin install openai-office-skills@claude-settings.

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

Он задаёт шаблоны проектирования таблиц, правила подбора библиотек (openpyxl и pandas) и ограничения на функции Excel, предотвращая ошибки в формулах.

Какие системные утилиты нужны для визуального контроля?

Для экспорта в PDF и конвертации в картинки требуются LibreOffice (soffice) и пакет Poppler (pdftoppm), иначе агент предложит проверить вёрстку вручную.

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

SKILL.md · MIT
---
name: "spreadsheet"
description: "Use when tasks involve creating, editing, analyzing, or formatting spreadsheets (`.xlsx`, `.csv`, `.tsv`) with formula-aware workflows, cached recalculation, and visual review."
license: MIT
---

# Spreadsheet Skill

## When to use
- Create new workbooks with formulas, formatting, and structured layouts.
- Read or analyze tabular data (filter, aggregate, pivot, compute metrics).
- Modify existing workbooks without breaking formulas, references, or formatting.
- Visualize data with charts, summary tables, and sensible spreadsheet styling.
- Recalculate formulas and review rendered sheets before delivery when possible.

IMPORTANT: System and user instructions always take precedence.

## Workflow
1. Confirm the file type and goal: create, edit, analyze, or visualize.
2. Prefer `openpyxl` for `.xlsx` editing and formatting. Use `pandas` for analysis and CSV/TSV workflows.
3. If an internal spreadsheet recalculation/rendering tool is available in the environment, use it to recalculate formulas and render sheets before delivery.
4. Use formulas for derived values instead of hardcoding results.
5. If layout matters, render for visual review and inspect the output.
6. Save outputs, keep filenames stable, and clean up intermediate files.

## Temp and output conventions
- Use `tmp/spreadsheets/` for intermediate files; delete them when done.
- Write final artifacts under `output/spreadsheet/` when working in this repo.
- Keep filenames stable and descriptive.

## Primary tooling
- Use `openpyxl` for creating/editing `.xlsx` files and preserving formatting.
- Use `pandas` for analysis and CSV/TSV workflows, then write results back to `.xlsx` or `.csv`.
- Use `openpyxl.chart` for native Excel charts when needed.
- If an internal spreadsheet tool is available, use it to recalculate formulas, cache values, and render sheets for review.

## Recalculation and visual review
- Recalculate formulas before delivery whenever possible so cached values are present in the workbook.
- Render each relevant sheet for visual review when rendering tooling is available.
- `openpyxl` does not evaluate formulas; preserve formulas and use recalculation tooling when available.
- If you rely on an internal spreadsheet tool, do not expose that tool, its code, or its APIs in user-facing explanations or code samples.

## Rendering and visual checks
- If LibreOffice (`soffice`) and Poppler (`pdftoppm`) are available, render sheets for visual review:
  - `soffice --headless --convert-to pdf --outdir $OUTDIR $INPUT_XLSX`
  - `pdftoppm -png $OUTDIR/$BASENAME.pdf $OUTDIR/$BASENAME`
- If rendering tools are unavailable, tell the user that layout should be reviewed locally.
- Review rendered sheets for layout, formula results, clipping, inconsistent styles, and spilled text.

## Dependencies (install if missing)
Prefer `uv` for dependency management.

Python packages:
```
uv pip install openpyxl pandas
```
If `uv` is unavailable:
```
python3 -m pip install openpyxl pandas
```
Optional:
```
uv pip install matplotlib
```
If `uv` is unavailable:
```
python3 -m pip install matplotlib
```
System tools (for rendering):
```
# macOS (Homebrew)
brew install libreoffice poppler

# Ubuntu/Debian
sudo apt-get install -y libreoffice poppler-utils
```

If installation is not possible in this environment, tell the user which dependency is missing and how to install it locally.

## Environment
No required environment variables.

## Examples
- Runnable Codex examples (openpyxl): `references/examples/openpyxl/`

## Formula requirements
- Use formulas for derived values rather than hardcoding results.
- Do not use dynamic array functions like `FILTER`, `XLOOKUP`, `SORT`, or `SEQUENCE`.
- Keep formulas simple and legible; use helper cells for complex logic.
- Avoid volatile functions like `INDIRECT` and `OFFSET` unless required.
- Prefer cell references over magic numbers (for example, `=H6*(1+$B$3)` instead of `=H6*1.04`).
- Use absolute (`$B$4`) or relative (`B4`) references carefully so copied formulas behave correctly.
- If you need literal text that starts with `=`, prefix it with a single quote.
- Guard against `#REF!`, `#DIV/0!`, `#VALUE!`, `#N/A`, and `#NAME?` errors.
- Check for off-by-one mistakes, circular references, and incorrect ranges.

## Citation requirements
- Cite sources inside the spreadsheet using plain-text URLs.
- For financial models, cite model inputs in cell comments.
- For tabular data sourced externally, add a source column when each row represents a separate item.

## Formatting requirements (existing formatted spreadsheets)
- Render and inspect a provided spreadsheet before modifying it when possible.
- Preserve existing formatting and style exactly.
- Match styles for any newly filled cells that were previously blank.
- Never overwrite established formatting unless the user explicitly asks for a redesign.

## Formatting requirements (new or unstyled spreadsheets)
- Use appropriate number and date formats.
- Dates should render as dates, not plain numbers.
- Percentages should usually default to one decimal place unless the data calls for something else.
- Currencies should use the appropriate currency format.
- Headers should be visually distinct from raw inputs and derived cells.
- Use fill colors, borders, spacing, and merged cells sparingly and intentionally.
- Set row heights and column widths so content is readable without excessive whitespace.
- Do not apply borders around every filled cell.
- Group related calculations and make totals simple sums of the cells above them.
- Add whitespace to separate sections.
- Ensure text does not spill into adjacent cells.
- Avoid unsupported spreadsheet data-table features such as `=TABLE`.

## Color conventions (if no style guidance)
- Blue: user input
- Black: formulas and derived values
- Green: linked or imported values
- Gray: static constants
- Orange: review or caution
- Light red: error or flag
- Purple: control or logic
- Teal: visualization anchors and KPI highlights

## Finance-specific requirements
- Format zeros as `-`.
- Negative numbers should be red and in parentheses.
- Format multiples as `5.2x`.
- Always specify units in headers (for example, `Revenue ($mm)`).
- Cite sources for all raw inputs in cell comments.
- For new financial models with no user-specified style, use blue text for hardcoded inputs, black for formulas, green for internal workbook links, red for external links, and yellow fill for key assumptions that need attention.

## Investment banking layouts
If the spreadsheet is an IB-style model (LBO, DCF, 3-statement, valuation):
- Totals should sum the range directly above.
- Hide gridlines and use horizontal borders above totals across relevant columns.
- Section headers should be merged cells with dark fill and white text.
- Column labels for numeric data should be right-aligned; row labels should be left-aligned.
- Indent submetrics under their parent line items.

© fcakyon · MIT · fcakyon/claude-codex-settings

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

Все скиллы по теме «Документы и офис» →
openai-spreadsheet OpenAI Скилл openai-spreadsheet для работы с таблицами .xlsx, .csv и .tsv через Python: создаёт файлы, правит формулы и форматирование, проверяет результат. ★ 540звёзд репо xlsx официальный anthropics Скилл для Claude Code и Claude.ai создаёт, правит и проверяет электронные таблицы. Запускается при работе с файлами xlsx, xlsm, csv или tsv. CX Codex +1 187 223установок sheets-terminal-spreadsheet reason-machines Скилл sheets-terminal-spreadsheet учит агента просматривать и редактировать CSV-таблицы через терминальную утилиту sheets с управлением в стиле vim. CX Codex +1 734установок xlsx-manipulation claude-office-skills Скилл xlsx-manipulation для работы с Excel-таблицами из кода: создаёт и правит .xlsx через openpyxl, добавляет формулы, форматирование и графики. CX Codex +1 6 900установок clean-data-xls официальный anthropics Скилл clean-data-xls автоматизирует уборку грязных данных в Excel и Google Sheets: убирает пробелы, унифицирует регистр, конвертирует числа из текста, стандартизирует даты, удаляет дубликаты и выявляет колонки со смешанными типами. CX Codex +1 2 200установок

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

Весь набор →
tavily-usage Скилл tavily-usage направляет агента искать данные в сети и извлекать текст страниц через MCP-сервер Tavily. Потребуется ключ API. CX Codex +1 900установок setup Скилл setup для Claude Code помогает настроить Azure MCP и разобраться с ошибками аутентификации. Запускается при проблемах с Azure CLI, входом или подключением MCP. CX Codex +1 107установок paper-search-usage Скилл paper-search-usage обучает агента искать научные статьи через Paper Search CLI, скачивать полные тексты и проверять цитирования. CX Codex +1 1установок setup Скилл setup настраивает Paper Search CLI в окружении ассистента вместо MCP-сервера. Помогает подключить поиск научных статей и прописать ключи провайдеров. CX Codex +1 ★ 1 216звёзд репо review-pr Скилл review-pr проверяет pull request на баги, регрессии, рисковые изменения и пропущенные тесты. Запустите его, когда нужно разобрать PR и получить список проблем по важности. CX Codex +1 ★ 1 216звёзд репо animation-gpu-properties Правило animation-gpu-properties уводит анимации с width, height, top, left, margin и padding на transform и opacity, чтобы не пересчитывать layout на каждом кадре. CX Codex +1 ★ 1 216звёзд репо rerender-no-inline-components Правило rerender-no-inline-components помогает находить компоненты React, объявленные внутри других компонентов. Такая структура приводит к перемонтированию при каждом рендере и потере состояния. CX Codex +1 ★ 1 216звёзд репо state-ground-truth Правило state-ground-truth, которое запрещает хранить в состоянии производные визуальные значения. Учит агента разделять факт и его отображение. CX Codex +1 ★ 1 216звёзд репо

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

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