# Upload Files to Google Drive

Manual Drive uploads interrupt automated workflows and require repeated metadata choices. This skill uploads local files with automatic MIME detection and optional destination settings.

## Install

```bash
npx skillstore add googleworkspace/gws-drive-upload
```

## Metadata

- Status: approved
- Slug: googleworkspace-gws-drive-upload
- Version: 0.23.0
- Author version: 0.23.0
- Skillstore revision: r2
- Version status: valid
- Tree hash: a23fd18fc75047aede834d4350a0f5f3c1a6d329b9c0241ce041c25236f841d2
- Author: googleworkspace
- GitHub username: googleworkspace
- License: MIT
- Repository: https://github.com/googleworkspace/cli/tree/main/skills/gws-drive-upload/
- Ref: 286d37c9c189ddd1aafd3548415fb031d1df79d5
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, filesystem
- Quality score: 80
- Quality tier: silver
- Public page: https://skillstore.pages.dev/skills/googleworkspace-gws-drive-upload
- Manifest: https://skillstore.pages.dev/api/skills/googleworkspace-gws-drive-upload/manifest

## Capabilities

- Uploads one local file to Google Drive through the gws CLI.
- Detects the file MIME type automatically.
- Uses the local filename when no target name is supplied.
- Places the uploaded file in a specified Drive folder.
- Assigns a custom filename to the uploaded Drive file.

## Use Cases

- Publish a Team Report: Upload a finished report into a selected shared Drive folder with its original filename.
- Archive Exported Data: Store a local CSV export in Drive under a clear destination filename.
- Deliver Generated Documents: Place generated files in a designated Drive folder after confirming the write operation.

## Prompt Templates

### Upload One File

```
Upload [local file path] to Google Drive. Show the planned action and ask for confirmation before executing.
```

### Upload to a Folder

```
Upload [local file path] to the Drive folder with ID [folder ID]. Confirm the source and destination first.
```

### Rename During Upload

```
Upload [local file path] to Google Drive as [target filename]. Ask for confirmation before running the write command.
```

### Prepare a Controlled Upload

```
Verify [local file path], destination folder [folder ID], and target name [filename]. Summarize the upload, then execute only after explicit confirmation.
```

## Limitations

- Requires the gws CLI and its generated shared authentication instructions.
- Handles a single local file per documented command.
- Does not document recursive folder uploads or batch processing.
- Performs a write operation and requires user confirmation before execution.

## Best Practices

- Verify the local file path before preparing the upload.
- Confirm the destination folder ID and target filename with the user.
- Request explicit confirmation immediately before executing the write command.

## Anti Patterns

- Do not upload sensitive files without verifying the intended destination.
- Do not invent a folder ID or filename when the request is ambiguous.
- Do not execute the upload before the user confirms the write operation.

## Security Audit

- Audited at: 2026-08-05T10:58:54.622\+00:00
- Summary: All static findings are false positives caused by Markdown formatting, relative documentation links, or ordinary filename prose. The skill documents an intentional Google Drive upload command and requires user confirmation before execution.

## Stats

- Views: 79
- Downloads: 5
- Favorites: 0
- Popularity score: 0
