gws-drive
Google Drive: Manage files, folders, and shared drives.
Install / Use
npx skills add googleworkspace/cli --skill gws-driveInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
SecuritySupported Platforms
Our assessment of gws-drive
gws-drive scores 91/100 on our quality scale, 442nd of 1,111 Security skills we index (top 40%).
Its SKILL.md is 13 KB long, well organised into 20 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.
With 31,133 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so gws-drive is actively maintained.
- Our last check on 2026-10-28 found the source still online.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-26. Automated pattern scan on 2026-09-26. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
gws-drive compared with similar skills
All 4 of these similar skills score higher than gws-drive; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| gws-drive (this skill)by googleworkspace | 91 | 31.1k | 53d ago | SKILL.md |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| designby nextlevelbuilder | 100 | 149.0k | 6d ago | SKILL.md |
Frequently asked questions
- How do I install gws-drive?
- Run
npx skills add googleworkspace/cli --skill gws-drive. The install tabs above show the steps for each supported agent. - Which AI agents does gws-drive work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is gws-drive safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is gws-drive still maintained?
- The repository was last updated about 2 months ago, so gws-drive is actively maintained.
Skill content
View source on GitHubname: gws-drive description: "Google Drive: Manage files, folders, and shared drives." metadata: version: 0.22.5 openclaw: category: "productivity" requires: bins: - gws cliHelp: "gws drive --help"
drive (v3)
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
gws drive <resource> <method> [flags]
Helper Commands
| Command | Description |
|---------|-------------|
| +upload | Upload a file with automatic metadata |
API Resources
about
get— Gets information about the user, the user's Drive, and system capabilities. For more information, see Return user info. Required: Thefieldsparameter must be set. To return the exact fields you need, see Return specific fields.
accessproposals
get— Retrieves an access proposal by ID. For more information, see Manage pending access proposals.list— List the access proposals on a file. For more information, see Manage pending access proposals. Note: Only approvers are able to list access proposals on a file. If the user isn't an approver, a 403 error is returned.resolve— Approves or denies an access proposal. For more information, see Manage pending access proposals.
approvals
get— Gets an Approval by ID.list— Lists the Approvals on a file.
apps
get— Gets a specific app. For more information, see Return user info.list— Lists a user's installed apps. For more information, see Return user info.
changes
getStartPageToken— Gets the starting pageToken for listing future changes. For more information, see Retrieve changes.list— Lists the changes for a user or shared drive. For more information, see Retrieve changes.watch— Subscribes to changes for a user. For more information, see Notifications for resource changes.
channels
stop— Stops watching resources through this channel. For more information, see Notifications for resource changes.
comments
create— Creates a comment on a file. For more information, see Manage comments and replies. Required: Thefieldsparameter must be set. To return the exact fields you need, see Return specific fields.delete— Deletes a comment. For more information, see Manage comments and replies.get— Gets a comment by ID. For more information, see Manage comments and replies. Required: Thefieldsparameter must be set. To return the exact fields you need, see Return specific fields.list— Lists a file's comments. For more information, see Manage comments and replies. Required: Thefieldsparameter must be set. To return the exact fields you need, see Return specific fields.update— Updates a comment with patch semantics. For more information, see Manage comments and replies. Required: Thefieldsparameter must be set. To return the exact fields you need, see Return specific fields.
drives
create— Creates a shared drive. For more information, see Manage shared drives.get— Gets a shared drive's metadata by ID. For more information, see Manage shared drives.hide— Hides a shared drive from the default view. For more information, see Manage shared drives.list— Lists the user's shared drives. This method accepts theqparameter, which is a search query combining one or more search terms. For more information, see the Search for shared drives guide.unhide— Restores a shared drive to the default view. For more information, see Manage shared drives.update— Updates the metadata for a shared drive. For more information, see Manage shared drives.
files
copy— Creates a copy of a file and applies any requested updates with patch semantics. For more information, see Create and manage files.create— Creates a file. For more information, see Create and manage files. This method supports an /upload URI and accepts uploaded media with the following characteristics: - Maximum file size: 5,120 GB - Accepted Media MIME types:*/*(Specify a valid MIME type, rather than the literal*/*value. The literal*/*is only used to indicate that any valid MIME type can be uploaded.download— Downloads the content of a file. For more information, see Download and export files. Operations are valid for 24 hours from the time of creation.export— Exports a Google Workspace document to the requested MIME type and returns exported byte content. For more information, see Download and export files. Note that the exported content is limited to 10 MB.generateIds— Generates a set of file IDs which can be provided in create or copy requests. For more information, see Create and manage files.get— Gets a file's metadata or content by ID. For more information, see Search for files and folders. If you provide the URL parameteralt=media, then the response includes the file contents in the response body. Downloading content withalt=mediaonly works if the file is stored in Drive.list— Lists the user's files. For more information, see Search for files and folders. This method accepts theqparameter, which is a search query combining one or more search terms. This method returns all files by default, including trashed files. If you don't want trashed files to appear in the list, use thetrashed=falsequery parameter to remove trashed files from the results.listLabels— Lists the labels on a file. For more information, see List labels on a file.modifyLabels— Modifies the set of labels applied to a file. For more information, see Set a label field on a file. Returns a list of the labels that were added or modified.update— Updates a file's metadata, content, or both. When calling this method, only populate fields in the request that you want to modify. When updating fields, some fields might be changed automatically, such asmodifiedDate. This method supports patch semantics. This method supports an /upload URI and accepts uploaded media with the following characteristics: - Maximum file size: 5,120 GB - Accepted Media MIME types:*/*(Specify a valid MIME type, rather than the literal*/*value.watch— Subscribes to changes to a file. For more information, see Notifications for resource changes.
operations
get— Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.
permissions
create— Creates a permission for a file or shared drive. For more information, see Share files, folders, and drives. Warning: Concurrent permissions operations on the same file aren't supported; only the last update is applied.delete— Deletes a permission. For more information, see Share files, folders, and drives. Warning: Concurrent permissions operations on the same file aren't supported; only the last update is applied.get— Gets a permission by ID. For more information, see Share files, folders, and drives.list— Lists a file's or shared drive's permissions. For more information, see Share files, folders, and drives.update— Updates a permission with patch semantics. For more information, see Share files, folders, and drives. Warning: Concurrent permissions operations on the same file aren't supported; only the last update is applied.
replies
create— Creates a reply to a comment. For more information, see Manage comments and replies.delete— Deletes a reply. For more information, see Manage comments and replies.get— Gets a reply by ID. For more information, see Manage comments and replies.list— Lists a comment's replies. For more information, see Manage comments and replies.update— Updates a reply with patch semantics. For more information, see Manage comments and replies.
revisions
delete— Permanently deletes a file version. You can only delete revisions for files with binary content in Google Drive, like images or videos. Revisions for other files, like Google Docs or Sheets, and the last remaining file version can't be deleted. For more information, see Manage file revisions.get— Gets a revision's metadata or content by ID. For more information, see [Manage file revisions](https://
Truncated for display — read the full file on GitHub.
Related Skills
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
design
149.0kComprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini, Atlas Cloud, or MuAPI AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
