gws-workflow-file-announce
Lets your agent announce Google Drive files in Google Chat spaces. It facilitates document sharing with teams.
What it does
This command sends a message to a Google Chat space announcing a Google Drive file. It uses the file ID and space name to make the announcement.
When to use it
- ✓When you want your team to see an important new document.
- ✓To quickly share a work file with a specific group.
- ✓When updating a document and wanting to notify relevant people.
Example of what to ask your AI
“Announce file 'XYZ123' in space 'My Team'.”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
You provide the Google Drive file ID and the Google Chat space name. The tool fetches the file name and creates the announcement message for you.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add googleworkspace/cli --skill gws-workflow-file-announceOr download just the file:
curl -L https://raw.githubusercontent.com/googleworkspace/cli/main/skills/gws-workflow-file-announce/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
workflow +file-announce
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
Announce a Drive file in a Chat space
Usage
gws workflow +file-announce --file-id <ID> --space <SPACE>
Flags
| Flag | Required | Default | Description |
|---|---|---|---|
--file-id |
✓ | — | Drive file ID to announce |
--space |
✓ | — | Chat space name (e.g. spaces/SPACE_ID) |
--message |
— | — | Custom announcement message |
--format |
— | — | Output format: json (default), table, yaml, csv |
Examples
gws workflow +file-announce --file-id FILE_ID --space spaces/ABC123
gws workflow +file-announce --file-id FILE_ID --space spaces/ABC123 --message 'Check this out!'
Tips
- This is a write command — sends a Chat message.
- Use
gws drive +uploadfirst to upload the file, then announce it here. - Fetches the file name from Drive to build the announcement.
See Also
- gws-shared — Global flags and auth
- gws-workflow — All cross-service productivity workflows commands
FAQ
Do I need to do anything before using this command?
Yes, you need to have the ID of the Google Drive file you want to announce. If the file hasn't been uploaded yet, you can use the `gws drive +upload` command first.
Can I add a custom message?
Yes, you can use the `--message` option to add an extra note to your announcement.
Where do I find the Google Drive file ID?
The file ID is the part of the Google Drive URL that comes after '/d/' and before '/edit' or '/view'.
Details
Original description by the author
Google Workflow: Announce a Drive file in a Chat space.
repo: googleworkspace/cli
Popularity
- GitHub stars
- 32k
- Ranking position
- #6289
- License
- Apache-2.0
- Updated
- 10/6/2026
Comments
- …
More skills from this repository
gws-admin-reports
Helps your agent get activity reports from Google Workspace. It collects audit and usage data.
googleworkspace/cli
gws-calendar-agenda
Helps your agent see upcoming events across all calendars. It's useful for organizing your schedule and knowing what's coming up.
googleworkspace/cli
gws-calendar-insert
Lets your agent create new events in Google Calendar. It's useful for scheduling appointments and meetings.
googleworkspace/cli
gws-calendar
Allows your agent to manage calendars and events. It's useful for organizing your life and work.
googleworkspace/cli
Similar skills
benchmark
Helps your agent measure code speed and performance. It's useful for ensuring things are fast and finding slowness issues.
affaan-m/ECC
content-hash-cache-pattern
Lets your agent use content hashes to cache file processing results. This avoids repeated processing and auto-invalidates the cache when content changes. Useful for speeding up slow tasks.
affaan-m/ECC
parallel-execution-optimizer
Makes your agent speed up complex tasks by breaking them into smaller parts and running them in parallel. It ensures everything is verified at the end.
affaan-m/ECC