# spreadsheets

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

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 267 установок · ★ 107 у репозитория
- Автор: PaulRBerg
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/PaulRBerg/agent-skills/tree/HEAD/skills/spreadsheets/SKILL.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/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`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add PaulRBerg/agent-skills --skill spreadsheets -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/spreadsheets/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/spreadsheets/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add PaulRBerg/agent-skills --skill spreadsheets -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/spreadsheets/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add PaulRBerg/agent-skills --skill spreadsheets -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/spreadsheets/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install PaulRBerg/agent-skills skills/spreadsheets
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/spreadsheets/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add PaulRBerg/agent-skills --skill spreadsheets -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/PaulRBerg/agent-skills --path skills/spreadsheets
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/spreadsheets/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add PaulRBerg/agent-skills --skill spreadsheets -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/PaulRBerg/agent-skills/tree/HEAD/skills/spreadsheets/SKILL.md

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

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

## Похожие
- [excel](https://affpapa.org/nevibecode/skills/sundial-org-excel.md) — скилл · 294 установки
- [alephgrid](https://affpapa.org/nevibecode/mcp/alephgrid.md) — MCP-сервер · ★ 3 у репозитория
- [report-builder](https://affpapa.org/nevibecode/skills/report-builder.md) — скилл · 401 установка
- [xlsx](https://affpapa.org/nevibecode/skills/appautomaton-xlsx.md) — скилл · 1300 установок
- [kimi-xlsx](https://affpapa.org/nevibecode/skills/kimi-xlsx.md) — скилл · 437 установок
- [LogiSheets](https://affpapa.org/nevibecode/mcp/logisheets.md) — MCP-сервер · ★ 41 у репозитория

Из того же набора: [paulrberg/agent-skills](https://affpapa.org/nevibecode/by/paulrberg/agent-skills.md) — 16 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
