gws-docs

googleworkspace/cli · updated Apr 8, 2026

$npx skills add https://github.com/googleworkspace/cli --skill gws-docs
0 commentsdiscussion
summary

Read and write Google Docs through the Google Workspace API.

  • Supports three core operations: create (new blank documents), get (retrieve document content), and batchUpdate (apply multiple validated updates in a single request)
  • Uses a schema-driven CLI with gws schema inspection to discover required parameters, types, and defaults before executing commands
  • Requires Google Workspace authentication and shared security rules documented in gws-shared/SKILL.md
  • Includes a helper command
skill.md

docs (v1)

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

gws docs <resource> <method> [flags]

Helper Commands

Command Description
+write 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:

# 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.

Discussion

Product Hunt–style comments (not star reviews)
  • No comments yet — start the thread.
general reviews

Ratings

4.529 reviews
  • Dhruvi Jain· Dec 24, 2024

    Useful defaults in gws-docs — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.

  • Oshnikdeep· Nov 15, 2024

    gws-docs is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.

  • Carlos Rahman· Nov 15, 2024

    gws-docs reduced setup friction for our internal harness; good balance of opinion and flexibility.

  • Rahul Santra· Nov 11, 2024

    Registry listing for gws-docs matched our evaluation — installs cleanly and behaves as described in the markdown.

  • Ganesh Mohane· Oct 6, 2024

    Keeps context tight: gws-docs is the kind of skill you can hand to a new teammate without a long onboarding doc.

  • Omar Harris· Oct 6, 2024

    Registry listing for gws-docs matched our evaluation — installs cleanly and behaves as described in the markdown.

  • Pratham Ware· Oct 2, 2024

    gws-docs reduced setup friction for our internal harness; good balance of opinion and flexibility.

  • Soo Huang· Sep 25, 2024

    Useful defaults in gws-docs — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.

  • Hana Lopez· Sep 13, 2024

    gws-docs has been reliable in day-to-day use. Documentation quality is above average for community skills.

  • Arjun Reddy· Aug 16, 2024

    I recommend gws-docs for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

showing 1-10 of 29

1 / 3