Gws Drive Upload
Upload local files to Google Drive with automatic MIME detection via the gws CLI from an agent workflow.
Overview
gws-drive-upload is an agent skill for the Build phase that uploads a local file to Google Drive using the gws drive +upload command with optional folder and name metadata.
Install
npx skills add https://github.com/googleworkspace/cli --skill gws-drive-uploadWhat is this skill?
- Runs gws drive +upload with required local file path argument
- Optional --parent folder ID and --name override for target filename
- Automatic MIME type detection; filename defaults to the local path basename
- Documented as a write command with explicit user confirmation before execution
- Depends on gws-shared SKILL.md for auth, global flags, and security rules (package version 0.22.5)
- Skill metadata version 0.22.5
- Three CLI usage examples in the readme
Adoption & trust: 26k installs on skills.sh; 26.9k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You have a generated file on disk and need it in a specific Google Drive folder without leaving the terminal or re-learning Drive API auth.
Who is it for?
Agents already standardized on the googleworkspace/cli gws tool who need occasional, explicit uploads from local build or export artifacts.
Skip if: Bulk sync pipelines, programmatic sharing permission design, or teams without gws OAuth setup via gws-shared.
When should I use this skill?
User wants to upload a local file to Google Drive and gws is the configured Google Workspace CLI.
What do I get? / Deliverables
After confirmed execution, the file lands in Drive with detected MIME type and optional parent folder and renamed title.
- File uploaded to Google Drive with inferred MIME type
- Optional placement under --parent with --name override
Recommended Skills
Journey fit
How it compares
Thin CLI wrapper skill for Drive writes, not a full Google Drive MCP or Apps Script project.
Common Questions / FAQ
Who is gws-drive-upload for?
Solo builders and indie operators using the gws CLI with Claude Code, Cursor, or similar agents to place files into Drive folders.
When should I use gws-drive-upload?
Use it during Build when wiring document delivery integrations, or when preparing launch/growth assets that must live in a shared Drive folder after local generation.
Is gws-drive-upload safe to install?
It performs write operations to your Google account; follow gws-shared security rules, confirm uploads with the user, and review the Security Audits panel on this Prism page.
Workflow Chain
Requires first: gws shared
SKILL.md
READMESKILL.md - Gws Drive Upload
# drive +upload > **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it. Upload a file with automatic metadata ## Usage ```bash gws drive +upload <file> ``` ## Flags | Flag | Required | Default | Description | |------|----------|---------|-------------| | `<file>` | ✓ | — | Path to file to upload | | `--parent` | — | — | Parent folder ID | | `--name` | — | — | Target filename (defaults to source filename) | ## Examples ```bash gws drive +upload ./report.pdf gws drive +upload ./report.pdf --parent FOLDER_ID gws drive +upload ./data.csv --name 'Sales Data.csv' ``` ## Tips - MIME type is detected automatically. - Filename is inferred from the local path unless --name is given. > [!CAUTION] > This is a **write** command — confirm with the user before executing. ## See Also - [gws-shared](../gws-shared/SKILL.md) — Global flags and auth - [gws-drive](../gws-drive/SKILL.md) — All manage files, folders, and shared drives commands