Guide · Agent skill
How to use the Find Largest Drive Files agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The Find Largest Drive Files skill (recipe-find-large-files) lets an AI agent search your Google Drive for the files using the most storage and show them to you in a table. It then suggests which of those files you might archive or move to free up space. This guide explains what the skill does, how to install it, how to ask for it, and what it needs before it can run.
Find Largest Drive Filesgoogleworkspace/cli · Apache-2.0 Download the skill Quick start
- 1Install the gws command-line tool. Install gws and authenticate it with access to Google Drive. The recipe cannot run without this.
- 2Install the gws-drive skill. Load the gws-drive skill, which this recipe requires.
- 3Download the skill ZIP. Download the recipe-find-large-files ZIP from this page.
- 4Unzip the skill into the right folder. Unzip it into ~/.claude/skills/ for personal use, or into a project's .claude/skills/ folder.
- 5Or upload it in the Claude apps. In the Claude apps, go to Settings → Capabilities → Skills and upload the ZIP.
- 6Ask for your largest files. Make a plain-language request such as asking which Drive files use the most space.
- 7Review the suggestions. Check the table and the suggested files to archive or move, and make any changes yourself.
What does the skill make the agent do?
The skill is a short recipe for an agent. When it runs, the agent uses the gws command-line tool to list the 20 Google Drive files that use the most storage. For each file it shows the name, ID, size, type and owner in a table.
After listing the files, the agent reviews the list and suggests which files might be archived or moved to free up space. The skill only lists files and suggests actions; it is not described as deleting or moving anything on its own.
- Lists up to 20 files, sorted by storage quota used (largest first)
- Shows name, ID, size, type and owner for each file
- Suggests candidates to archive or move
Before you install: requirements
The recipe cannot run without two things. First, the gws command-line tool (Google Workspace CLI) must be installed and authenticated with access to Google Drive. Second, the separate gws-drive skill must also be loaded, because this recipe depends on it.
The skill's metadata lists gws as a required tool and gws-drive as a required skill. Its source file does not describe how to install gws, so check the gws project documentation for that step.
- gws command-line tool installed and authenticated with Google Drive access
- gws-drive skill installed and loaded
- Access to the Google account whose Drive you want to scan
How to install the skill
Option one is a manual install. Download the ZIP file for this skill from this page and unzip it into your personal skills folder, ~/.claude/skills/, or into a project's .claude/skills/ folder if you want the skill limited to that project.
Option two is to upload the ZIP in the Claude apps. Open Settings, go to Capabilities, then choose Skills and upload the file there.
- Personal install: unzip into ~/.claude/skills/
- Project install: unzip into the project's .claude/skills/ folder
- Claude apps: Settings → Capabilities → Skills, then upload the ZIP
How to trigger the skill with a natural request
You do not need to type a command. Ask the agent in plain language about your Drive storage, for example asking what files are taking up the most space. The agent should recognise the request and run the recipe.
Be specific about your goal if you want more useful suggestions. Saying you are running low on space and want to clear room gives the agent a clearer target than asking only for a list.
- "What are the biggest files in my Google Drive?"
- "I'm running out of Drive storage. Which files should I archive?"
- "Find the space hogs in my Drive and suggest what to move."
What the underlying command does
The recipe runs a single gws command. It asks Drive for files sorted by quota bytes used in descending order, limits the result to 20 files, returns only the id, name, size, mimeType and owners fields, and prints the output as a table. You can read this command to see exactly what the agent will run.
- Sort: quotaBytesUsed, descending
- Page size: 20
- Fields: id, name, size, mimeType, owners
- Output format: table
gws drive files list --params '{"orderBy": "quotaBytesUsed desc", "pageSize": 20, "fields": "files(id,name,size,mimeType,owners)"}' --format tableSafety notes: scripts and network access
This skill runs scripts and uses the network. The command reads your Google Drive account through the gws tool, so it needs access to that account. Only install the skill if you trust its source and are comfortable granting the gws tool access to your Drive.
The skill is designed to list and suggest, not to change files. If you ask the agent to act on its suggestions, such as moving or deleting files, review each change yourself before confirming it.
- Runs scripts and uses the network
- Needs authenticated access to your Google Drive through gws
- Review any archive, move or delete action before it happens
What people use it for
- Finding the largest files when Google Drive storage is almost full
- Reviewing old or shared files that take up a lot of quota before archiving them
- Giving an admin or power user a quick list of space hogs without scrolling through Drive
- Getting a short list of candidates to move to other storage, with the agent doing the searching
Frequently asked questions
Is the Find Largest Drive Files skill free to use?
The skill's source is licensed under Apache-2.0. Check the licence file in the project for the full terms. The skill itself does not mention any charges.
What do I need to install before this skill works?
You need the gws command-line tool (Google Workspace CLI) installed and authenticated with access to Google Drive. You also need the gws-drive skill loaded, because this recipe depends on it.
How do I install a Claude agent skill from a ZIP file?
Download the ZIP from this page and unzip it into ~/.claude/skills/ for personal use, or into a project's .claude/skills/ folder. In the Claude apps you can instead upload the ZIP under Settings → Capabilities → Skills.
Will the skill delete my Drive files?
The skill lists the largest files and suggests which ones to archive or move. It does not describe deleting anything itself, but the agent could act on suggestions if you ask, so review any change before confirming it.
Does this skill work with Dropbox or OneDrive?
No. This skill covers Google Drive only. It does not cover non-Google storage such as Dropbox or OneDrive.
Why does the skill need the gws-drive skill as well?
The recipe lists gws-drive as a required skill and says it must be loaded to run the recipe. Without it, the recipe cannot run.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
This skill suits anyone low on Google Drive storage, and admins or power users who want a quick ranked list of large files with suggested candidates. It is not a good fit if you have not set up gws and authenticated it with your Drive, if you need automatic deletion or moving, or if your files live in Dropbox or OneDrive.
Download the skill