gws-docs

Read and write Google Docs via gws CLI with batchUpdate requests.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/cellarwood/figurio --skill gws-docs-cellarwood
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-docs
Source: https://github.com/cellarwood/figurio/tree/main/skills/gws-docs
Command: npx skills add https://github.com/cellarwood/figurio --skill gws-docs-cellarwood

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a CLI-accessible interface to read, create, and modify Google Docs so teams and automation pipelines can manage document content without manual web UI editing. It centralizes document retrieval and batch updates behind a repeatable command-driven workflow and integrates with shared authentication and security rules.

Core Features & Use Cases

  • Document Retrieval: Fetch the latest version of a specified Google Doc with documents.get for review or downstream processing.
  • Document Creation: Create blank documents programmatically to seed templates or generate new files.
  • Batch Updates: Apply one or more validated edits (inserts, formatting, structural changes) atomically using documents.batchUpdate for content generation and automated edits.
  • Use Case: Automate product spec generation by creating a new doc, applying structured content blocks, and inserting generated text via batchUpdate from a CI job.

Quick Start

Use the gws CLI to fetch a document by its ID and apply a batchUpdate to insert or modify content.

Frequently Asked Questions about gws-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Google Docs editing from a CLI script?

You can automate Google Docs editing by using the gws CLI to execute documents.get, documents.create, and documents.batchUpdate requests with parameterized JSON inputs. This allows scripts to retrieve, create, and modify document content programmatically without manual UI interaction.

What is the best way to apply batch updates to a Google Doc?

The best way to apply batch updates to a Google Doc is using the documents.batchUpdate method, which applies validated edits like content inserts, formatting, and structural changes atomically. This ensures all modifications are applied together as a single transactional operation.

Can I create a blank Google Doc programmatically for a CI job?

Yes, you can create a blank Google Doc programmatically using the documents.create method. This is useful for seeding templates or generating new files within CI jobs before applying structured content blocks and inserting generated text via batchUpdate.

Do I need the gws CLI to read and write Google Docs in automation pipelines?

Yes, you need the gws CLI to handle authentication and parameterized JSON inputs for reading and writing Google Docs. It provides the command-driven workflow required to execute API methods like documents.get and documents.batchUpdate within automation pipelines.

Why use batchUpdate instead of individual edits for Google Docs content generation?

Use documents.batchUpdate for Google Docs content generation because it applies one or more validated edits atomically. This prevents partial updates and ensures content inserts, formatting, and structural changes are applied together reliably during automated document modification.