Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot official · Google

gws-docs — Claude Code skill: what it does, how to install

This skill lets an agent read and update Google Docs through gws. Use it when document changes should happen from an agent chat.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add googleworkspace/cli --skill gws-docs -a claude-code
Open on GitHub

What gws-docs does

gws-docs gives the agent commands for Google Docs through the documents resource. It can fetch the latest version of a document, create a blank document with a chosen title, and apply a batch of updates. The separate +write helper appends text to a document.

Before calling an API method, inspect gws docs --help, then check its schema with gws schema docs... The schema provides the required parameters, types, and defaults used to build --params and --json flags. Auth, global flags, and security rules come from the shared gws-shared skill; when it is missing, the source instructs you to run gws generate-skills.

Install it when your agent needs to work with Google Docs and your environment already uses the gws CLI. The CLI and configured authentication are prerequisites for the workflow.

What it helps with

  • fetch the latest version of a Google Doc
  • create a blank document with a chosen title
  • apply several document updates in one request
  • append text with the +write command
  • inspect Google Docs method parameters

Example prompts for the agent

  • Create a blank Google Doc titled “Release plan”.
  • Fetch the latest version with `documents.get`.
  • Append this text to the document with `+write`.

How to install gws-docs

1Skills CLI (Vercel)

npx skills add googleworkspace/cli --skill gws-docs -a claude-code

2Manually: put the files in place

~/.claude/skills/gws-docs/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/gws-docs/

From the same set95

The whole set →
gws-gmail official googleworkspace This skill hands your agent Gmail: send mail, read the inbox, reply in a thread. Useful when email work already runs through the gws CLI. Claude Code CX Codex Cursor +1 81,900installs gws-gmail-send official googleworkspace A skill that teaches your agent to send Gmail from the terminal: recipients, subject, body, attachments and drafts. Claude Code CX Codex Cursor +1 74,700installs gws-drive official googleworkspace This skill hands your agent Google Drive through the gws CLI: files, folders, shared drives, comments and access requests. Useful when docs move through code. Claude Code CX Codex Cursor +1 74,500installs gws-shared official googleworkspace This skill gives agents shared rules for gws CLI authentication, flags, and output formats. Use it when working with gws commands. Claude Code CX Codex Cursor +1 66,000installs gws-calendar official googleworkspace Manage Google Calendar events, access rules, and schedules through the gws CLI tool. Claude Code CX Codex Cursor +1 61,100installs gws-sheets official googleworkspace This skill lets an agent read and edit Google Sheets through the CLI. Use it when a coding workflow needs spreadsheet data or table updates. Claude Code CX Codex Cursor +1 58,800installs gws-sheets-read official googleworkspace Reads cell values and sheets from Google Spreadsheets via CLI. Useful when an agent needs spreadsheet data without risk of altering it. Claude Code CX Codex Cursor +1 50,600installs gws-docs-write official googleworkspace Appends plain text to the end of a Google Docs document through gws. Use it when an agent needs to write a result into a specific document. Claude Code CX Codex Cursor +1 50,100installs

Similar

source-driven-development addyosmani Grounds agent coding decisions in official documentation. It helps verify framework APIs against detected versions and avoids outdated patterns from model training data. Claude Code CX Codex Cursor +1 57,600installs sales-enablement coreyhaines31 Creates sales decks, one-pagers, demo scripts, and objection-handling documents. Use it when an agent needs sales collateral for a B2B deal. Claude Code CX Codex Cursor +1 118,300installs diagram-design cathrynlavery Draws 45 diagram types as self-contained HTML files with inline SVG. Useful when a picture beats a paragraph. Claude Code CX Codex Cursor +1 18,900installs directory-submissions coreyhaines31 This skill plans product submissions to startup, SaaS, AI, agent, MCP, no-code, and review directories. Use it for launches or backlink campaigns. Claude Code CX Codex Cursor +1 85,100installs social coreyhaines31 Generates social media posts, threads, and carousel outlines without common AI clichés. Built for LinkedIn, X, Instagram, TikTok, and Facebook. Claude Code CX Codex Cursor +1 84,100installs grill-with-docs Matt Pocock This skill interviews you about a plan or design and creates ADRs and a glossary along the way. Use it when decisions need sharper definition. Claude Code 1,219,756installs skill-creator official anthropics Creates and refines skills, then tests them with prompts, evaluations, and performance checks. Claude Code Claude.ai 414,180installs setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. Claude Code 1,052,851installs

Questions about gws-docs

How do I install gws-docs in Claude Code?

Run npx skills add googleworkspace/cli --skill gws-docs -a claude-code. The skill file is placed at ~/.claude/skills/gws-docs/SKILL.md.

What does gws-docs do?

It lets an agent read Google Docs, create blank documents, and send updates through the documents resource. The +write helper appends text.

Which platforms support gws-docs?

The skill supports Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode.

Source text

SKILL.md · Apache-2.0
---
name: gws-docs
description: "Read and write Google Docs."
metadata:
  version: 0.22.5
  openclaw:
    category: "productivity"
    requires:
      bins:
        - gws
    cliHelp: "gws docs --help"
---

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

© googleworkspace · Apache-2.0 · googleworkspace/cli

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor