# Manage Google Docs with the gws CLI

Google Docs automation can require precise API commands and request formats. This skill guides Claude, Codex, and Claude Code through gws document operations.

## Install

```bash
npx skillstore add googleworkspace/gws-docs
```

## Metadata

- Status: approved
- Slug: googleworkspace-gws-docs
- Version: 0.23.0
- Author version: 0.23.0
- Skillstore revision: r2
- Version status: valid
- Tree hash: a958f7d7d07818a15199ee35d80f96168beb67bc17fb87ffb0efcd26b22ed65e
- Author: googleworkspace
- GitHub username: googleworkspace
- License: MIT
- Repository: https://github.com/googleworkspace/cli/tree/main/skills/gws-docs/
- Ref: 286d37c9c189ddd1aafd3548415fb031d1df79d5
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, network, filesystem
- Quality score: 82
- Quality tier: silver
- Public page: https://skillstore.pages.dev/skills/googleworkspace-gws-docs
- Manifest: https://skillstore.pages.dev/api/skills/googleworkspace-gws-docs/manifest

## Capabilities

- Shows the base gws command structure for Google Docs resources and methods.
- Documents create, get, and batchUpdate operations for documents.
- Directs users to inspect command help before selecting a method.
- Uses gws schema output to identify required parameters, types, and defaults.
- Links to the companion writing helper for appending document text.

## Use Cases

- Retrieve documents for support: Inspect the get method and prepare a command that retrieves the latest version of a specified document.
- Create workflow documents: Create blank Google Docs with approved titles as part of a repeatable operational workflow.
- Build document updates: Inspect batchUpdate requirements before constructing validated document changes for an automation pipeline.

## Prompt Templates

### Explore Docs commands

```
Show the available gws Docs resources and explain which listed document method fits my goal: [GOAL].
```

### Retrieve a document

```
Inspect the schema for the get method, then prepare a command to retrieve document [DOCUMENT_ID]. Explain each required flag.
```

### Create a blank document

```
Inspect the create method schema and prepare a command that creates a blank document titled [TITLE].
```

### Plan a batch update

```
Inspect the batchUpdate schema and outline a validated request for document [DOCUMENT_ID] that applies these changes: [CHANGES].
```

## Limitations

- Requires an installed and authenticated gws CLI.
- Covers only the listed Google Docs v1 document operations.
- The create operation makes a blank document and ignores supplied content fields.
- Does not provide complete request payloads because schemas must be inspected first.

## Best Practices

- Inspect each method schema before building parameters or request data.
- Confirm document identifiers, titles, and intended changes before executing write operations.
- Validate every batch request because one invalid item causes the complete update to fail.

## Anti Patterns

- Do not guess parameter names, types, or defaults.
- Do not expect the create operation to insert supplied document content.
- Do not execute document changes without confirming the target document and requested edits.

## Security Audit

- Audited at: 2026-08-05T10:49:47.446\+00:00
- Summary: All 13 static findings are false positives caused by Markdown backticks, code fences, API prose, or fixed sibling-file references. The skill documents expected gws CLI usage and contains no dynamic command execution, network implementation, path traversal input, or prompt injection.

## Stats

- Views: 89
- Downloads: 9
- Favorites: 0
- Popularity score: 0