Recipe Email Drive Link
Find a Drive file, grant reader access, and send the doc link to a client or teammate in one agent-run recipe.
Overview
Recipe Email Drive Link is an agent skill for the Build phase that shares a Google Drive file and emails the document link to recipients using chained `gws` Drive and Gmail commands.
Install
npx skills add https://github.com/googleworkspace/cli --skill recipe-email-drive-linkWhat is this skill?
- 3-step recipe: Drive search by name, permissions create, Gmail +send with doc URL
- Requires both `gws-drive` and `gws-gmail` prerequisite skills
- Drive query example for locating Quarterly Report by file name
- Sets reader role for a specific user email on the file
- Embeds `https://docs.google.com/document/d/FILE_ID` in the outbound message
- metadata version 0.22.5
- 2 prerequisite domain skills
Adoption & trust: 15.8k installs on skills.sh; 26.9k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You have the report in Drive but waste time flipping between share dialogs and compose just to get one link to a client.
Who is it for?
Solo builders already on `gws` who repeatedly share named Drive files and notify people in the same motion.
Skip if: Bulk distribution, public link-only sharing without identity, or teams not using Google Drive plus Gmail.
When should I use this skill?
You need to share a Google Drive file and email the link with a message to recipients.
What do I get? / Deliverables
The recipient has reader access on the file and receives an email containing the Google Docs URL built from the resolved FILE_ID.
- Drive permission for reader on target user
- Sent Gmail message with subject, body, and doc URL
Recommended Skills
Journey fit
Sharing deliverables and notifying recipients is core integration glue while you are building and handing off assets—not a marketing-only launch task. The recipe chains Drive permissions API with Gmail send—classic third-party style integration between Google products via CLI.
How it compares
Orchestrates two domain skills in sequence—more than a single-purpose Gmail or Drive snippet.
Common Questions / FAQ
Who is recipe-email-drive-link for?
Builders and consultants who deliver Google Docs or Sheets and want an agent to search Drive, set permissions, and send the link in one recipe.
When should I use recipe-email-drive-link?
Use it in Build integrations when handing off a named file after a milestone, or during Grow client updates when you need a repeatable share-plus-email pattern.
Is recipe-email-drive-link safe to install?
It instructs sharing files and sending mail via your credentials; check the Security Audits panel on this page and validate recipient addresses before running send steps.
SKILL.md
READMESKILL.md - Recipe Email Drive Link
# Email a Google Drive File Link > **PREREQUISITE:** Load the following skills to execute this recipe: `gws-drive`, `gws-gmail` Share a Google Drive file and email the link with a message to recipients. ## Steps 1. Find the file: `gws drive files list --params '{"q": "name = '\''Quarterly Report'\''"}'` 2. Share the file: `gws drive permissions create --params '{"fileId": "FILE_ID"}' --json '{"role": "reader", "type": "user", "emailAddress": "client@example.com"}'` 3. Email the link: `gws gmail +send --to client@example.com --subject 'Quarterly Report' --body 'Hi, please find the report here: https://docs.google.com/document/d/FILE_ID'`