← Back to Skills Marketplace
Gws Docs
by
googleworkspace-bot
· GitHub ↗
· v1.0.12
· MIT-0
892
Downloads
0
Stars
20
Active Installs
13
Versions
Install in OpenClaw
/install gws-docs
Description
Read and write Google Docs.
README (SKILL.md)
docs (v1)
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
gws docs \x3Cresource> \x3Cmethod> [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.\x3Cresource>.\x3Cmethod>
Use gws schema output to build your --params and --json flags.
Usage Guidance
This skill appears to be a thin wrapper around a local 'gws' CLI for Google Docs, which is reasonable — but the SKILL.md defers authentication to ../gws-shared/SKILL.md and declares no required credentials. Before installing: 1) Inspect the referenced ../gws-shared/SKILL.md to see exactly how auth tokens are obtained, stored, and protected (env vars vs files). 2) Verify the provenance and integrity of the 'gws' binary you will run (source, version, checksums). 3) Run gws docs --help and gws schema locally in a sandbox to confirm what data is sent/received and whether any files or tokens are created. 4) Ask the skill author to declare required credentials and explain what gws generate-skills does and where it writes files. If you cannot review the shared auth SKILL.md and the gws binary, treat this skill as higher risk and avoid granting access to production credentials.
Capability Analysis
Type: OpenClaw Skill
Name: gws-docs
Version: 1.0.12
The skill bundle for 'gws-docs' is a standard documentation wrapper for interacting with Google Docs via the 'gws' CLI tool. It defines basic API resources (documents) and methods (get, create, batchUpdate) without any evidence of malicious intent, data exfiltration, or harmful prompt injection.
Capability Assessment
Purpose & Capability
Name/description match a gws-based Google Docs helper and the declared required binary (gws) is appropriate. However, the skill does not declare any auth/credentials even though the SKILL.md explicitly says to read ../gws-shared/SKILL.md for auth and security rules. Not declaring where credentials come from (env vars or config paths) is inconsistent with the stated capability.
Instruction Scope
Runtime instructions are minimal and rely entirely on the external gws CLI, which is fine. But the SKILL.md directs the agent to read a sibling file (../gws-shared/SKILL.md) for authentication and security rules and to run gws generate-skills if missing. That creates cross-skill dependencies and potentially causes the agent to read or create files outside this skill's directory — behavior not explained or declared.
Install Mechanism
Instruction-only skill with no install spec and no code files; lowest install risk. It simply requires the gws binary to be present on PATH.
Credentials
No env vars or credentials are declared, yet the SKILL.md implicitly requires authentication to Google via a shared SKILL.md. This mismatch (no declared primaryEnv but an explicit auth prerequisite) is disproportionate and unclear. It's unknown where tokens will be read from or stored.
Persistence & Privilege
always is false and the skill is user-invocable; the skill does not request elevated or persistent platform privileges. Note: the SKILL.md's instructions to read/write sibling files could cause on-disk changes depending on gws behavior, but the skill itself does not force always-on or modify other skills' configurations according to the manifest.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install gws-docs - After installation, invoke the skill by name or use
/gws-docs - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.12
- Bumped skill metadata version to 0.22.5.
v1.0.11
- Updated metadata version from 0.22.3 to 0.22.4 in SKILL.md.
v1.0.10
- Updated skill metadata version from 0.22.2 to 0.22.3 in SKILL.md.
v1.0.9
- Updated metadata version from 0.22.1 to 0.22.2 in SKILL.md.
- No changes to functionality or documentation content.
v1.0.8
- Updated metadata version from 0.22.0 to 0.22.1 in SKILL.md.
v1.0.7
- Bumped metadata version from 0.21.2 to 0.22.0 in SKILL.md.
- No functional or content changes to documentation or commands.
v1.0.6
- Updated version metadata from 0.21.1 to 0.21.2 in SKILL.md.
v1.0.5
- Bumped version to 0.21.1 in metadata.
- No other functional or documentation changes.
v1.0.4
- Updated version number from 0.20.0 to 0.20.1 in skill metadata.
v1.0.3
- Version updated to 0.20.0 in metadata.
- No changes to features, commands, or usage documented.
v1.0.2
- Updated metadata version format and moved version under metadata.
- Removed the top-level version field from SKILL.md.
- No changes to commands or functionality.
v1.0.1
- Updated formatting of the metadata section in SKILL.md for consistency.
- No functional or user-facing changes.
v1.0.0
Initial release – Adds support for reading and writing Google Docs via CLI.
- Introduces core commands to create, get, and batch update Google Docs.
- Includes helper documentation for appending text to documents.
- Provides instructions for exploring available resources and their schemas.
- Categorized under "productivity" and requires the "gws" binary.
Metadata
Frequently Asked Questions
What is Gws Docs?
Read and write Google Docs. It is an AI Agent Skill for Claude Code / OpenClaw, with 892 downloads so far.
How do I install Gws Docs?
Run "/install gws-docs" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Gws Docs free?
Yes, Gws Docs is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Gws Docs support?
Gws Docs is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Gws Docs?
It is built and maintained by googleworkspace-bot (@googleworkspace-bot); the current version is v1.0.12.
More Skills