Manage Google Chat spaces, messages, custom emojis, and media through API commands.
Works with
Access 10+ API resources including spaces, messages, members, custom emojis, and media with create, read, update, delete, and search operations
Create and manage spaces with initial members, find or list direct messages, and handle space imports and deletion
Upload and download media attachments, and manage custom emojis (Google Workspace only, requires admin enablement)
Requires gws binary and aut
AI-first code editor with Composer
Before installing skills in Cursor, ensure your development environment meets these requirements:
node --versiongws-chatExecute the skills CLI command in your project's root directory to begin installation:
Fetches gws-chat from googleworkspace/cli and configures it for Cursor.
The CLI shows a list of agents. Use arrow keys and space to select Cursor:
Confirm successful installation by checking the skill directory location:
Restart Cursor to activate gws-chat. Access via /gws-chat in your agent's command palette.
We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.
Skills execute code in your environment. Always review source, verify the publisher, and test in isolation before production.
Submit your Claude Code skill and start earning
Create detailed user stories, acceptance criteria, and feature specs
Example
Generate user stories for 'password reset feature' with acceptance criteria, edge cases, and test scenarios
Reduce spec writing time by 50%, ensure comprehensive coverage
Research competitors, compare features, identify gaps
Example
Analyze 5 competitor products, create feature comparison matrix, suggest differentiation opportunities
Complete competitive research in 2 hours instead of 2 days
Evaluate features using frameworks (RICE, ICE, Kano) and create prioritized backlogs
Example
Score 20 feature ideas using RICE framework, generate prioritized roadmap with rationale
0
total installs
0
this week
23.9K
GitHub stars
0
upvotes
Run in your terminal
0
installs
0
this week
23.9K
stars
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
gws chat <resource> <method> [flags]
| Command | Description |
|---|---|
+send |
Send a message to a space |
create — Creates a custom emoji. Custom emojis are only available for Google Workspace accounts, and the administrator must turn custom emojis on for the organization. For more information, see Learn about custom emojis in Google Chat and Manage custom emoji permissions.delete — Deletes a custom emoji. By default, users can only delete custom emoji they created. Emoji managers assigned by the administrator can delete any custom emoji in the organization. See Learn about custom emojis in Google Chat. Custom emojis are only available for Google Workspace accounts, and the administrator must turn custom emojis on for the organization.get — Returns details about a custom emoji. Custom emojis are only available for Google Workspace accounts, and the administrator must turn custom emojis on for the organization. For more information, see Learn about custom emojis in Google Chat and Manage custom emoji permissions.list — Lists custom emojis visible to the authenticated user. Custom emojis are only available for Google Workspace accounts, and the administrator must turn custom emojis on for the organization. For more information, see Learn about custom emojis in Google Chat and Manage custom emoji permissions.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.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' resourcemessages — Operations on the 'messages' resourcespaceEvents — Operations on the 'spaceEvents' resourcesections — Operations on the 'sections' resourcespaces — Operations on the 'spaces' resourceBefore 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.
Make data-driven prioritization decisions faster
Draft PRDs, status updates, and stakeholder presentations
Example
Create executive summary of Q3 roadmap, monthly progress report, feature launch announcement
Save 3-5 hours/week on communication overhead
Prerequisites
Time Estimate
30-60 minutes to see productivity improvements
Steps
Common Pitfalls
✓ Do
✗ Don't
💡 Pro Tips
✓ Use when
Use for user story writing, competitive research, roadmap prioritization, stakeholder communication, and PRD drafting. Best for reducing repetitive documentation and research work.
✗ Avoid when
Avoid for strategic product vision (requires deep customer empathy), pricing decisions (needs market and financial expertise), or when face-to-face customer discovery is more valuable than speed.
mattpocock/skills
parcadei/continuous-claude-v3
cursor/plugins
ailabs-393/ai-labs-claude-skills
ailabs-393/ai-labs-claude-skills
pproenca/dot-skills
gws-chat is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
We added gws-chat from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
gws-chat reduced setup friction for our internal harness; good balance of opinion and flexibility.
gws-chat reduced setup friction for our internal harness; good balance of opinion and flexibility.
Registry listing for gws-chat matched our evaluation — installs cleanly and behaves as described in the markdown.
Keeps context tight: gws-chat is the kind of skill you can hand to a new teammate without a long onboarding doc.
Registry listing for gws-chat matched our evaluation — installs cleanly and behaves as described in the markdown.
gws-chat fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
gws-chat fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
gws-chat has been reliable in day-to-day use. Documentation quality is above average for community skills.
showing 1-10 of 60