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

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

Скилл spreadsheets для Claude Code проверяет структуру CSV, TSV и .xlsx, правит нужные строки и столбцы и пересчитывает формулы. Работает с таблицей как основным файлом задачи.

MIT 267 установок ★ 107 обновлён 2026-10-24

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

Что делает spreadsheets

Скилл включается, когда CSV, TSV или Excel (.xlsx) служат основным входом или выходом: проектирование и ревью схем текстовых таблиц, проверка, преобразование, конвертация, пересчёт формул, правка готовых файлов. Если таблица в задаче побочная, он не запускается.

Правила жёсткие. Денежные суммы хранятся строками и считаются через decimal.Decimal или DuckDB DECIMAL(38, 18), float не используется. Менять можно только запрошенные строки, столбцы, формулы и оформление. Запись атомарная: сначала временный файл рядом, проверка, потом замена оригинала. Внешние ячейки, начинающиеся с =, + или @, экранируются. Для новых текстовых таблиц скилл советует TSV в UTF-8 без BOM.

Внутри три скрипта: peek.py для быстрого просмотра и строгой проверки, profile.py для JSON-профиля (структура, заголовки, префиксы формул) и recalc.py для пересчёта .xlsx. Соединения и сводные таблицы идут через DuckDB, счётчики и частоты через qsv, точные правки через Python. Скрипты запускаются командой uv run, поэтому без uv они не стартуют. С .xlsx работа начинается с чтения references/xlsx.md.

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

  • проверить структуру незнакомого CSV до любых правок
  • пересчитать формулы в .xlsx и убедиться, что файл не сломан
  • добавить строки в TSV так, чтобы повторный запуск не создал дублей
  • свести выгрузки транзакций через DuckDB без потери точности сумм
  • экранировать ячейки с = из внешней выгрузки перед открытием в Excel

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

  • Проверь структуру transactions.csv скиллом spreadsheets и покажи профиль
  • Добавь в report.xlsx столбец с итогом, пересчитай формулы и больше ничего не трогай
  • Объедини два TSV по id через DuckDB, суммы оставь точными

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

1Через Skills CLI (Vercel)

npx skills add PaulRBerg/agent-skills --skill spreadsheets -a claude-code

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

~/.claude/skills/spreadsheets/SKILL.md

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

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

Вопросы о spreadsheets

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

Выполните npx skills add PaulRBerg/agent-skills --skill spreadsheets -a claude-code. Файл скилла окажется в ~/.claude/skills/spreadsheets/SKILL.md.

Что делает spreadsheets?

Работает с CSV, TSV и .xlsx: профилирует данные, преобразует и конвертирует их, проверяет схему, пересчитывает формулы. Правки минимальные, запись атомарная, суммы считаются без float.

Что нужно для работы spreadsheets и когда он не включается?

Скрипты peek.py, profile.py и recalc.py запускаются через uv run. Статистика по столбцам появляется, если установлен qsv. Когда таблица в задаче побочная, скилл не срабатывает.

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

SKILL.md · MIT
---
argument-hint: "[file]"
name: spreadsheets
description:
  "Use when CSV, TSV, or Excel (.xlsx) is the primary input/output: design or review text-table schemas, inspect,
  transform, validate, convert, or recalc formulas, or create/fix spreadsheets. Do not trigger when tabular data is
  incidental."
---

# Spreadsheets

Handle tabular data with exact values, minimal diffs, recipient-scoped data handling, atomic writes, and structural
validation.

## Invariants

1. Keep precision-sensitive amounts as strings and compute with `decimal.Decimal` or DuckDB `DECIMAL(38, 18)`, never
   binary floats.
2. Touch only requested rows, columns, formulas, and formatting. Existing file conventions override house defaults.
3. For newly authored text tables, prefer TSV, UTF-8 without BOM, LF, one trailing newline, lowercase `snake_case`
   headers, ISO dates, `.` decimals, and `-` nulls.
4. Read unknown text tables with BOM-tolerant UTF-8. Never write a BOM.
5. Write in place atomically through a sibling temporary file, validate it, then replace the target.
6. Escape external cells beginning with `=`, `+`, or `@`. A bare `-` null is exempt. Formula-prefix cells in trusted
   authored data are observations, not proof of injection.
7. Treat transaction, bank, exchange, and tax data as user-owned. Use unredacted samples in internal agent reports when
   materially useful. For public or third-party disclosures, or when the user asks, use `--redact-samples`.

## Factual Profiling

Resolve helper paths from this `SKILL.md`. Profile unknown data before choosing a transformation tool:

```sh
uv run "<skill-dir>/scripts/profile.py" <file>
```

The JSON output has `schema_version: 2`. It reports structural facts, header quality, cardinality/statistics when qsv is
available, frequency facts, formula-prefix cells, workbook metadata, and local tool availability. It contains no tool
recommendations and does not infer identifiers from uniqueness. Choose the tool from the requested transformation,
provenance, output format, and preservation requirements.

Use `--external-data` only when the cells came from an external or otherwise untrusted source and will be written to a
formula-capable consumer. With that flag, formula-prefix cells affect `status`. Without it, legitimate formulas such as
`=SUM(...)` remain factual observations and do not fail the profile.

## Tool Routing

| Need                                        | Tool                                             |
| ------------------------------------------- | ------------------------------------------------ |
| Fast structural preview/validation          | `uv run "<skill-dir>/scripts/peek.py" <file>`    |
| Factual local quality profile               | `uv run "<skill-dir>/scripts/profile.py" <file>` |
| Counts, stats, frequencies, select, dedupe  | `qsv`                                            |
| Joins, pivots, aggregation, conversion      | DuckDB with `all_varchar = true`                 |
| Exact custom transforms                     | `uv run` Python, stdlib `csv`, `decimal.Decimal` |
| New text table or intentional schema change | Read `references/text-table-design.md` first     |
| Any `.xlsx`/`.xlsm` input or output         | Read `references/xlsx.md` first                  |
| Exact transformation/validation recipes     | Read `references/recipes.md` only when needed    |

Prefer `qsv --cache-threshold 0` where supported. When qsv stdout must remain TSV, use `-o out.tsv`. Otherwise, stdout
defaults to CSV.

## Workflow

1. For a new text table or intentional schema change, read `references/text-table-design.md` and record the intended
   table interface plus migration surface.
2. Inspect with `peek.py`. When cardinality, formula prefixes, metadata, or available tooling matters, add `profile.py`.
   For a no-shape-change edit, save the peek JSON. For intentional row/schema changes, record the expected width and
   invariants.
3. Decide whether formula-prefix cells are dangerous from provenance and output context. Decide the smallest tool that
   preserves values and formatting. Avoid pandas unless necessary. If you use it, load every column as strings.
4. Apply the transformation atomically. For idempotent appends with legitimate duplicate rows, use multiset difference
   rather than set deduplication.
5. Validate:
   - unchanged shape: `peek.py --strict --expect-like <before-report>`.
   - changed shape: `peek.py --strict --expect-columns <n>` plus task-specific counts/keys.
   - authored house TSV: add `--house`.
   - formulas: `uv run "<skill-dir>/scripts/recalc.py" <file.xlsx>` and require success.
6. Report paths, row/column effects, validation, and any workbook features that could not be preserved.

For human output, lead with `### 📊 Spreadsheet — ✅ updated` only after the write and required validation pass, or
`### 📊 Spreadsheet — 🔎 inspected, no files written` for read-only work. On required validation failure, use
`### 📊 Spreadsheet — ⛔ not deliverable`. Include profile JSON only when it materially supports the report, and keep
JSON, cells, headers, formulas, paths, commands, and diagnostics undecorated.

## Generated Financial Artifacts

Treat generated financial tables and reports as outputs. Before editing, identify their source inputs and the
project-provided validation and regeneration commands. Edit only the sources, validate them, then regenerate affected
outputs. Never hand-edit generated tables or reports. Cap financial output to counts and file references unless raw rows
materially support the task or were requested. Perform an external-disclosure review before sending financial data
outside the agent workspace.

Completion requires the requested artifact, an intentional diff, atomic replacement where applicable, and structural
plus domain validation evidence. A new or changed text-table schema also requires a defined table interface and a
complete migration of affected producers, consumers, existing rows, generated artifacts, and validators.

© PaulRBerg · MIT · PaulRBerg/agent-skills

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

Все скиллы по теме «Данные и базы» →
excel sundial-org Позволяет агенту читать, создавать и форматировать таблицы Excel через скрипт на базе openpyxl. CX Codex +1 294установок alephgrid alephgrid Подключает агента к книгам Alephgrid в режиме чтения. Позволяет запрашивать схемы таблиц, читать строки и выполнять SQL-запросы к локальным файлам. CX Codex +1 ★ 3звёзд репо report-builder официальный anthropics Скилл report-builder превращает текстовый запрос в регулярный отчёт с расчётом метрик, выгрузкой в XLSX и краткой сводкой для чата. Сохраняет шаблон, чтобы не описывать правила заново. CX Codex +1 401установок xlsx appautomaton Скилл xlsx для Claude Code и Codex: создание, правка и пересчёт книг Excel с живыми формулами, форматированием и диаграммами. Агент выдаёт или изменяет файлы таблиц с проверкой целостности через LibreOffice. CX Codex +1 1 300установок kimi-xlsx thvroyal Скилл kimi-xlsx для работы с таблицами: собирает .xlsx через openpyxl и pandas, проверяет формулы и строит сводные таблицы с графиками. CX Codex +1 437установок LogiSheets logisky LogiSheets — MCP-сервер с локальным движком таблиц на Rust для файлов .xlsx. Именованные блоки вместо координат ячеек сохраняют формулы при сдвиге строк. CX Codex +1 ★ 41звёзд репо

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

Весь набор →
yeet Скилл yeet для Claude Code создаёт и обновляет PR, issues и discussions в GitHub по шаблонам репозитория, затем читает результат. Убирает ручную сборку тела PR. CX Codex +1 2 600установок cli-just Скилл cli-just настраивает автоматизацию задач через just: создаёт justfile, пишет рецепты и проверяет синтаксис под установленную в системе версию утилиты. CX Codex +1 796установок commit Собирает сообщение коммита из подготовленного диффа и отдаёт сам коммит, индекс и пуш утилите ai-commit. CX Codex +1 347установок cli-cast Скилл cli-cast управляет операциями Foundry Cast: готовит, симулирует, подписывает и отправляет транзакции. Также кодирует ABI и подписывает сообщения. CX Codex +1 309установок vitest Руководство для ИИ-агентов по написанию и отладке тестов на Vitest в проектах на Node, Bun или React. CX Codex +1 186установок evm-atlas Скилл evm-atlas для Claude Code собирает проверяемые сведения о сетях EVM, кошельках и транзакциях. Показывает балансы, историю переводов и данные о DeFi-позициях. CX Codex +1 153установок todo-archive Скилл todo-archive переносит выполненные задачи из .ai/TODO.md в ежедневные архивы. Оставляет незакрытые пункты на месте. CX Codex +1 130установок agents-introspection Скилл agents-introspection изучает локальные транскрипты Codex и Claude Code, чтобы найти повторяющиеся сбои поведения агентов и предложить точечную правку. CX Codex +1 123установок

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

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