Index of every page on this site: llms.txt
All skills
googleworkspace avatar

/gws-docs

@cd3697e
by Google Workspacegoogleworkspace/cli32k stars
1,997
Run it yourself

Read and write Google Docs.

Use this Skill: https://skilld.dev/gh/googleworkspace/cli/gws-docs

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈9 tokens for metadata: the name and description. ≈339 when used: this file.

How this Skill uses context

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈38 characters, or 0.5%.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning2mo5 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    This skill provides a standard interface for managing Google Docs through the gws command-line tool. It allows the agent to read, create, and update documents. No malicious behavior or security risks were identified beyond the inherent risks of processing external document content.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: MEDIUM · 1 issue

  • Runlayer8mo

    1 file scanned · No issues

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at cd3697e. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 weeks ago.

Activeupdated 8 months ago
Other metadata
metadata
{
  "version": "0.22.5",
  "openclaw": {
    "category": "productivity",
    "requires": {
      "bins": [
        "gws"
      ]
    },
    "cliHelp": "gws docs --help"
  }
}
  • CLI
  • google-workspace
  • google-docs
  • gws
  • documents
  • read
  • write

README badge

README badge for googleworkspace/cli/gws-docs

Reads and writes Google Docs via the gws CLI wrapper around the Google Docs API. Use this skill to create documents, fetch content, and apply batch updates through Claude without leaving the terminal.

Generated from the current SKILL.md.

What authentication does this skill require?
The skill requires Google Workspace credentials configured via the gws CLI. See the gws-shared SKILL.md for auth setup and security rules.
Can this skill read and write Google Docs?
Yes. The skill supports reading documents with `get`, creating blank documents with `create`, and writing/updating with `batchUpdate`. There is also a helper command `+write` for appending text.
What Google Docs API methods does this expose?
The skill wraps three core methods on the documents resource: `get` (retrieve document), `create` (new blank document), and `batchUpdate` (apply multiple updates atomically).

Generated from the current SKILL.md. These answers refresh after source changes.