# google-workspace

Учит агента работать с Google Workspace через CLI gws: файлы Drive, документы, таблицы, письма, календарь и чаты. Пригодится, когда нужно вытащить или изменить что-то в рабочем аккаунте Google.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 700
- Автор: swarmclawai
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/swarmclawai/swarmclaw/tree/HEAD/skills/google-workspace/SKILL.md
- Обновлён: 2026-06-30
- HTML: https://affpapa.org/nevibecode/skills/google-workspace

## Что делает

Скилл описывает, как вызывать `gws` вместо самодельных HTTP-запросов к Workspace API. CLI уже знает поверхность API и по умолчанию отдаёт структурированный JSON, поэтому агенту проще разобрать ответ. Внутри — набор правил и примеров команд: `gws doctor` для проверки установки, `gws help` для справки по ресурсу, дальше `docs get`, `drive files list`, `sheets spreadsheets get`, `gmail users messages list`, `calendar events list`, `chat spaces messages list`.

Порядок работы задан жёстко: сначала чтение и списки, потом изменения. Идентификаторы — document ID, spreadsheet ID, file ID, message ID, calendar ID, space ID — нужно подтвердить до мутации. Если команда падает из-за отсутствующего ID, скилл советует перейти к list или search и найти его там. Для больших выборок — сначала сузить область, потом листать страницы.

Главное ограничение: `gws` должен быть установлен и авторизован заранее. Интерактивный вход из вызова инструмента не выполняется. Без настроенной авторизации агент просто сообщит, что нужно сконфигурировать плагин или залогиниться вручную в терминале. В SwarmClaw команда передаётся в `args`, параметры — в `params`, JSON-ввод — в `jsonInput`; для рискованных изменений есть `dryRun: true`, а `pageAll: true` включает все страницы.

## Требования
- Работает с: Google Workspace, Gmail

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add swarmclawai/swarmclaw --skill google-workspace -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add swarmclawai/swarmclaw --skill google-workspace -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add swarmclawai/swarmclaw --skill google-workspace -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install swarmclawai/swarmclaw google-workspace
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add swarmclawai/swarmclaw --skill google-workspace -a gemini-cli
```

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add swarmclawai/swarmclaw --skill google-workspace -a opencode
```

### Claude.ai

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

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

## Когда брать
- найти файл в Drive по имени и вытащить его ID
- прочитать текст документа Google Docs
- выгрузить строки из таблицы Google Sheets
- разобрать список писем в Gmail и достать нужное
- посмотреть события календаря за период

## Примеры запросов агенту
- Проверь, что `gws` настроен: запусти `gws doctor` и покажи результат
- Найди в Drive файл с отчётом за квартал и верни его file ID
- Покажи последние 10 писем в Gmail и скажи, есть ли среди них счета

## Похожие
- [google-workspace-cli](https://affpapa.org/nevibecode/skills/hoodini-google-workspace-cli.md) — скилл · 455 установок
- [recipe-email-drive-link](https://affpapa.org/nevibecode/skills/recipe-email-drive-link.md) — скилл · 31500 установок
- [Google Workspace](https://affpapa.org/nevibecode/mcp/google-workspace.md) — MCP-сервер · ★ 192
- [recipe-save-email-attachments](https://affpapa.org/nevibecode/skills/recipe-save-email-attachments.md) — скилл · 31100 установок
- [gog-cli](https://affpapa.org/nevibecode/skills/gog-cli.md) — скилл · 807 установок
- [Google Workspace MCP Server](https://affpapa.org/nevibecode/mcp/google-workspace-mcp-server.md) — MCP-сервер · ★ 12

## Другие версии с тем же именем
- [google-workspace · nousresearch](https://affpapa.org/nevibecode/skills/nous-research-google-workspace.md) — 580 установок
- [google-workspace · akillness](https://affpapa.org/nevibecode/skills/agent-skills-team-google-workspace.md) — 405 установок

Из того же набора: [swarmclawai/swarmclaw](https://affpapa.org/nevibecode/by/swarmclawai/swarmclaw.md) — 6 карточек

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

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