sheets-cli — скилл для Claude Code: работа с Google Sheets из терминала
Скилл учит агента читать таблицы Google Sheets, дописывать строки и править ячейки через CLI. Пригодится, когда данные проекта лежат в облачной таблице, а не в файле.
npx skills add gmickel/sheets-cli --skill sheets-cli -a claude-codeЧто делает sheets-cli
Скилл описывает работу с утилитой sheets-cli, которая уже стоит в PATH. Агент вызывает её команды напрямую: sheets find ищет таблицу по имени через Google Drive, sheets list показывает вкладки, read table отдаёт заголовки и строки в JSON, append добавляет запись, update key меняет ячейки по значению ключевого столбца.
Правки по ключу надёжнее, чем по номеру строки: при вставке и удалении нумерация сдвигается. В ответе read table у каждой строки есть поле _row с абсолютным номером — его и подставляют в update row --row. Номера вручную не считают.
Перед записью скилл советует прогнать команду с --dry-run и посмотреть, что изменится. Для поиска таблицы по имени в проекте Google должен быть включён Drive API, а вход выполняется через sheets-cli auth login --credentials <oauth-client.json>. Все команды возвращают JSON с полем ok — по нему видно, прошло ли обновление.
Какие задачи решает
- прочитать строки из вкладки и отдать их агенту в JSON
- дописать новую запись в конец таблицы
- поменять статус в строке, найденной по значению ключевого столбца
- сделать несколько правок одной пакетной операцией
- проверить будущие изменения через
--dry-runдо записи
Примеры запросов агенту
- Найди таблицу с именем Projects и покажи список вкладок
- Прочитай первые 100 строк из вкладки Tasks
- Пометь строку с ID TASK-42 как Complete, сначала прогони с
--dry-run
Как установить sheets-cli
1Через Skills CLI (Vercel)
npx skills add gmickel/sheets-cli --skill sheets-cli -a claude-code2Вручную: положить файлы
~/.claude/skills/sheets-cli/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/sheets-cli/
1Через Skills CLI (Vercel)
npx skills add gmickel/sheets-cli --skill sheets-cli -a codex2Вручную: положить файлы
.agents/skills/sheets-cli/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add gmickel/sheets-cli --skill sheets-cli -a cursor2Вручную: положить файлы
.cursor/skills/sheets-cli/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install gmickel/sheets-cli sheets-cli2Вручную: положить файлы
.github/skills/sheets-cli/SKILL.md1Через Skills CLI (Vercel)
npx skills add gmickel/sheets-cli --skill sheets-cli -a gemini-cli2Командой платформы
gemini skills install https://github.com/gmickel/sheets-cliВручную: положить файлы
.devin/skills/sheets-cli/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add gmickel/sheets-cli --skill sheets-cli -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о sheets-cli
Как установить sheets-cli в Claude Code?
Выполните npx skills add gmickel/sheets-cli --skill sheets-cli -a claude-code, затем проверьте файл ~/.claude/skills/sheets-cli/SKILL.md.
Что делает sheets-cli?
Даёт агенту команды для чтения и правки Google Sheets: поиск таблицы, список вкладок, чтение таблицы, добавление строк, обновление ячеек по ключу или номеру строки, пакетные операции.
Что нужно, чтобы скилл заработал?
Утилита sheets-cli должна быть в PATH, а вход выполняется командой sheets-cli auth login --credentials <oauth-client.json>. Поиск таблицы по имени требует включённого Google Drive API в проекте.
