gws-drive
Google Drive skill for managing files, folders, and shared drives via the gws CLI. Covers listing, searching, uploading, downloading, sharing, and organising Drive content.
Best use case
gws-drive is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Google Drive skill for managing files, folders, and shared drives via the gws CLI. Covers listing, searching, uploading, downloading, sharing, and organising Drive content.
Teams using gws-drive should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/gws-drive/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How gws-drive Compares
| Feature / Agent | gws-drive | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Google Drive skill for managing files, folders, and shared drives via the gws CLI. Covers listing, searching, uploading, downloading, sharing, and organising Drive content.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Google Drive (gws-drive)
> **PREREQUISITE:** Read the `gws-shared` skill for auth, global flags, and security rules.
Manage Google Drive files, folders, and shared drives using the `gws` CLI.
```bash
gws drive <resource> <method> [flags]
```
## Quick Examples
```bash
# List the 10 most recent files
gws drive files list --params '{"pageSize": 10, "orderBy": "modifiedTime desc"}'
# Search for files by name
gws drive files list --params '{"q": "name contains '\''invoice'\''", "pageSize": 20}'
# Search for PDFs only
gws drive files list --params '{"q": "mimeType = '\''application/pdf'\''", "pageSize": 10}'
# Get file metadata
gws drive files get --params '{"fileId": "FILE_ID", "fields": "id,name,mimeType,size,modifiedTime"}'
# Create a folder
gws drive files create --json '{"name": "Q1 Reports", "mimeType": "application/vnd.google-apps.folder"}'
# Upload a file
gws drive files create --upload /path/to/file.pdf --json '{"name": "report.pdf"}'
# Download a file
gws drive files get --params '{"fileId": "FILE_ID", "alt": "media"}' -o /tmp/file.pdf
# Export a Google Doc as PDF
gws drive files export --params '{"fileId": "DOC_ID", "mimeType": "application/pdf"}' -o /tmp/doc.pdf
# Share a file (grant viewer access)
gws drive permissions create \
--params '{"fileId": "FILE_ID"}' \
--json '{"role": "reader", "type": "user", "emailAddress": "user@example.com"}'
# Move file to a folder
gws drive files update \
--params '{"fileId": "FILE_ID", "addParents": "FOLDER_ID", "removeParents": "root"}'
# Trash a file
gws drive files update --params '{"fileId": "FILE_ID"}' --json '{"trashed": true}'
# Delete permanently
gws drive files delete --params '{"fileId": "FILE_ID"}'
# List shared drives
gws drive drives list
# Auto-paginate all files as NDJSON
gws drive files list --params '{"pageSize": 100}' --page-all | jq -r '.files[].name'
```
## Key API Resources
### files
`list`, `get`, `create`, `update`, `copy`, `delete`, `export`, `download`
### permissions
`list`, `get`, `create`, `update`, `delete`
### drives (Shared Drives)
`list`, `get`, `create`, `update`, `hide`, `unhide`
### comments
`list`, `get`, `create`, `update`, `delete`
### changes
`list`, `watch`, `getStartPageToken`
## Common Query Syntax
```bash
# Folders only
"mimeType = 'application/vnd.google-apps.folder'"
# Files in a specific folder
"'FOLDER_ID' in parents and trashed = false"
# Recently modified
"modifiedTime > '2026-01-01T00:00:00'"
# Shared with me
"sharedWithMe = true"
# By file type
"mimeType = 'image/png'"
```
## Discovering More
```bash
gws drive --help
gws schema drive.files.list
gws schema drive.permissions.create
```Related Skills
webapp-testing
Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.
web-artifacts-builder
Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui). Use for complex artifacts requiring state management, routing, or shadcn/ui components - not for simple single-file HTML/JSX artifacts.
valyu
Search the live web and 36+ specialised data sources including SEC filings, PubMed, ChEMBL, clinical trials, FRED economic indicators, and patent databases. Use when current, authoritative, or paywalled data is required.
ui-ux-pro-max
AI-powered design intelligence with 67 UI styles, 161 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 15+ tech stacks. Generates complete design systems for any product type with industry-specific reasoning rules.
theme-factory
Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors/fonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.
slack-gif-creator
Knowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."
skill-creator
Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, update or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.
shannon
Autonomous AI security pen testing. Executes real exploits against web applications to find SQL injection, XSS, SSRF, authentication flaws, and IDOR vulnerabilities. Reports only confirmed, reproducible findings — no false positives.
remotion
Create programmatic videos using React and Remotion. Translate natural language descriptions into working Remotion components for product demos, release announcements, explainer videos, and animated content.
planetscale
Design schemas and write queries for PlanetScale serverless MySQL using branch-based workflows. Ensures index coverage, avoids foreign key anti-patterns, and treats every schema change as a reviewable, reversible deploy request.
mcp-builder
Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).
karpathy-coding-principles
Apply Karpathy-inspired coding behavior guidelines — think before coding, prefer simplicity, make surgical changes, and execute toward verifiable goals. Reduces wrong assumptions, overengineering, and unintended side-effects.