google-sheets · acedatacloud — скилл для Claude Code: установка
Скилл читает и изменяет Google Sheets через Sheets v4 REST API. Он пригодится для работы с ячейками, диапазонами, вкладками и строками из чата с агентом.
Apache-2.0 179 установок ★ 17 обновлён 2026-10-25
npx skills add AceDataCloud/Skills --skill google-sheets -a claude-codeЧто делает google-sheets
Скилл работает с Google Sheets через curl и jq, используя Sheets v4 REST API. Он читает диапазоны в нотации A1, добавляет и обновляет строки, создаёт таблицы и новые вкладки. Идентификатор таблицы берётся из сегмента URL между /d/ и /edit.
Для запросов нужен OAuth bearer token в переменной $GOOGLE_SHEETS_TOKEN. Подключение по умолчанию даёт область spreadsheets.readonly; запись требует области spreadsheets, поэтому перед изменением данных нужно подтвердить расширенный доступ. Без токена запросы к API не выполнятся.
Скилл использует Bash и показывает ошибки API с кодом, сообщением и статусом. Для записи можно выбрать RAW или USER_ENTERED: второй режим обрабатывает формулы, даты и числа так, как интерфейс Google Sheets. Значения передаются построчно, а имена вкладок с пробелами требуют кавычек в диапазоне.
Какие задачи решает
- прочитать диапазон ячеек из таблицы
- добавить строки в существующую вкладку
- обновить значения в фиксированном диапазоне
- создать таблицу или добавить новую вкладку
Примеры запросов агенту
- Прочитай диапазон
Sheet1!A1:D20из таблицы по этой ссылке. - Добавь в
Sheet1строку с сегодняшней датой, клиентом и суммой, но сначала запроси подтверждение записи. - Создай новую таблицу с названием «Report 2026» и добавь вкладку «Q3».
Как установить google-sheets
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill google-sheets -a claude-code2Вручную: положить файлы
~/.claude/skills/google-sheets/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/google-sheets/
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill google-sheets -a codex2Вручную: положить файлы
.agents/skills/google-sheets/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill google-sheets -a cursor2Вручную: положить файлы
.cursor/skills/google-sheets/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install AceDataCloud/Skills skills/google-sheets2Вручную: положить файлы
.github/skills/google-sheets/SKILL.md1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill google-sheets -a gemini-cli2Командой платформы
gemini skills install https://github.com/AceDataCloud/Skills --path skills/google-sheetsВручную: положить файлы
.devin/skills/google-sheets/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill google-sheets -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о google-sheets
Как установить google-sheets в Claude Code?
Выполните npx skills add AceDataCloud/Skills --skill google-sheets -a claude-code, затем проверьте файл ~/.claude/skills/google-sheets/SKILL.md.
Что делает google-sheets?
Скилл читает диапазоны, добавляет и обновляет строки, создаёт таблицы и вкладки через Google Sheets API. Он также умеет получать названия вкладок и идентификатор таблицы.
Какие права нужны для записи в Google Sheets?
Для чтения достаточно области spreadsheets.readonly. Запись требует области spreadsheets, которую нужно разрешить при подключении.
Исходный текст
SKILL.md · Apache-2.0
---
name: google-sheets
description: Read and edit Google Sheets via the Sheets v4 REST API. Use when the user mentions Google Sheets, a spreadsheet, cells / ranges / tabs, reading or appending rows, updating values, or creating a new spreadsheet.
when_to_use: |
Trigger when the user wants to read a range from a Sheet, append or
update rows, add a tab, or create a spreadsheet. The connector grants
`spreadsheets.readonly` by default; the user opts in to the broader
`spreadsheets` scope (read + write) at install — confirm before
writes. Find the spreadsheet id from a Drive URL or a google-drive
search.
connections: [google/sheets]
allowed_tools: [Bash]
license: Apache-2.0
metadata:
author: acedatacloud
version: "1.0"
---
Drive **Google Sheets** via `curl + jq`. The user's OAuth bearer token is in
`$GOOGLE_SHEETS_TOKEN`; every call needs `Authorization: Bearer
$GOOGLE_SHEETS_TOKEN`. Base URL: `https://sheets.googleapis.com/v4/spreadsheets`.
The token carries `spreadsheets.readonly` (+ identity); writes need the broader
`spreadsheets` scope.
Failures are `{"error":{"code","message","status"}}` — show verbatim. `401` =
re-install. `403 PERMISSION_DENIED` on a write = read-only scope → re-connect
with read+write.
The spreadsheet id is the `…/spreadsheets/d/<ID>/edit` segment of the URL.
```bash
S="https://sheets.googleapis.com/v4/spreadsheets"; AUTH="Authorization: Bearer $GOOGLE_SHEETS_TOKEN"
# Tabs + title
curl -sS -H "$AUTH" "$S/SPREADSHEET_ID?fields=properties.title,sheets.properties(title,sheetId)" \
| jq '{title: .properties.title, tabs: [.sheets[].properties.title]}'
```
## Read / append / update values
```bash
ID="SPREADSHEET_ID"
# Read a range (A1 notation; values are rows of cells)
curl -sS -H "$AUTH" "$S/$ID/values/Sheet1!A1:D20" | jq '.values'
# Append rows (confirm first). valueInputOption=USER_ENTERED parses formulas/dates.
curl -sS -X POST -H "$AUTH" -H "Content-Type: application/json" \
-d '{"values":[["2026-06-21","Acme",4200]]}' \
"$S/$ID/values/Sheet1!A1:append?valueInputOption=USER_ENTERED" | jq '.updates'
# Update a fixed range: PUT /values/{range}?valueInputOption=USER_ENTERED
curl -sS -X PUT -H "$AUTH" -H "Content-Type: application/json" \
-d '{"values":[["done"]]}' \
"$S/$ID/values/Sheet1!E2?valueInputOption=USER_ENTERED" | jq '.updatedCells'
```
## Create a spreadsheet / add a tab
```bash
# New spreadsheet
curl -sS -X POST -H "$AUTH" -H "Content-Type: application/json" \
-d '{"properties":{"title":"Report 2026"}}' "$S" | jq '{spreadsheetId, spreadsheetUrl}'
# Add a tab via batchUpdate (addSheet request)
curl -sS -X POST -H "$AUTH" -H "Content-Type: application/json" \
-d '{"requests":[{"addSheet":{"properties":{"title":"Q3"}}}]}' \
"$S/$ID:batchUpdate" | jq '.replies'
```
## Gotchas
- **A1 notation:** `Sheet1!A1:D20`; quote tab names with spaces as `'My Tab'!A1`.
- `valueInputOption=RAW` stores strings as-is; `USER_ENTERED` interprets them like
the UI (numbers, dates, `=FORMULA`). Pick deliberately.
- `values` is row-major (`[[row1...],[row2...]]`); a missing trailing cell just
comes back short — don't assume rectangular.
© acedatacloud · Apache-2.0 · AceDataCloud/Skills
Похожие скиллы
Все скиллы по теме «Данные и базы» →Сначала — google-sheets от других авторов.