skilld
All skills
googleworkspace avatar

/gws-sheets-read

@705fb0e
by Google Workspacegoogleworkspace/cli31k stars
1,856

Google Sheets: Read values from a spreadsheet.

Ask your Agent

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

This session only. Nothing lands on disk.

SKILL.md

≈16 tokens always: the name and description. ≈222 when used: this file.

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 <ID> --range <RANGE>

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

Source: SKILL.md on GitHub

Third-party checks

1 warning16d5 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    This skill provides a way to read Google Sheets data using a CLI tool. The main security concern is the potential for indirect prompt injection from the spreadsheet data being ingested into the agent's context.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: MEDIUM · 1 issue

  • Runlayer6mo

    1 file scanned · No issues

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Provenance

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

Last checked against GitHub 2 months ago.

Activeupdated 6 months ago

Capability

Other metadata
metadata
{
  "version": "0.22.5",
  "openclaw": {
    "category": "productivity",
    "requires": {
      "bins": [
        "gws"
      ]
    },
    "cliHelp": "gws sheets +read --help"
  }
}

Topics

  • CLI
  • google-sheets
  • spreadsheet
  • gws
  • read
  • googleworkspace

README badge

README badge for googleworkspace/cli/gws-sheets-read

What it does

Reads values from a Google Sheet by spreadsheet ID and range using the gws CLI tool. Supports row, column, or cell-range queries and is read-only, making it safe for fetching data without modification risk.

Generated from the current SKILL.md.

Frequently asked

Does this skill modify the spreadsheet?
No. The skill is read-only and never modifies any data in the spreadsheet.
What authentication is required?
You must set up auth as described in the gws-shared skill, which handles Google Workspace credentials and security rules for the gws CLI.
What range formats does this support?
The skill accepts ranges in A1 notation, such as 'Sheet1!A1:B2' for a specific rectangle or 'Sheet1' to read an entire sheet.
Can I use advanced Google Sheets API options?
This skill wraps basic read functionality. For advanced options, you should use the raw values.get API directly.

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