# Gws Docs

> Read and write Google Docs.

Source: https://skillsagentes.com/skills/googleworkspace/cli/gws-docs
Repository: https://github.com/googleworkspace/cli
Author: googleworkspace
License: Apache-2.0
Updated: hace 4 meses
Context cost: 7 tok installed, 391 tok once triggered, 391 tok with every bundled file
Bundle: 1 file, 2 KB
Permissions requested: none declared

## Install

```bash
npx -y skills add googleworkspace/cli --skill gws-docs --agent claude-code
```

## What it does

- Habilita el CLI gws docs para leer y escribir Google Docs mediante batchUpdate, create y get
- Permite crear documentos en blanco, obtener la última versión de un documento y aplicar actualizaciones validadas

## Use it when

- Necesitas leer o modificar documentos de Google Docs desde la línea de comandos
- Quieres crear un documento nuevo o aplicar batchUpdate con requests validados

## What triggers it

- "Crea un Google Doc en blanco con este título"
- "Obtén el contenido actual de este documento de Google Docs"
- "Aplica estas actualizaciones al documento con batchUpdate"

## Before you install

- Requiere el binario gws y haber leído ../gws-shared/SKILL.md para auth, flags globales y reglas de seguridad.

## Files

- SKILL.md — 2 KB

## SKILL.md

Reproduced verbatim from googleworkspace/cli under Apache-2.0. This section is the upstream document and is in English.

# docs (v1)

> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.

```bash
gws docs <resource> <method> [flags]
```

## Helper Commands

| Command | Description |
|---------|-------------|
| [`+write`](../gws-docs-write/SKILL.md) | Append text to a document |

## API Resources

### documents

  - `batchUpdate` — Applies one or more updates to the document. Each request is validated before being applied. If any request is not valid, then the entire request will fail and nothing will be applied. Some requests have replies to give you some information about how they are applied. Other requests do not need to return information; these each return an empty reply. The order of replies matches that of the requests.
  - `create` — Creates a blank document using the title given in the request. Other fields in the request, including any provided content, are ignored. Returns the created document.
  - `get` — Gets the latest version of the specified document.

## Discovering Commands

Before calling any API method, inspect it:

```bash
# Browse resources and methods
gws docs --help

# Inspect a method's required params, types, and defaults
gws schema docs.<resource>.<method>
```

Use `gws schema` output to build your `--params` and `--json` flags.

---

Skills Agentes — https://skillsagentes.com/skills/googleworkspace/cli/gws-docs