Back to Skills

gws-drive-upload

Google Drive: Upload a file with automatic metadata.

24,602stars1,249forksUpdated 4/14/2026

Security Assessment

Safe(100/100)
Security Score100/100

About gws-drive-upload

The `gws-drive-upload` skill provides a streamlined solution for uploading files to Google Drive while automatically managing metadata. It simplifies the process of transferring files from a local environment to the cloud by handling essential details such as MIME type detection and filename assignment. This skill addresses common challenges users face when manually uploading files, such as incorrectly specifying file types or managing naming conventions, thereby reducing errors and saving time during file management operations.

Key features of the `gws-drive-upload` skill include the ability to upload any local file directly to Google Drive with a single command. The skill supports specifying a parent folder ID to organize uploads efficiently, and allows custom filenames via the `--name` flag, defaulting to the source filename if unspecified. MIME types are detected automatically, ensuring correct file categorization in Google Drive. As a write command, it prompts for confirmation to prevent unintended changes. The CLI interface is compatible with other `gws` commands and integrates seamlessly into productivity workflows for file handling and cloud management.

This skill is ideal for professionals, developers, and productivity-focused users who need to manage cloud storage efficiently. It suits scenarios such as uploading reports, datasets, or project files to shared drives while maintaining consistent metadata. Users who regularly collaborate using Google Drive or require automated workflows for file organization and sharing will benefit from the simplified, reliable upload process that `gws-drive-upload` offers. Its use cases span individual users managing personal projects to teams handling structured file storage in enterprise environments.

FAQ

How do I upload a file using gws-drive-upload?

You can upload a file by running `gws drive +upload <file>`. Optionally, you can specify a parent folder using `--parent` or set a custom filename with `--name`.

Can I upload files to a specific folder in Google Drive?

Yes, by using the `--parent` flag, you can provide the folder ID where the file should be uploaded.

Does gws-drive-upload automatically detect file types?

Yes, the skill automatically detects the MIME type of the file, ensuring it is correctly categorized in Google Drive.

Are there any prerequisites to use this skill?

You need to have the shared authentication and global flags set up from `gws-shared/SKILL.md`. If missing, run `gws generate-skills` to create it.

Is there a risk of overwriting files?

Since this is a write command, it is recommended to confirm with the user before executing to prevent accidental overwrites or changes.

Install gws-drive-upload

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill