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.
npx skills add googleworkspace/cli --skill gws-workflow-file-announce -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/gws-workflow-file-announce/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/gws-workflow-file-announce/
1Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-workflow-file-announce -a codex2Manually: put the files in place
.agents/skills/gws-workflow-file-announce/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-workflow-file-announce -a cursor2Manually: put the files in place
.cursor/skills/gws-workflow-file-announce/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install googleworkspace/cli gws-workflow-file-announce2Manually: put the files in place
.github/skills/gws-workflow-file-announce/SKILL.md1Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-workflow-file-announce -a gemini-cli2Platform CLI
gemini skills install https://github.com/googleworkspace/cli --path skills/gws-workflow-file-announceManually: put the files in place
.devin/skills/gws-workflow-file-announce/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-workflow-file-announce -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set95
The whole set →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