{"id":"dc56b38d-4ec8-4689-ba2d-1bc1e520cdb1","shortId":"GpzxxZ","kind":"skill","title":"gws-sheets-read","tagline":"Google Sheets: Read values from a spreadsheet.","description":"# sheets +read\n\n> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.\n\nRead values from a spreadsheet\n\n## Usage\n\n```bash\ngws sheets +read --spreadsheet <ID> --range <RANGE>\n```\n\n## Flags\n\n| Flag | Required | Default | Description |\n|------|----------|---------|-------------|\n| `--spreadsheet` | ✓ | — | Spreadsheet ID |\n| `--range` | ✓ | — | Range to read (e.g. 'Sheet1!A1:B2') |\n\n## Examples\n\n```bash\ngws sheets +read --spreadsheet ID --range \"Sheet1!A1:D10\"\ngws sheets +read --spreadsheet ID --range Sheet1\n```\n\n## Tips\n\n- Read-only — never modifies the spreadsheet.\n- For advanced options, use the raw values.get API.\n\n## See Also\n\n- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth\n- [gws-sheets](../gws-sheets/SKILL.md) — All read and write spreadsheets commands","tags":["gws","sheets","read","cli","googleworkspace","agent-skills","ai-agent","automation","discovery-api","gemini-cli-extension","google-admin","google-api"],"capabilities":["skill","source-googleworkspace","skill-gws-sheets-read","topic-agent-skills","topic-ai-agent","topic-automation","topic-cli","topic-discovery-api","topic-gemini-cli-extension","topic-google-admin","topic-google-api","topic-google-calendar","topic-google-chat","topic-google-docs","topic-google-drive"],"categories":["cli"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/googleworkspace/cli/gws-sheets-read","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add googleworkspace/cli","source_repo":"https://github.com/googleworkspace/cli","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 26371 github stars · SKILL.md body (872 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:52:31.264Z","embedding":null,"createdAt":"2026-04-18T20:24:27.118Z","updatedAt":"2026-05-18T18:52:31.264Z","lastSeenAt":"2026-05-18T18:52:31.264Z","tsv":"'/gws-shared/skill.md':16,101 '/gws-sheets/skill.md':109 'a1':60,71 'advanc':89 'also':97 'api':95 'auth':18,105 'b2':61 'bash':40,63 'command':115 'creat':32 'd10':72 'default':49 'descript':50 'e.g':58 'exampl':62 'flag':20,46,47,103 'generat':29 'generate-skil':28 'global':19,102 'googl':5 'gws':2,27,41,64,73,99,107 'gws-share':98 'gws-sheet':106 'gws-sheets-read':1 'id':53,68,77 'miss':25 'modifi':85 'never':84 'option':90 'prerequisit':14 'rang':45,54,55,69,78 'raw':93 'read':4,7,13,15,34,43,57,66,75,82,111 'read-on':81 'requir':48 'rule':23 'run':26 'secur':22 'see':96 'share':100 'sheet':3,6,12,42,65,74,108 'sheet1':59,70,79 'skill':30 'skill-gws-sheets-read' 'source-googleworkspace' 'spreadsheet':11,38,44,51,52,67,76,87,114 'tip':80 'topic-agent-skills' 'topic-ai-agent' 'topic-automation' 'topic-cli' 'topic-discovery-api' 'topic-gemini-cli-extension' 'topic-google-admin' 'topic-google-api' 'topic-google-calendar' 'topic-google-chat' 'topic-google-docs' 'topic-google-drive' 'usag':39 'use':91 'valu':8,35 'values.get':94 'write':113","prices":[{"id":"0f4551f3-cace-4eec-ac5f-08eaabf7004d","listingId":"dc56b38d-4ec8-4689-ba2d-1bc1e520cdb1","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"googleworkspace","category":"cli","install_from":"skills.sh"},"createdAt":"2026-04-18T20:24:27.118Z"}],"sources":[{"listingId":"dc56b38d-4ec8-4689-ba2d-1bc1e520cdb1","source":"github","sourceId":"googleworkspace/cli/gws-sheets-read","sourceUrl":"https://github.com/googleworkspace/cli/tree/main/skills/gws-sheets-read","isPrimary":false,"firstSeenAt":"2026-04-18T21:52:06.739Z","lastSeenAt":"2026-05-18T18:52:31.264Z"},{"listingId":"dc56b38d-4ec8-4689-ba2d-1bc1e520cdb1","source":"skills_sh","sourceId":"googleworkspace/cli/gws-sheets-read","sourceUrl":"https://skills.sh/googleworkspace/cli/gws-sheets-read","isPrimary":true,"firstSeenAt":"2026-04-18T20:24:27.118Z","lastSeenAt":"2026-05-07T22:40:14.488Z"}],"details":{"listingId":"dc56b38d-4ec8-4689-ba2d-1bc1e520cdb1","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"googleworkspace","slug":"gws-sheets-read","github":{"repo":"googleworkspace/cli","stars":26371,"topics":["agent-skills","ai-agent","automation","cli","discovery-api","gemini-cli-extension","google-admin","google-api","google-calendar","google-chat","google-docs","google-drive","google-sheets","google-workspace","oauth2","rust"],"license":"apache-2.0","html_url":"https://github.com/googleworkspace/cli","pushed_at":"2026-05-12T16:46:11Z","description":"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.","skill_md_sha":"a1711dc3220fd19a768e7301c09aeea563ff945e","skill_md_path":"skills/gws-sheets-read/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/googleworkspace/cli/tree/main/skills/gws-sheets-read"},"layout":"multi","source":"github","category":"cli","frontmatter":{"name":"gws-sheets-read","description":"Google Sheets: Read values from a spreadsheet."},"skills_sh_url":"https://skills.sh/googleworkspace/cli/gws-sheets-read"},"updatedAt":"2026-05-18T18:52:31.264Z"}}