Skip to content
Development
Skill

/gws-sheets-read

Google Sheets: Read values from a spreadsheet.

From plugin
cli
30k95 skills
Install
$ npx -y skills add googleworkspace/cli --skill gws-sheets-read --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/gws-sheets-read

Context preview

The summary Claude sees to decide when to auto-load this skill.

Google Sheets: Read values from a spreadsheet.

SKILL.md

gws-sheets-read.SKILL.md
name: gws-sheets-read
description: "Google Sheets: Read values from a spreadsheet."
metadata:
  version: 0.22.5
  openclaw:
    category: "productivity"
    requires:
      bins:
        - gws
    cliHelp: "gws sheets +read --help"

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

  • [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
  • [gws-sheets](../gws-sheets/SKILL.md) — All read and write spreadsheets commands
Ships withcli

Google Workspace CLI — one command-line tool for Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, and more. Dynamically built from Google Discovery Service. Includes AI agent skills.

Get the whole plugin
Stats
30,285
Stars
1,773
Forks
Active
Maintenance
Rust
Language
Apache-2.0
License
9d ago
Last commit
5mo ago
Created

Repo: googleworkspace/cli