# xlsx

Скилл для создания, правки и пересчёта книг Excel с живыми формулами, форматированием и диаграммами. Пригодится, когда агент должен выдать или изменить файл таблицы.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1300 установок · ★ 174
- Автор: appautomaton
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/appautomaton/document-SKILLs/tree/HEAD/xlsx/SKILL.md
- Обновлён: 2026-10-15
- HTML: https://affpapa.org/nevibecode/skills/appautomaton-xlsx

## Что делает

Скилл добавляет к работе с `.xlsx` и `.xlsm` то, чего не видно из кода: шаг пересчёта, который показывает, что в книге на самом деле сломано, и типичные ошибки openpyxl и LibreOffice, из-за которых файлы портятся молча.

Внутри — скрипт `recalc.py`. Запускать его нужно по абсолютному пути из рабочей папки пользователя, чтобы относительные пути к его файлам не поехали: `uv run <skill>/scripts/recalc.py model.xlsx`. Скрипт пересчитывает книгу в LibreOffice, записывает значения обратно и печатает JSON. Код возврата 0 — чисто, 1 — есть проблемы, 2 — запустить не удалось. Для пересчёта нужен установленный LibreOffice (`soffice`).

Для книг, которые вы отдаёте, берите openpyxl: он сохраняет формулы, форматирование, диаграммы, проверку данных и комментарии. pandas годится для анализа и массового чтения, но его запись оставляет только значения. Файлы `.xlsm` грузите с `keep_vba=True`, иначе макросы пропадут при сохранении. Отдельно учтите: `data_only=True` читает кэшированные значения, и сохранение такой книги навсегда заменяет формулы их последними значениями. Это повод проверить код, прежде чем открывать чужой файл в режиме только для чтения значений.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add appautomaton/document-SKILLs --skill xlsx -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add appautomaton/document-SKILLs --skill xlsx -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add appautomaton/document-SKILLs --skill xlsx -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install appautomaton/document-SKILLs xlsx
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add appautomaton/document-SKILLs --skill xlsx -a gemini-cli
```

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add appautomaton/document-SKILLs --skill xlsx -a opencode
```

### Claude.ai

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

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

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

## Примеры запросов агенту
- сделай книгу xlsx с помесячной выручкой и формулой итога
- пересчитай model.xlsx и покажи, что сломалось
- прочитай формулы из отчёта.xlsx и опиши, как он устроен

## Похожие
- [kimi-xlsx](https://affpapa.org/nevibecode/skills/kimi-xlsx.md) — скилл · 430 установок
- [xlsx-manipulation](https://affpapa.org/nevibecode/skills/xlsx-manipulation.md) — скилл · 6500 установок
- [agent-xlsx](https://affpapa.org/nevibecode/skills/agent-xlsx.md) — скилл · 766 установок
- [excel-automation](https://affpapa.org/nevibecode/skills/excel-automation.md) — скилл · 1500 установок
- [minimax-xlsx](https://affpapa.org/nevibecode/skills/minimax-xlsx.md) — скилл · 3800 установок
- [xlsx-generator](https://affpapa.org/nevibecode/skills/xlsx-generator.md) — скилл · 393 установки

## Другие версии с тем же именем
- [xlsx · anthropics](https://affpapa.org/nevibecode/skills/xlsx.md) — 187223 установки
- [xlsx · tfriedel](https://affpapa.org/nevibecode/skills/tfriedel-xlsx.md) — 2500 установок
- [xlsx · bobmatnyc](https://affpapa.org/nevibecode/skills/bobmatnyc-xlsx.md) — 588 установок

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

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

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