Guide · Agent skill
How to use the Share Drive Files with Event Attendees agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
This is an agent skill: a packaged set of instructions that tells an AI agent how to carry out one specific task. This one, recipe-share-event-materials, teaches the agent to share a Google Drive file with everyone invited to a Google Calendar event, then check that the sharing worked. It is for team leads, organisers and assistants who regularly send meeting materials to attendees. After this guide you will know what the skill does, how to install it, how to ask for it in plain language, and what to check before you rely on it.
Share Drive Files with Event Attendeesgoogleworkspace/cli · Apache-2.0 Download the skill Quick start
- 1Install gws and sign in. Install the gws command-line tool and authenticate it with your Google account, with Calendar and Drive access.
- 2Install the related skills. Make sure the gws-calendar and gws-drive skills are available alongside this one.
- 3Download and unzip the skill. Download the ZIP from this page and unzip it into ~/.claude/skills/ or a project's .claude/skills/ folder.
- 4Find the event and file. Note the calendar event ID and the Drive file ID, or describe them clearly.
- 5Ask in plain language. Tell the agent which file to share with the attendees of which event.
- 6Review the attendee list. Check the attendees the agent found before allowing the shares to go ahead.
- 7Verify the permissions. Ask the agent to list the file's permissions and confirm each attendee has viewer access.
What the skill makes the agent do
The skill is a three-step recipe. First the agent looks up the attendee list of a Calendar event. Then it grants each attendee read-only (viewer) access to the Drive file you chose. Finally it lists the file's permissions so you can confirm the sharing took effect.
The actual work is done by the gws command-line tool, which the agent calls on your behalf. The recipe also depends on two other skills, gws-calendar and gws-drive, which the agent must load first.
- Reads the attendees of one calendar event
- Shares one Drive file with each attendee as a reader (viewer)
- Lists the file's permissions as a table for checking
What you need before installing
The recipe cannot run without the gws tool installed and authenticated with a Google account. Your account also needs Google Calendar and Google Drive access permissions. The skill requires the gws-calendar and gws-drive skills to be available alongside it.
- gws command-line tool (Google Workspace CLI), authenticated with a Google account
- gws-calendar skill
- gws-drive skill
- Google Calendar and Google Drive access permissions for the account
Install the skill from the ZIP
Download the ZIP file from this page and unzip it. The package contains a single file, SKILL.md. Place the unzipped skill folder in your personal skills directory, ~/.claude/skills/, or in a project's .claude/skills/ folder if you want it available only inside that project.
If you use the Claude apps instead, open Settings, go to Capabilities, and upload the skill under Skills.
- Personal install: ~/.claude/skills/
- Project install: .claude/skills/ inside the project folder
- Claude apps: Settings → Capabilities → Skills
How to trigger the skill with a natural request
You do not need to type the skill name. Describe the outcome in plain language: which file, which event, and that you want the attendees to get access. The agent will match the request to the skill's description, which is about sharing Drive files with all attendees of a Calendar event.
Give the agent enough detail to find both items. If you have the event ID and file ID, include them. Otherwise, name the meeting and the document clearly so the agent can look them up.
- "Share the Q3 budget spreadsheet with everyone invited to Thursday's planning meeting."
- "Give read-only access to the workshop slides to all attendees of the onboarding session."
- "Share file FILE_ID with the attendees of event EVENT_ID, then show me who has access."
What the agent runs behind the scenes
The recipe uses three gws commands. The agent fetches the event's attendees, creates a reader permission for each attendee email address, and lists the permissions on the file for verification. You can read these commands in SKILL.md to see exactly what will run before you approve it.
gws calendar events get --params '{"calendarId": "primary", "eventId": "EVENT_ID"}'
gws drive permissions create --params '{"fileId": "FILE_ID"}' --json '{"role": "reader", "type": "user", "emailAddress": "attendee@company.com"}'
gws drive permissions list --params '{"fileId": "FILE_ID"}' --format tableSafety notes: scripts and network access
This skill runs scripts and uses the network. It calls Google Workspace services through gws, so it reads calendar data and changes Drive sharing settings for your account. Read the commands before you let the agent run them.
The skill grants access to every attendee automatically. Its instructions do not include a confirmation step, and it does not filter by email domain. Do not use it for sensitive or confidential documents with a broad attendee list, and check your policy before sharing with addresses outside your organisation.
- Confirm the file ID and event ID are the ones you intend.
- Check the attendee list the agent retrieves before sharing continues.
- Run the verification step and review the permissions table afterwards.
- Use it only where your sharing policy allows outside addresses if the event includes external guests.
Tips for reliable results
Use a precise file name or ID so the agent does not share the wrong document. Keep the event attendee list accurate, because the skill shares with whoever is invited. For recurring meetings, the same request works each time, but check the attendee list first because it may have changed.
- Prefer file and event IDs over vague names.
- Review the permissions table after each share.
- Test on a low-stakes document and a calendar event you own before relying on it.
What people use it for
- Sending a meeting agenda or slide deck to everyone invited to a team meeting
- Giving read-only access to workshop materials for an onboarding session
- Distributing a pre-read document before a recurring planning call
- Letting an assistant share documents for meetings they manage on someone else's behalf
- Building an automated workflow on top of gws that shares files after events
Frequently asked questions
Is the recipe-share-event-materials skill free?
The skill is published under the Apache-2.0 licence, as listed on this page. Check the licence file in the source repository for the full terms. The gws tool and your Google account have their own requirements.
What do I need to install before using this skill?
You need the gws command-line tool, authenticated with a Google account that has Calendar and Drive access. You also need the gws-calendar and gws-drive skills, because the recipe loads them first.
How do I install the skill?
Download the ZIP from this page and unzip it into ~/.claude/skills/ for personal use or a project's .claude/skills/ folder for one project. In the Claude apps, upload it under Settings → Capabilities → Skills.
Does the skill give attendees edit access?
No. The recipe creates reader permissions, which give each attendee read-only (viewer) access to the file.
Can I share with only people from my own company?
Not with this skill. The recipe does not filter attendees by domain, so it shares with every attendee on the event. Check your policy and the attendee list before running it.
Why does the skill fail or do nothing?
The most likely cause is that gws is not installed or not authenticated, or the gws-calendar and gws-drive skills are missing. Confirm those first, then check that your account has Calendar and Drive permissions and that the event and file IDs are correct.
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 organisers and assistants who regularly send read-only materials to everyone on a calendar event and want the agent to handle the steps and the verification. It is a poor fit for confidential documents, large or external attendee lists, or anyone without the gws tool set up with Google Workspace access. In those cases, share the file manually or use a tool with confirmation and domain controls.
Download the skill