{"id":"c4114368-0b6d-46e8-b761-9ae48cdc4953","shortId":"kcM5cn","kind":"skill","title":"gws-docs","tagline":"Read and write Google Docs.","description":"# docs (v1)\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\n```bash\ngws docs <resource> <method> [flags]\n```\n\n## Helper Commands\n\n| Command | Description |\n|---------|-------------|\n| [`+write`](../gws-docs-write/SKILL.md) | Append text to a document |\n\n## API Resources\n\n### documents\n\n  - `batchUpdate` — Applies one or more updates to the document. Each request is validated before being applied. If any request is not valid, then the entire request will fail and nothing will be applied. Some requests have replies to give you some information about how they are applied. Other requests do not need to return information; these each return an empty reply. The order of replies matches that of the requests.\n  - `create` — Creates a blank document using the title given in the request. Other fields in the request, including any provided content, are ignored. Returns the created document.\n  - `get` — Gets the latest version of the specified document.\n\n## Discovering Commands\n\nBefore calling any API method, inspect it:\n\n```bash\n# Browse resources and methods\ngws docs --help\n\n# Inspect a method's required params, types, and defaults\ngws schema docs.<resource>.<method>\n```\n\nUse `gws schema` output to build your `--params` and `--json` flags.","tags":["gws","docs","cli","googleworkspace","agent-skills","ai-agent","automation","discovery-api","gemini-cli-extension","google-admin","google-api","google-calendar"],"capabilities":["skill","source-googleworkspace","skill-gws-docs","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-docs","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 (1,349 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:29.538Z","embedding":null,"createdAt":"2026-04-18T20:24:17.450Z","updatedAt":"2026-05-18T18:52:29.538Z","lastSeenAt":"2026-05-18T18:52:29.538Z","tsv":"'/gws-docs-write/skill.md':40 '/gws-shared/skill.md':13 'api':46,160 'append':41 'appli':50,64,81,95 'auth':15 'bash':31,164 'batchupd':49 'blank':122 'brows':165 'build':189 'call':158 'command':36,37,156 'content':139 'creat':29,119,120,144 'default':180 'descript':38 'discov':155 'doc':3,8,9,33,170,183 'document':45,48,57,123,145,154 'empti':108 'entir':73 'fail':76 'field':132 'flag':17,34,194 'generat':26 'generate-skil':25 'get':146,147 'give':87 'given':127 'global':16 'googl':7 'gws':2,24,32,169,181,185 'gws-doc':1 'help':171 'helper':35 'ignor':141 'includ':136 'inform':90,103 'inspect':162,172 'json':193 'latest':149 'match':114 'method':161,168,174 'miss':22 'need':100 'noth':78 'one':51 'order':111 'output':187 'param':177,191 'prerequisit':11 'provid':138 'read':4,12 'repli':85,109,113 'request':59,67,74,83,97,118,130,135 'requir':176 'resourc':47,166 'return':102,106,142 'rule':20 'run':23 'schema':182,186 'secur':19 'skill':27 'skill-gws-docs' 'source-googleworkspace' 'specifi':153 'text':42 'titl':126 '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' 'type':178 'updat':54 'use':124,184 'v1':10 'valid':61,70 'version':150 'write':6,39","prices":[{"id":"687547c0-7b3a-44df-aa9c-34a0300f6d18","listingId":"c4114368-0b6d-46e8-b761-9ae48cdc4953","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:17.450Z"}],"sources":[{"listingId":"c4114368-0b6d-46e8-b761-9ae48cdc4953","source":"github","sourceId":"googleworkspace/cli/gws-docs","sourceUrl":"https://github.com/googleworkspace/cli/tree/main/skills/gws-docs","isPrimary":false,"firstSeenAt":"2026-04-18T21:51:49.493Z","lastSeenAt":"2026-05-18T18:52:29.538Z"},{"listingId":"c4114368-0b6d-46e8-b761-9ae48cdc4953","source":"skills_sh","sourceId":"googleworkspace/cli/gws-docs","sourceUrl":"https://skills.sh/googleworkspace/cli/gws-docs","isPrimary":true,"firstSeenAt":"2026-04-18T20:24:17.450Z","lastSeenAt":"2026-05-07T22:40:14.251Z"}],"details":{"listingId":"c4114368-0b6d-46e8-b761-9ae48cdc4953","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"googleworkspace","slug":"gws-docs","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":"f51b195031ea0b0d1b26cb548b1c5c1cdb82166f","skill_md_path":"skills/gws-docs/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/googleworkspace/cli/tree/main/skills/gws-docs"},"layout":"multi","source":"github","category":"cli","frontmatter":{"name":"gws-docs","description":"Read and write Google Docs."},"skills_sh_url":"https://skills.sh/googleworkspace/cli/gws-docs"},"updatedAt":"2026-05-18T18:52:29.538Z"}}