# Gws Workflow File Announce

Google Workflow: Announce a Drive file in a Chat space.

- Repository: https://github.com/googleworkspace/cli (32044 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add googleworkspace/cli --skill gws-workflow-file-announce -g -a claude-code -y`
Codex: `npx skills add googleworkspace/cli --skill gws-workflow-file-announce -g -a codex -y`
Cursor: `npx skills add googleworkspace/cli --skill gws-workflow-file-announce -g -a cursor -y`
Gemini CLI: `npx skills add googleworkspace/cli --skill gws-workflow-file-announce -g -a gemini-cli -y`

## Description

Google Workflow: Announce a Drive file in a Chat space.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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