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

/gws-sheets-read

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

Google Sheets: Read values from a spreadsheet.

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

Nothing lands on disk. Nothing to clean up.

Fork this Skill

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

SKILL.md

≈16 tokens for metadata: the name and description. ≈222 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 ≈64 characters, or 0.8%.

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.

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

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 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.

  • 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 sheets +read --help"
  }
}
  • CLI
  • google-sheets
  • spreadsheet
  • gws
  • read
  • googleworkspace

README badge

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

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.

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.