gws-workflow-file-announce

googleworkspace/cli

Announce a Google Drive file in a Chat space with a single command.

What is gws-workflow-file-announce?

This skill automates sharing Drive file announcements to Google Chat spaces. Use it to notify team members about newly uploaded or important files with optional custom messages.

Sends a formatted announcement message to a specified Chat space
Automatically fetches and includes the Drive file name in the announcement
Supports custom announcement messages for context
Outputs results in multiple formats (JSON, table, YAML, CSV)
Integrates with gws drive upload workflow for seamless file sharing

How to install gws-workflow-file-announce

npx skills add null --skill gws-workflow-file-announce

Prerequisites

Google Workspace CLI (gws) installed and configured
Valid Google Workspace authentication (see gws-shared skill)
Drive file ID of the file to announce
Target Chat space ID (format: spaces/SPACE_ID)

Claude Code

Cursor

Windsurf

Cline

How to use gws-workflow-file-announce

1.Obtain the Drive file ID (from gws drive commands or Drive URL)
2.Identify the target Chat space ID
3.Run: gws workflow +file-announce --file-id <ID> --space spaces/<SPACE_ID>
4.Optionally add --message '<text>' for a custom announcement
5.Check the output to confirm the message was sent

Use cases

Good for

Notify a team channel when a new report or document is uploaded to Drive
Announce project deliverables to stakeholders in Chat
Share important files with custom context or instructions
Automate file distribution notifications in team workflows

Who it's for

Team leads coordinating file sharing
Project managers announcing deliverables
Automation engineers building productivity workflows
Google Workspace administrators managing team communication

gws-workflow-file-announce FAQ

Do I need to upload the file first?

Not necessarily, but the skill works best when combined with gws drive +upload. You just need a valid Drive file ID.

Can I customize the announcement message?

Yes, use the --message flag to add custom text. Without it, a default announcement with the file name is sent.

What Chat space format should I use?

Use the full space ID format: spaces/SPACE_ID (e.g., spaces/ABC123). You can find this in Chat space settings.

What output formats are supported?

The skill supports json (default), table, yaml, and csv formats via the --format flag.

Is this a read-only command?

No, this is a write command that sends a Chat message. Ensure you have permission to post in the target space.

Full instructions (SKILL.md)

Source of truth, from googleworkspace/cli.

name: gws-workflow-file-announce description: "Google Workflow: Announce a Drive file in a Chat space." metadata: version: 0.22.5 openclaw: category: "productivity" requires: bins: - gws cliHelp: "gws workflow +file-announce --help"

workflow +file-announce

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to 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!'