📦
gws-sheets
82Manage Google Sheets with the gws CLI
Google Sheets API commands can be difficult to discover and structure correctly. This skill guides Claude and Codex through supported gws resources, methods, and flags.
Office & Reports View
Skills gws-gmail-watch
📦
gws-gmail-watch
v0.23.0 Content revision r2 Safe ⚙️ External commands📁 Filesystem access
Monitor Gmail Messages with Pub/Sub
New Gmail messages are difficult to monitor continuously through manual checks. This skill streams incoming messages as NDJSON through Google Cloud Pub/Sub.
Supports: Claude Codex Code(CC)
Install with my Agent
Copy this request to your Agent. It includes the canonical Skill page and manifest.
Agent request
Review the Skillstore skill "gws-gmail-watch" from https://skillstore.io/skills/googleworkspace-gws-gmail-watch.md and its manifest at https://skillstore.io/api/skills/googleworkspace-gws-gmail-watch/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.Your Agent should still show its plan and request any confirmation required by the security policy.
Agent-readable resources
Use these links when an AI agent, crawler, or script needs clean context instead of reading the full page.
Test it
Using "gws-gmail-watch". Watch the INBOX label once in project mail-automation.
Expected outcome:
The watcher connects through the project, pulls one batch of inbox messages, emits each result as NDJSON, and exits.
Using "gws-gmail-watch". Use my existing subscription and store each full message in the emails directory.
Expected outcome:
The watcher uses the supplied subscription, streams full message records, and writes each message to a separate file in the selected directory.
Using "gws-gmail-watch". Watch continuously and clean up resources when stopped.
Expected outcome:
The watcher polls until interrupted, stops gracefully, and removes the Pub/Sub resources created for the session.
Security Audit
Safev7 • 8/5/2026 Open versioned report
All 17 static findings are false positives caused by Markdown code formatting and fixed sibling documentation links. The reviewed skill contains no shell backtick execution, path traversal behavior, prompt injection, or malicious intent.
1
Files scanned
60
Lines analyzed
0
Review items
0
False positives ignored
Risk Factors
⚙️ External commands (14)
📁 Filesystem access (3)
No confirmed security findings were detected by the latest completed static and semantic audit. This does not prove the skill has no side effects.
Audited by: codex View Audit History →
Share & cite this report
Share the versioned assessment report, neutral badge, embed card, and citations. Skillstore reports evidence without deciding whether this Skill is safe.
Copy report link
https://skillstore.io/skills/googleworkspace-gws-gmail-watch/audits/7?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportMarkdown badge
[](https://skillstore.io/skills/googleworkspace-gws-gmail-watch?utm_source=security_passport_badge)HTML badge
<a href="https://skillstore.io/skills/googleworkspace-gws-gmail-watch?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/googleworkspace-gws-gmail-watch/security.svg" alt="Skillstore security assessment" loading="lazy"></a>Embed card
<iframe src="https://skillstore.io/embed/skills/googleworkspace-gws-gmail-watch.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>Academic citations (APA · BibTeX · CFF)
APA citation
googleworkspace. (2026). gws-gmail-watch security audit report (audit version 7) [Author version 0.23.0]. Skillstore. https://skillstore.io/skills/googleworkspace-gws-gmail-watch/audits/7BibTeX citation
@techreport{googleworkspace-googleworkspace-gws-gmail-watch-2026,
author = {googleworkspace},
title = {gws-gmail-watch security audit report (audit version 7)},
institution = {Skillstore},
year = {2026},
number = {7},
url = {https://skillstore.io/skills/googleworkspace-gws-gmail-watch/audits/7},
note = {Author version 0.23.0}
}CITATION.cff
cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "gws-gmail-watch security audit report (audit version 7)"
version: "0.23.0"
type: report
authors:
- name: "googleworkspace"
date-released: "2026-08-05"
url: "https://skillstore.io/skills/googleworkspace-gws-gmail-watch/audits/7"
identifiers:
- type: other
value: "skillstore:googleworkspace-gws-gmail-watch:audit:7"
description: "Skillstore immutable audit report identifier"
Skillstore Score
Why this score Evidence Confidence: High 55
Architecture
100
Maintainability
87
Content
68
Community
91
Spec Compliance
What You Can Build
Monitor an Operations Inbox
Stream new inbox messages into an event-processing workflow with controlled polling and batch sizes.
Test Gmail Automations
Pull one batch of labeled messages to verify an integration without running a continuous watcher.
Archive Incoming Messages
Write each watched message to a separate file for approved review or retention workflows.
Try These Prompts
Watch New Gmail Messages
Watch for new Gmail messages using my authenticated gws setup and stream the results as NDJSON.
Watch a Specific Label
Watch Gmail messages with the INBOX label in project [PROJECT_ID]. Pull one batch, then stop.
Use an Existing Subscription
Watch Gmail through Pub/Sub subscription [SUBSCRIPTION_NAME]. Use metadata format, pull up to [COUNT] messages, and poll every [SECONDS] seconds.
Persist and Clean Up
Watch labeled Gmail messages in project [PROJECT_ID]. Write each message to [OUTPUT_DIRECTORY], then remove resources created by this session on exit.
Best Practices
- Use the narrowest Gmail labels and message format required for the workflow.
- Protect output files because full Gmail messages can contain sensitive information.
- Use an existing Pub/Sub subscription when resource lifecycle is managed elsewhere.
Avoid
- Do not enable cleanup when other workflows depend on the created Pub/Sub resources.
- Do not store full messages in a broadly accessible directory.
- Do not assume the watch remains active beyond seven days.
Frequently Asked Questions
What does this skill monitor?
It monitors new Gmail messages and streams their data as NDJSON.
Does it require a Google Cloud project?
A project is needed for setup unless you provide an existing Pub/Sub subscription or prepared topic.
Can I watch only selected messages?
Yes. Use Gmail label IDs such as INBOX or UNREAD to limit the watch.
Can it run only once?
Yes. Single-pull mode retrieves one batch and then exits.
Where can message data be stored?
The default output is an NDJSON stream. An output directory can store each message in a separate file.
How long does a Gmail watch last?
A Gmail watch expires after seven days. Run the command again to renew it.
Developer Details
Author
googleworkspaceLicense
MIT
Author version
v0.23.0
Skillstore revision
r2
Ref
286d37c9c189ddd1aafd3548415fb031d1df79d5
Maintenance freshness
8/6/2026
Usage
5 downloads · 85 views
File structure
📄 SKILL.md
More from googleworkspace
View all📦
gws-docs
82Manage Google Docs with the gws CLI
Google Docs automation can require precise API commands and request formats. This skill guides Claude, Codex, and Claude Code through gws document operations.
Office & Reports View
📦
gws-calendar
82Manage Google Calendar with the gws CLI
Calendar administration often requires precise API methods and parameters. This skill guides Claude, Codex, and Claude Code through Google Calendar operations using the gws CLI.
Productivity View
📦
gws-gmail
81Manage Gmail with Google Workspace CLI
Managing Gmail through API commands requires accurate resource names and parameters. This skill guides Claude and Codex through supported Gmail CLI workflows.
Communication View
📦
gws-shared
81Use Google Workspace CLI Safely
Google Workspace CLI tasks can fail because authentication, flags, and shell quoting vary. This skill provides shared patterns for reliable and safer gws commands.
Office & Reports View
📦
gws-gmail-send
80Send Gmail Messages from the Command Line
Preparing Gmail commands with recipients, content, copies, and attachments can be error-prone. This skill guides Claude and Codex through safe gws message sending.
Office & Reports View
Related Skills
View all📦
linear-projects-write
81Create and Update Linear Projects from the CLI
by Bind
Managing Linear projects through the web interface is slow when you work in the terminal or automate workflows. This skill lets you create and update projects with simple commands, so you can manage project data directly from scripts and the command line.
Productivity View
📦
lark-doc
87Manage Lark Docs and Feishu Wiki Content
by larksuite
Teams need reliable document updates without switching between tools. This skill guides Claude, Codex, and Claude Code through authenticated lark-cli workflows for Lark Docs.
Office & Reports View
📦
pptx
85Create PowerPoint Presentations with Python
by AutumnsGrove
Building polished PowerPoint decks by hand is slow and hard to repeat. This skill guides Claude, Codex, and Claude Code through PPTX creation, editing, and automation with python-pptx.
Office & Reports View
📦
building-agents
85Build Claude Code Agents
by C0ntr0lledCha0s
Creating reliable AI agents requires clear schemas, safe tools, and repeatable review steps. This skill guides agent design, validation, migration, and maintenance for Claude Code workflows.
Coding & Development View
📦
building-commands
84Build Claude Code Slash Commands
by C0ntr0lledCha0s
Teams need repeatable AI workflows that are easy to invoke and review. This skill helps create, update, validate, and document Claude Code slash commands.
Coding & Development View
📦
creating-issues
84Create Consistent GitHub Issues
by C0ntr0lledCha0s
Poorly structured issues create ambiguity and require manual cleanup. This skill drafts and validates titles, bodies, labels, milestones, projects, and relationships.
Coding & Development View