recipe-organize-drive-folder Skill: Build Drive Folders and Move Files In

Creates a Google Drive folder structure and moves existing files into the right folders.

Installs: 31.3K; on skills.sh
Stars: 32K; on GitHub
Updated: Oct 2026; last repo commit

recipe-organize-drive-folder is a four-step recipe: create a project folder, create sub-folders, move existing files into them, then list the folder to check. It uses the gws program through the gws-drive service skill. The example builds a Q2 Project folder with a Documents sub-folder. Moving a file changes its parent folder, so check each file ID first.

Good for

Anyone setting up a project folder tree in Drive
Teams moving loose files into a standard structure
Claude Code or Codex users who already run the gws program

Install recipe-organize-drive-folder

Claude Code

Copy this prompt.

Install the recipe-organize-drive-folder skill in Claude Code. Run this command:

npx skills add https://github.com/googleworkspace/cli --skill recipe-organize-drive-folder --skill gws-drive --skill gws-shared -a claude-code

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js, gws installed and signed in.

Do the "First" and "Then" methods once before the skills command: they install gws and sign you in. The skills command adds 3 skills (recipe-organize-drive-folder, gws-drive, gws-shared) because recipe-organize-drive-folder reads gws-shared first and points to the others in the set. Without gcloud, use the manual OAuth setup in the README. To limit what the sign-in grants, run gws auth login -s drive so the consent screen lists only those services.

From the vendor's docs. Source.

What's in the skill

When it loads

Create a Google Drive folder structure and move files into the right locations.

Sections in SKILL.md

Steps

Key facts

Author: googleworkspace organization (repo owner)
Status: Not an officially supported Google product, per the README
License: Apache-2.0
Installs on skills.sh: 31,333 (Nov 2, 2026)
GitHub stars: 32,038 (Nov 2, 2026) (whole repo)
Last commit: Oct 30, 2026
What installs: 1 file, SKILL.md; it bundles no scripts
Needs: the gws program signed in to Google, plus gws-shared and gws-drive
skills.sh audits: Gen Agent Trust Hub: pass, Socket: pass, Snyk: pass
Documented setups: skills CLI, OpenClaw, Gemini CLI extension

What it includes

Creates a project folder
The example creates Q2 Project with the folder MIME type.
Write · gws drive files create (folder)
Creates sub-folders
Adds a parent folder ID so the folder nests inside the project folder.
Write · gws drive files create (sub-folder)
Moves files into the folder
Sets addParents and removeParents for the file ID.
Write · gws drive files update
Verifies the structure
Lists the files whose parent is the new folder.
Network · gws drive files list

From the official docs

Permissions

Medium risk

It creates folders and moves files by changing their parent folder. Sign in with only the services you need and read each command before you approve it.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It moves files out of their old folder
Step 3 removes the old parent and adds the new one. Check each file ID and note the old folder so you can move it back. github.com
The project is in active development
The README says to expect breaking changes before v1.0. Re-read the install steps after you update gws. github.com

Technical details

Turning on read-only	No read-only switch in the skill. The gws-shared skill says to prefer --dry-run for destructive operations and to confirm write commands with you.
Talks to	Google Workspace APIs through gws
Sign-in and keys	gws sign-in. The README says credentials are encrypted at rest (AES-256-GCM) with the key kept in your OS keyring.
Scopes	Whatever Google services you grant when you sign in to gws

Questions

What does recipe-organize-drive-folder do?

Creates a Google Drive folder structure and moves existing files into the right folders.

How do I install recipe-organize-drive-folder in Claude Code?

Use the install box above. It adds recipe-organize-drive-folder together with gws-drive, gws-shared in one step. You also need the gws program installed and signed in to Google first, and the box lists both steps.

Does recipe-organize-drive-folder work in the Claude app or Codex?

The install box has a Codex tab that uses the skills CLI's Codex target, but the repo README does not list Codex as a supported setup. The README documents no Claude app route, and every command runs the gws program in a terminal, so use Claude Code or another terminal agent.

Does recipe-organize-drive-folder need an API key?

No API key. It uses your Google sign-in through gws, and the README says you need a Google Cloud project for the sign-in credentials. gws auth setup can create one if you have the gcloud CLI.

Is recipe-organize-drive-folder safe?

It creates folders and moves files by changing their parent folder. The recipe has no delete step, but a wrong file ID moves the wrong file, so check each one.

Does it delete anything?

The recipe creates folders and moves files by changing their parent. It has no delete step.

Information

updated Nov 2, 2026

Repository: googleworkspace/cli
Folder: skills/recipe-organize-drive-folder

googleworkspace/cli skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 4

googleworkspace/cli README · github.com
skills CLI commands · github.com
recipe-organize-drive-folder SKILL.md · github.com
gws-shared SKILL.md · github.com