Gws Workflow File Announce
Post a Google Drive file link into a Google Chat space so your launch asset or spec reaches the team in one command.
Overview
Gws Workflow File Announce is an agent skill for the Launch phase that announces a Drive file in a Google Chat space via the gws workflow +file-announce command.
Install
npx skills add https://github.com/googleworkspace/cli --skill gws-workflow-file-announceWhat is this skill?
- Single command: `gws workflow +file-announce --file-id --space`
- Optional custom `--message` for launch copy
- Write command—sends a Chat message (documented tip)
- Fetches file name from Drive to build the announcement
- Pairs with `gws drive +upload` then announce workflow
- Required flags: --file-id and --space
- Documented output formats: json, table, yaml, csv
Adoption & trust: 15.9k installs on skills.sh; 26.9k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You uploaded a launch file to Drive but teammates still ask which link or version is canonical in Chat.
Who is it for?
Internal handoffs when file ID and Chat space name are already known.
Skip if: Public social distribution, email campaigns, or announcing files you have not uploaded—use drive +upload first.
When should I use this skill?
You need to announce a Drive file in a Chat space after upload or when sharing an existing file ID.
What do I get? / Deliverables
A Chat announcement is sent with Drive-derived file naming after you pass file-id and space, optionally with a custom message.
- Chat message announcing the Drive file
- CLI output in chosen format (default json)
Recommended Skills
Journey fit
Announcing a file in Chat is a distribution moment—shipping visibility to collaborators right after the asset lands in Drive. Launch distribution includes internal comms; file-announce automates the Drive lookup plus Chat message writers usually do by hand.
How it compares
Cross-service gws workflow command—not a Chat bot framework or Slack webhook integration.
Common Questions / FAQ
Who is gws-workflow-file-announce for?
Solo builders and small teams using Google Chat and Drive who want CLI-driven internal file announcements from their coding agent.
When should I use gws-workflow-file-announce?
At launch distribution when a spec, deck, or build artifact is in Drive and you need it called out in a team Chat space immediately after upload.
Is gws-workflow-file-announce safe to install?
It performs a Chat write via gws; review the Security Audits panel on this Prism page and confirm Chat and Drive OAuth scopes before automating announcements.
SKILL.md
READMESKILL.md - Gws Workflow File Announce
# 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 ```bash 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 ```bash 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 +upload` first to upload the file, then announce it here. - Fetches the file name from Drive to build the announcement. ## See Also - [gws-shared](../gws-shared/SKILL.md) — Global flags and auth - [gws-workflow](../gws-workflow/SKILL.md) — All cross-service productivity workflows commands