recipe-share-folder-with-team

Shares a Google Drive folder and its contents with collaborators using gws CLI commands.

Updated Nov 9, 2023
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill recipe-share-folder-with-team-oresttokovenko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: recipe-share-folder-with-team
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/recipe-share-folder-with-team
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill recipe-share-folder-with-team-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually sharing Google Drive folders with multiple team members through the web UI is repetitive and error-prone, especially when different collaborators need different permission levels. This recipe automates the process of locating a folder and granting editor or viewer access to a list of collaborators via the command line. ## Core Features & Use Cases - Folder Discovery: Locate a Google Drive folder by name using the gws drive files list command with a query filter. - Role-Based Sharing: Grant writer (editor) or reader (viewer) permissions to specific email addresses using gws drive permissions create. - Permission Verification: Confirm the applied sharing settings with a formatted table of current permissions. - Use Case: A project manager needs to give the engineering team edit access and stakeholders view access to the "Project X" folder; this recipe runs the exact sequence of gws commands to do so. ## Quick Start Ask the assistant to share the Google Drive folder named Project X with your team, giving editors write access and stakeholders read access.

Frequently Asked Questions about recipe-share-folder-with-team

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I share a Google Drive folder from the command line?

Use the gws drive permissions create command with the folder's file ID, specifying a role such as writer or reader and the collaborator's email address. First find the folder ID with gws drive files list using a name query.

How do I find a Google Drive folder ID by name?

Run gws drive files list with a query parameter filtering by name and the mimeType application/vnd.google-apps.folder. The command returns matching folders with their IDs for use in subsequent permission commands.

What permission roles can I assign when sharing a Drive folder?

This recipe uses the writer role for editors who can modify contents and the reader role for viewers with read-only access. Roles are set in the JSON body of the gws drive permissions create command.

How do I verify who has access to a shared Google Drive folder?

Run gws drive permissions list with the folder's file ID and the table format flag. It outputs the current permission entries so you can confirm each collaborator's assigned role.

What tools are required to run this Drive sharing recipe?

The recipe requires the gws command-line binary and the gws-drive skill loaded as a prerequisite. Without these, the Drive API commands for listing files and creating permissions cannot execute.