# Gws Workflow File Announce

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

Source: https://skillsagentes.com/skills/googleworkspace/cli/gws-workflow-file-announce
Repository: https://github.com/googleworkspace/cli
Author: googleworkspace
License: Apache-2.0
Updated: hace 4 meses
Context cost: 14 tok installed, 372 tok once triggered, 372 tok with every bundled file
Bundle: 1 file, 1 KB
Permissions requested: none declared

## Install

```bash
npx -y skills add googleworkspace/cli --skill gws-workflow-file-announce --agent claude-code
```

## What it does

- Anuncia un archivo de Drive en un espacio de Chat usando `gws workflow +file-announce --file-id <ID> --space <SPACE>`
- Obtiene el nombre del archivo desde Drive para construir el mensaje de anuncio
- Permite personalizar el mensaje con `--message` y elegir formato de salida con `--format`

## Use it when

- Necesitas notificar en un espacio de Google Chat que un archivo de Drive está disponible
- Ya subiste un archivo con `gws drive +upload` y quieres avisar a un espacio de Chat

## What triggers it

- "Anuncia el archivo FILE_ID en el espacio spaces/ABC123 de Chat"
- "Sube este archivo a Drive y luego avísalo en el chat del equipo con un mensaje personalizado"

## Before you install

- Requiere el binario `gws` configurado y leer ../gws-shared/SKILL.md para auth, flags globales y reglas de seguridad.

## Files

- SKILL.md — 1 KB

## SKILL.md

Reproduced verbatim from googleworkspace/cli under Apache-2.0. This section is the upstream document and is in English.

# 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

---

Skills Agentes — https://skillsagentes.com/skills/googleworkspace/cli/gws-workflow-file-announce