SkillAgentSearch skills...

gws-chat

Google Chat: Manage Chat spaces and messages.

Install / Use

npx skills add googleworkspace/cli --skill gws-chat

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

86/100

Category

Security

Supported Platforms

Universal

Our assessment of gws-chat

gws-chat scores 86/100 on our quality scale, 726th of 1,111 Security skills we index.

Its SKILL.md is 5.6 KB long, well organised into 10 sections with 2 code examples: a solid amount of guidance for an agent.

With 31,133 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
26/30
Structure
18/20
Description
8/15
Adoption
19/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so gws-chat is actively maintained.
  • Our last check on 2026-11-03 found the source still online.
  • It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-09-27. Automated pattern scan on 2026-09-26. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

gws-chat compared with similar skills

All 4 of these similar skills score higher than gws-chat; compare them before choosing.

SkillScoreStarsUpdatedFormat
gws-chat (this skill)by googleworkspace8631.1k53d agoSKILL.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md
Scraplingby D4Vinci100103.6k2d agoMCP Server
crawl4aiby unclecode10087.4k3d agoMCP Server

Frequently asked questions

How do I install gws-chat?
Run npx skills add googleworkspace/cli --skill gws-chat. The install tabs above show the steps for each supported agent.
Which AI agents does gws-chat work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is gws-chat safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is gws-chat still maintained?
The repository was last updated about 2 months ago, so gws-chat is actively maintained.

name: gws-chat description: "Google Chat: Manage Chat spaces and messages." metadata: version: 0.22.5 openclaw: category: "productivity" requires: bins: - gws cliHelp: "gws chat --help"

chat (v1)

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

gws chat <resource> <method> [flags]

Helper Commands

| Command | Description | |---------|-------------| | +send | Send a message to a space |

API Resources

customEmojis

media

  • download — Downloads media. Download is supported on the URI /v1/media/{+name}?alt=media.
  • upload — Uploads an attachment. For an example, see Upload media as a file attachment.

spaces

  • completeImport — Completes the import process for the specified space and makes it visible to users.
  • create — Creates a space. Can be used to create a named space, or a group chat in Import mode. For an example, see Create a space.
  • delete — Deletes a named space. Always performs a cascading delete, which means that the space's child resources—like messages posted in the space and memberships in the space—are also deleted. For an example, see Delete a space.
  • findDirectMessage — Returns the existing direct message with the specified user. If no direct message space is found, returns a 404 NOT_FOUND error. For an example, see Find a direct message. With app authentication, returns the direct message space between the specified user and the calling Chat app.
  • get — Returns details about a space. For an example, see Get details about a space.
  • list — Lists spaces the caller is a member of. Group chats and DMs aren't listed until the first message is sent. For an example, see List spaces.
  • patch — Updates a space. For an example, see Update a space. If you're updating the displayName field and receive the error message ALREADY_EXISTS, try a different display name.. An existing space within the Google Workspace organization might already use this display name.
  • search — Returns a list of spaces in a Google Workspace organization based on an administrator's search. In the request, set use_admin_access to true. For an example, see Search for and manage spaces.
  • setup — Creates a space and adds specified users to it. The calling user is automatically added to the space, and shouldn't be specified as a membership in the request. For an example, see Set up a space with initial members. To specify the human members to add, add memberships with the appropriate membership.member.name. To add a human user, use users/{user}, where {user} can be the email address for the user.
  • members — Operations on the 'members' resource
  • messages — Operations on the 'messages' resource
  • spaceEvents — Operations on the 'spaceEvents' resource

users

  • sections — Operations on the 'sections' resource
  • spaces — Operations on the 'spaces' resource

Discovering Commands

Before calling any API method, inspect it:

# Browse resources and methods
gws chat --help

# Inspect a method's required params, types, and defaults
gws schema chat.<resource>.<method>

Use gws schema output to build your --params and --json flags.

Related Skills

View on GitHub
GitHub Stars31.1k
CategorySecurity
Updated1mo ago
Forks1.8k

Languages

Rust

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions