← Back to Skills Marketplace
googleworkspace-bot

Gws Sheets Read

by googleworkspace-bot · GitHub ↗ · v1.0.13 · MIT-0
cross-platform ⚠ suspicious
549
Downloads
0
Stars
15
Active Installs
14
Versions
Install in OpenClaw
/install gws-sheets-read
Description
Google Sheets: Read values from a spreadsheet.
README (SKILL.md)

sheets +read

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

Read values from a spreadsheet

Usage

gws sheets +read --spreadsheet \x3CID> --range \x3CRANGE>

Flags

Flag Required Default Description
--spreadsheet Spreadsheet ID
--range Range to read (e.g. 'Sheet1!A1:B2')

Examples

gws sheets +read --spreadsheet ID --range "Sheet1!A1:D10"
gws sheets +read --spreadsheet ID --range Sheet1

Tips

  • Read-only — never modifies the spreadsheet.
  • For advanced options, use the raw values.get API.

See Also

Usage Guidance
This skill appears to be a thin wrapper around the 'gws' CLI to read Google Sheets, which is reasonable. However, it explicitly tells the agent to read ../gws-shared/SKILL.md for authentication and global flags — that means the real auth requirements live outside this SKILL.md. Before installing or enabling this skill: 1) Inspect the referenced ../gws-shared/SKILL.md to see exactly which credentials or environment variables are required and where they are stored; 2) Verify the provenance of the 'gws' binary (is it from a trusted provider/release?) because the skill will execute it; 3) Avoid putting high-privilege Google credentials into the agent until you confirm the minimum required scope (read-only scopes are preferable); 4) If you cannot inspect gws-shared, treat this skill as untrusted because it can cause the agent to access unspecified credentials. The minor metadata/version mismatch (SKILL.md metadata shows 0.22.5 vs registry 1.0.13) is a low-severity inconsistency but worth noting as part of overall hygiene.
Capability Analysis
Type: OpenClaw Skill Name: gws-sheets-read Version: 1.0.13 The skill bundle defines a standard interface for reading Google Sheets data using the 'gws' CLI tool. The documentation in SKILL.md is consistent with its stated purpose, containing no evidence of malicious instructions, data exfiltration, or suspicious execution patterns.
Capability Assessment
Purpose & Capability
Name/description align with the runtime instructions: the SKILL.md only documents running the 'gws' CLI to read a sheet range. Requiring the 'gws' binary is proportionate for a Google Sheets read helper.
Instruction Scope
The SKILL.md explicitly instructs the agent to read '../gws-shared/SKILL.md' for auth, global flags, and security rules. That directs the agent to read a file outside this skill's own SKILL.md (filesystem access to a sibling path) and to rely on external content for authentication behavior. The referenced file may instruct the agent to access credentials or perform other actions not visible here.
Install Mechanism
No install spec and no code files — instruction-only. This is low-risk from a code-installation perspective (nothing downloaded or written by the skill itself).
Credentials
The skill declares no required environment variables or primary credential, yet it defers auth to '../gws-shared/SKILL.md'. That external doc will likely require Google auth (tokens, OAuth client, or service account keys). Because those credentials are not declared here, it's unclear what secrets the agent will need or access, making the credential footprint indeterminate.
Persistence & Privilege
The skill is not always-enabled and does not request elevated persistence. Autonomous invocation is allowed (default) but that is expected; there is no evidence it modifies other skill configs or system-wide settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install gws-sheets-read
  3. After installation, invoke the skill by name or use /gws-sheets-read
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.13
- Bumped metadata version from 0.22.4 to 0.22.5 in SKILL.md.
v1.0.12
- Bumped skill version metadata from 0.22.3 to 0.22.4 in SKILL.md. - No functional or documentation changes made.
v1.0.11
- Updated metadata version from 0.22.2 to 0.22.3 in SKILL.md. - No other functional or content changes.
v1.0.10
- Updated skill metadata version from 0.22.1 to 0.22.2 in SKILL.md. - No other content changes.
v1.0.9
- Updated skill metadata version from 0.22.0 to 0.22.1 in SKILL.md. - No other functional or documentation changes.
v1.0.8
- Updated version number to 0.22.0 in metadata. - No changes to features, usage, or documentation content.
v1.0.7
- Updated metadata version in SKILL.md from 0.21.1 to 0.21.2. - No other content changes were made.
v1.0.6
- Updated version number in SKILL.md to 0.21.1. - No functional changes; documentation versioning aligned.
v1.0.5
- Metadata version updated from 0.20.0 to 0.20.1 in SKILL.md. - No other content changes.
v1.0.4
- Updated version metadata from 0.19.0 to 0.20.0 in SKILL.md.
v1.0.3
- Updated version information and metadata format in SKILL.md - Version field moved under metadata and set to 0.19.0 - Removed top-level version field from SKILL.md - No changes to core functionality or usage instructions
v1.0.2
- Updated the formatting of the "requires" field in SKILL.md for consistency. - No functional or user-facing changes.
v1.0.1
- Fixed usage example to use double quotes around the range argument. - No functional or feature changes; documentation only.
v1.0.0
Initial release of gws-sheets-read. - Read values from a Google Spreadsheet using the command line. - Requires spreadsheet ID and range parameters. - Read-only access; does not modify any data. - Includes CLI help and usage examples. - Integrates with gws-shared for authentication and global flags.
Metadata
Slug gws-sheets-read
Version 1.0.13
License MIT-0
All-time Installs 15
Active Installs 15
Total Versions 14
Frequently Asked Questions

What is Gws Sheets Read?

Google Sheets: Read values from a spreadsheet. It is an AI Agent Skill for Claude Code / OpenClaw, with 549 downloads so far.

How do I install Gws Sheets Read?

Run "/install gws-sheets-read" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Gws Sheets Read free?

Yes, Gws Sheets Read is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Gws Sheets Read support?

Gws Sheets Read is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Gws Sheets Read?

It is built and maintained by googleworkspace-bot (@googleworkspace-bot); the current version is v1.0.13.

💬 Comments