Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot official · Google

gws-workflow-file-announce — Claude Code skill for Chat file

This skill posts a Google Drive file announcement to a Google Chat space. Use it when you want an agent to share a file in chat.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add googleworkspace/cli --skill gws-workflow-file-announce -a claude-code
Open on GitHub

What gws-workflow-file-announce does

The skill fetches the file name from Google Drive and uses it in an announcement to the selected Google Chat space. Pass --message to supply custom announcement text.

It requires gws and the shared auth and flags instructions in ../gws-shared/SKILL.md. If that file is missing, run gws generate-skills. This is a write command: it sends a Chat message. Upload the file first with gws drive +upload.

Install it when you want an agent to announce Drive files in Chat. Skip it if you plan to send those messages manually.

What it helps with

  • announce a Drive file in a Google Chat space
  • share an uploaded file in chat
  • add custom text to a file announcement

Example prompts for the agent

  • Announce Drive file FILE_ID in spaces/ABC123.
  • Post an announcement for FILE_ID in spaces/ABC123 with the message 'Please check this file'.
  • Upload the file with gws drive +upload, then announce it in Google Chat.

How to install gws-workflow-file-announce

1Skills CLI (Vercel)

npx skills add googleworkspace/cli --skill gws-workflow-file-announce -a claude-code

2Manually: put the files in place

~/.claude/skills/gws-workflow-file-announce/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/gws-workflow-file-announce/

From the same set95

The whole set →
gws-gmail official googleworkspace This skill hands your agent Gmail: send mail, read the inbox, reply in a thread. Useful when email work already runs through the gws CLI. Claude Code CX Codex Cursor +1 81,900installs gws-gmail-send official googleworkspace A skill that teaches your agent to send Gmail from the terminal: recipients, subject, body, attachments and drafts. Claude Code CX Codex Cursor +1 74,700installs gws-drive official googleworkspace This skill hands your agent Google Drive through the gws CLI: files, folders, shared drives, comments and access requests. Useful when docs move through code. Claude Code CX Codex Cursor +1 74,500installs gws-shared official googleworkspace This skill gives agents shared rules for gws CLI authentication, flags, and output formats. Use it when working with gws commands. Claude Code CX Codex Cursor +1 66,000installs gws-calendar official googleworkspace Manage Google Calendar events, access rules, and schedules through the gws CLI tool. Claude Code CX Codex Cursor +1 61,100installs gws-sheets official googleworkspace This skill lets an agent read and edit Google Sheets through the CLI. Use it when a coding workflow needs spreadsheet data or table updates. Claude Code CX Codex Cursor +1 58,800installs gws-docs official googleworkspace This skill lets an agent read and update Google Docs through gws. Use it when document changes should happen from an agent chat. Claude Code CX Codex Cursor +1 58,300installs gws-sheets-read official googleworkspace Reads cell values and sheets from Google Spreadsheets via CLI. Useful when an agent needs spreadsheet data without risk of altering it. Claude Code CX Codex Cursor +1 50,600installs

Similar

Questions about gws-workflow-file-announce

How do I install gws-workflow-file-announce in Claude Code?

Run npx skills add googleworkspace/cli --skill gws-workflow-file-announce -a claude-code.

What does gws-workflow-file-announce do?

It fetches a file name from Google Drive and posts an announcement to a selected Google Chat space. You can set the message with --message.

What do I need before using the skill?

You need gws and the instructions in ../gws-shared/SKILL.md for authentication, global flags, and security. Upload the file to Drive before announcing it.

Source text

SKILL.md · Apache-2.0
---
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

```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

© googleworkspace · Apache-2.0 · googleworkspace/cli

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor