How do I install the Gws Drive skill?

Run npx skillmds@latest add ma08/gws-drive in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Gws Drive safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Gws Drive?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Gws Drive free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Gws Drive?

ma08 (@ma08) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Gws Drive by ma08 — Agent Skill

Name: Gws Drive
Author: ma08

File contents

drive (v3)

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, alias selection, global flags, and security rules. If missing, run gws generate-skills to create it.

Use this skill when the user wants read-only Google Drive access from a specific saved account on this machine. Prefer gws-account <alias> ... over bare gws ....

Common Read Flows

List recent files

gws-account work drive files list --params '{"pageSize": 10, "orderBy": "modifiedTime desc", "q": "trashed=false"}' --format json

Search by title or MIME type

gws-account personal drive files list --params "{\"pageSize\": 10, \"q\": \"name contains 'tax' and trashed=false\"}" --format json
gws-account columbia drive files list --params "{\"pageSize\": 10, \"q\": \"mimeType='application/vnd.google-apps.document' and trashed=false\"}" --format json

Inspect one file's metadata

gws-account work drive files get --params '{"fileId": "<FILE_ID>", "fields": "id,name,mimeType,owners,webViewLink"}' --format json

Download or export content

gws-account personal drive files download --params '{"fileId": "<FILE_ID>"}' -o ./downloaded-file.bin
gws-account columbia drive files export --params '{"fileId": "<FILE_ID>", "mimeType": "text/plain"}' -o ./exported-doc.txt

Use download for uploaded/binary files and export for native Google Docs, Sheets, or Slides files.

Shared Drives

For shared drives, set both supportsAllDrives and includeItemsFromAllDrives. Narrow to one shared drive with corpora=drive plus driveId:

gws-account work drive files list --params '{"corpora": "drive", "driveId": "<DRIVE_ID>", "includeItemsFromAllDrives": true, "supportsAllDrives": true, "pageSize": 10, "q": "trashed=false"}' --format json
gws-account work drive drives list --format json

Discovering Commands

Before calling an unfamiliar method, inspect it:

gws-account work drive --help
gws-account work drive files --help
gws-account work schema drive.files.list

Use gws-account <alias> schema drive.<resource>.<method> to inspect parameters, supported scopes, and response structure before building a command.

Notes

Prefer read-only methods such as files.list, files.get, files.download, files.export, and drives.list unless the user explicitly asks for write access.
Add fields when you only need specific metadata so responses stay small and readable.
Never dump file contents by default if the document is likely to contain sensitive personal, academic, or company material.

---name: gws-drivedescription: Google Drive: List, search, inspect, download, and export files with alias-first `gws-account` flows for `work`, `personal`, and `columbia`.---# drive (v3)> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, alias selection, global flags, and security rules. If missing, run `gws generate-skills` to create it.Use this skill when the user wants read-only Google Drive access from a specific saved account on this machine. Prefer `gws-account <alias> ...` over bare `gws ...`.## Common Read Flows### List recent files```bashgws-account work drive files list --params '{"pageSize": 10, "orderBy": "modifiedTime desc", "q": "trashed=false"}' --format json```### Search by title or MIME type```bashgws-account personal drive files list --params "{\"pageSize\": 10, \"q\": \"name contains 'tax' and trashed=false\"}" --format jsongws-account columbia drive files list --params "{\"pageSize\": 10, \"q\": \"mimeType='application/vnd.google-apps.document' and trashed=false\"}" --format json```### Inspect one file's metadata```bashgws-account work drive files get --params '{"fileId": "<FILE_ID>", "fields": "id,name,mimeType,owners,webViewLink"}' --format json```### Download or export content```bashgws-account personal drive files download --params '{"fileId": "<FILE_ID>"}' -o ./downloaded-file.bingws-account columbia drive files export --params '{"fileId": "<FILE_ID>", "mimeType": "text/plain"}' -o ./exported-doc.txt```Use `download` for uploaded/binary files and `export` for native Google Docs, Sheets, or Slides files.## Shared DrivesFor shared drives, set both `supportsAllDrives` and `includeItemsFromAllDrives`. Narrow to one shared drive with `corpora=drive` plus `driveId`:```bashgws-account work drive files list --params '{"corpora": "drive", "driveId": "<DRIVE_ID>", "includeItemsFromAllDrives": true, "supportsAllDrives": true, "pageSize": 10, "q": "trashed=false"}' --format jsongws-account work drive drives list --format json```## Discovering CommandsBefore calling an unfamiliar method, inspect it:```bashgws-account work drive --helpgws-account work drive files --helpgws-account work schema drive.files.list```Use `gws-account <alias> schema drive.<resource>.<method>` to inspect parameters, supported scopes, and response structure before building a command.## Notes- Prefer read-only methods such as `files.list`, `files.get`, `files.download`, `files.export`, and `drives.list` unless the user explicitly asks for write access.- Add `fields` when you only need specific metadata so responses stay small and readable.- Never dump file contents by default if the document is likely to contain sensitive personal, academic, or company material.

Frequently asked questions

Gws Drive