← Back to Skills Marketplace
Gws Workflow File Announce
by
googleworkspace-bot
· GitHub ↗
· v1.0.12
· MIT-0
293
Downloads
0
Stars
12
Active Installs
13
Versions
Install in OpenClaw
/install gws-workflow-file-announce
Description
Google Workflow: Announce a Drive file in a Chat space.
README (SKILL.md)
workflow +file-announce
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
Announce a Drive file in a Chat space
Usage
gws workflow +file-announce --file-id \x3CID> --space \x3CSPACE>
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
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 +uploadfirst to upload the file, then announce it here. - Fetches the file name from Drive to build the announcement.
See Also
- gws-shared — Global flags and auth
- gws-workflow — All cross-service productivity workflows commands
Usage Guidance
This skill itself is a small wrapper that calls the 'gws' CLI to announce a Drive file to a Chat space, but it defers authentication and security rules to ../gws-shared/SKILL.md which is not included. Before installing or using this skill: (1) inspect the referenced gws-shared SKILL.md to see exactly what credentials (Google OAuth client, service account, environment vars, token files) and scopes are required and where they are stored; (2) verify the origin and trustworthiness of the 'gws' CLI binary on your system (who installed it, is it an official release); (3) ensure the required scopes are minimal (Drive read and Chat write only) and that no unrelated credentials are being requested; (4) be aware this skill will send messages into Chat spaces (possible spam/exfil vectors) so confirm the target space IDs and message content handling; and (5) if you cannot review gws-shared or the gws CLI source, treat this skill as risky and avoid granting it credentials.
Capability Analysis
Type: OpenClaw Skill
Name: gws-workflow-file-announce
Version: 1.0.12
The skill bundle provides documentation for a Google Workspace workflow to announce Drive files in Chat spaces using the 'gws' CLI. The SKILL.md file contains standard usage instructions and flags without any evidence of malicious intent, prompt injection, or suspicious execution patterns.
Capability Assessment
Purpose & Capability
Name/description match the requested binary 'gws' and the command shown. However, the skill defers authentication and global flags to ../gws-shared/SKILL.md — those unstated dependencies likely include Drive read and Chat write credentials that are not declared here. The binary requirement is reasonable for the stated purpose but the external auth dependency is not surfaced in the skill metadata.
Instruction Scope
The SKILL.md instructs the agent to run a single gws workflow command that fetches a Drive file name and sends a Chat message. The runtime instructions themselves stay within the announced scope, but they explicitly require the agent to consult ../gws-shared/SKILL.md for auth, global flags, and security rules — meaning the actual runtime behavior depends on another file not included or declared, which hides the full instruction surface.
Install Mechanism
No install spec and no code files (instruction-only), which minimizes on-disk risk. The skill only requires the 'gws' binary to be present; there is no download/extract behavior in this package.
Credentials
The skill declares no environment variables or primary credential, yet it is a write operation (posts chat messages) and needs to read Drive metadata. Those credentials/scopes are likely required but are hidden in the referenced ../gws-shared/SKILL.md. Hiding required credentials in an external doc makes it hard to evaluate whether the skill requests excessive or unrelated secrets.
Persistence & Privilege
always is false and the skill is user-invocable only; it does not request persistent/system-wide changes. Autonomous invocation is allowed by default but is not combined with elevated privileges here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install gws-workflow-file-announce - After installation, invoke the skill by name or use
/gws-workflow-file-announce - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.12
- Updated internal metadata version from 0.22.4 to 0.22.5 in SKILL.md.
- No changes to functionality or usage.
v1.0.11
- Updated skill metadata version from 0.22.3 to 0.22.4 in SKILL.md.
v1.0.10
- Updated metadata version from 0.22.2 to 0.22.3 in SKILL.md file.
v1.0.9
- Updated metadata version in SKILL.md from 0.22.1 to 0.22.2.
- No other user-facing changes.
v1.0.8
- Updated skill metadata version from 0.22.0 to 0.22.1 in SKILL.md.
- No other content changes.
v1.0.7
- Updated skill metadata version to 0.22.0 in documentation (was 0.21.2).
- No functionality changes—documentation version only.
v1.0.6
- Updated metadata version from 0.21.1 to 0.21.2 in SKILL.md.
- No changes to functionality or documentation content.
v1.0.5
- Updated skill metadata version from 0.20.1 to 0.21.1 in SKILL.md.
- No functional or usage changes.
v1.0.4
- Updated skill metadata version from 0.20.0 to 0.20.1 in SKILL.md.
v1.0.3
- Updated version in SKILL.md from 0.19.0 to 0.20.0.
- No other content changes.
- No changes to usage, flags, examples, or tips.
v1.0.2
- Updated skill metadata: moved version to metadata block and set to 0.19.0.
- Removed the redundant version field from the root level of SKILL.md.
v1.0.1
- Fixed indentation in the metadata.requires.bins section for consistency.
- No functional or usage changes; documentation update only.
v1.0.0
Initial release: Announce a Google Drive file in a Google Chat space.
- Adds the workflow +file-announce command to announce files in chat spaces.
- Supports file selection by Drive file ID and specifying the target Chat space.
- Allows optional custom announcement message and output formatting.
- Integrates with authentication and global flags from gws-shared.
- Includes usage examples and tips for best results.
Metadata
Frequently Asked Questions
What is Gws Workflow File Announce?
Google Workflow: Announce a Drive file in a Chat space. It is an AI Agent Skill for Claude Code / OpenClaw, with 293 downloads so far.
How do I install Gws Workflow File Announce?
Run "/install gws-workflow-file-announce" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Gws Workflow File Announce free?
Yes, Gws Workflow File Announce is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Gws Workflow File Announce support?
Gws Workflow File Announce is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Gws Workflow File Announce?
It is built and maintained by googleworkspace-bot (@googleworkspace-bot); the current version is v1.0.12.
More Skills