gws-sheets-read — скилл для Claude Code: что делает и как установить
Читает значения ячеек и листов из Google Таблиц через CLI. Пригодится, когда агенту нужно получить данные таблицы без риска их изменить.
npx skills add googleworkspace/cli --skill gws-sheets-read -a claude-codeЧто делает gws-sheets-read
Скилл из набора googleworkspace/cli версии 0.22.5 запускает команду gws sheets +read для получения содержимого Google Таблиц. Для чтения обязательны флаги --spreadsheet с идентификатором таблицы и --range. В диапазон передают имя листа вроде Sheet1 или диапазон ячеек вроде Sheet1!A1:B2 и Sheet1!A1:D10.
Для работы требуется установленный бинарник gws. Перед первым запуском нужен файл ../gws-shared/SKILL.md с правилами авторизации и безопасности, который создается через gws generate-skills. Утилита работает только на чтение и никогда не меняет данные.
Для сложных выборок авторы советуют напрямую вызывать API values.get. Инструмент стоит поставить тем, кому нужен безопасный просмотр таблиц без риска перезаписи.
Какие задачи решает
- прочитать значения ячеек из Google Таблицы
- выгрузить данные конкретного листа по названию
- получить таблицу без риска случайно изменить ячейки
Примеры запросов агенту
- Прочитай диапазон `Sheet1!A1:D10` из таблицы с ID
- Выгрузи значения листа `Sheet1` из таблицы ID
- Покажи ячейки `Sheet1!A1:B2` из документа ID через gws
Как установить gws-sheets-read
1Через Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-sheets-read -a claude-code2Вручную: положить файлы
~/.claude/skills/gws-sheets-read/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/gws-sheets-read/
1Через Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-sheets-read -a codex2Вручную: положить файлы
.agents/skills/gws-sheets-read/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-sheets-read -a cursor2Вручную: положить файлы
.cursor/skills/gws-sheets-read/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install googleworkspace/cli gws-sheets-read2Вручную: положить файлы
.github/skills/gws-sheets-read/SKILL.md1Через Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-sheets-read -a gemini-cli2Командой платформы
gemini skills install https://github.com/googleworkspace/cli --path skills/gws-sheets-readВручную: положить файлы
.devin/skills/gws-sheets-read/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-sheets-read -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Из того же набора95
Весь набор →Похожие
Вопросы о gws-sheets-read
Как установить gws-sheets-read в Claude Code?
Выполните команду npx skills add googleworkspace/cli --skill gws-sheets-read -a claude-code. Также файл скилла можно разместить по пути ~/.claude/skills/gws-sheets-read/SKILL.md.
Что делает скилл gws-sheets-read?
Он читает данные из Google Таблиц через вызов gws sheets +read. Команда принимает идентификатор таблицы и диапазон ячеек, возвращая их значения агенту.
Может ли этот скилл случайно перезаписать данные в таблице?
Нет, команда работает строго в режиме чтения и не изменяет содержимое документа. Для расширенных параметров авторы рекомендуют обращаться напрямую к API values.get.
Исходный текст
SKILL.md · Apache-2.0
---
name: gws-sheets-read
description: "Google Sheets: Read values from a spreadsheet."
metadata:
version: 0.22.5
openclaw:
category: "productivity"
requires:
bins:
- gws
cliHelp: "gws sheets +read --help"
---
# sheets +read
> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
Read values from a spreadsheet
## Usage
```bash
gws sheets +read --spreadsheet <ID> --range <RANGE>
```
## Flags
| Flag | Required | Default | Description |
|------|----------|---------|-------------|
| `--spreadsheet` | ✓ | — | Spreadsheet ID |
| `--range` | ✓ | — | Range to read (e.g. 'Sheet1!A1:B2') |
## Examples
```bash
gws sheets +read --spreadsheet ID --range "Sheet1!A1:D10"
gws sheets +read --spreadsheet ID --range Sheet1
```
## Tips
- Read-only — never modifies the spreadsheet.
- For advanced options, use the raw values.get API.
## See Also
- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
- [gws-sheets](../gws-sheets/SKILL.md) — All read and write spreadsheets commands
© googleworkspace · Apache-2.0 · googleworkspace/cli
