← Back to Skills Marketplace
Gws Gmail Triage
by
googleworkspace-bot
· GitHub ↗
· v1.0.12
· MIT-0
655
Downloads
0
Stars
16
Active Installs
13
Versions
Install in OpenClaw
/install gws-gmail-triage
Description
Gmail: Show unread inbox summary (sender, subject, date).
README (SKILL.md)
gmail +triage
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
Show unread inbox summary (sender, subject, date)
Usage
gws gmail +triage
Flags
| Flag | Required | Default | Description |
|---|---|---|---|
--max |
— | 20 | Maximum messages to show (default: 20) |
--query |
— | — | Gmail search query (default: is:unread) |
--labels |
— | — | Include label names in output |
Examples
gws gmail +triage
gws gmail +triage --max 5 --query 'from:boss'
gws gmail +triage --format json | jq '.[].subject'
gws gmail +triage --labels
Tips
- Read-only — never modifies your mailbox.
- Defaults to table output format.
See Also
- gws-shared — Global flags and auth
- gws-gmail — All send, read, and manage email commands
Usage Guidance
This skill delegates authentication and global flags to '../gws-shared/SKILL.md' but does not include or declare those credentials here. Before installing, inspect the referenced gws-shared SKILL.md and confirm what auth it requires (OAuth tokens, local config files, or environment variables). Verify the provenance and trustworthiness of the 'gws' CLI on your system (where it came from, its documentation, and whether the triage command is truly read-only). If you can't review gws-shared or the gws binary, treat the skill as untrusted because it may cause the agent to read or use Gmail credentials not declared in this skill. To reduce risk, run gws commands manually first, or run the agent in an isolated environment with limited access to your actual Gmail credentials.
Capability Analysis
Type: OpenClaw Skill
Name: gws-gmail-triage
Version: 1.0.12
The skill bundle contains documentation and instructions for an AI agent to use a CLI tool named 'gws' to summarize unread Gmail messages. The content in SKILL.md and _meta.json is strictly limited to describing legitimate functionality (listing sender, subject, and date) and lacks any executable code, suspicious network calls, or malicious prompt injection attempts.
Capability Assessment
Purpose & Capability
The name/description (show unread inbox summary) aligns with requiring the 'gws' CLI. Requiring the gws binary is proportionate for a CLI-based Gmail helper.
Instruction Scope
The SKILL.md explicitly instructs the agent to 'Read ../gws-shared/SKILL.md for auth, global flags, and security rules.' That means runtime behavior depends on another file outside this skill; that file may contain auth instructions or reference credentials/config paths. The instructions themselves are otherwise minimal and read-only, but the external dependency creates an opaque surface.
Install Mechanism
Instruction-only skill with no install step — nothing is written to disk by the skill itself. This lowers install-time risk.
Credentials
The skill declares no required env vars or config paths, yet points to a shared SKILL.md for auth. That suggests credential access is expected but not declared here. The gws CLI likely uses local config or OAuth tokens; those credentials are not described, so it's unclear what secrets the agent will need or access.
Persistence & Privilege
always is false and the skill is user-invocable; it does not request permanent or elevated platform presence.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install gws-gmail-triage - After installation, invoke the skill by name or use
/gws-gmail-triage - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.12
- Updated skill metadata version from 0.22.4 to 0.22.5 in SKILL.md.
- No other changes were made.
v1.0.11
- Updated skill metadata version from 0.22.3 to 0.22.4 in SKILL.md.
- No functional or documentation changes outside of the version number.
v1.0.10
- Updated version metadata from 0.22.2 to 0.22.3 in SKILL.md.
- No other content or functionality changes.
v1.0.9
- Bumped version from 0.22.1 to 0.22.2 in SKILL.md.
- No other content changes.
v1.0.8
- Updated metadata version from 0.22.0 to 0.22.1 in SKILL.md.
v1.0.7
- Updated version to 0.22.0 in SKILL.md (was 0.21.2).
- No other content changes.
v1.0.6
- Updated metadata version from 0.21.1 to 0.21.2 in SKILL.md.
- No functional or usage changes.
v1.0.5
- Bumped version from 0.20.1 to 0.21.1 in SKILL.md.
- No other content changes.
v1.0.4
- Updated skill metadata version from 0.20.0 to 0.20.1 in SKILL.md.
v1.0.3
- Bumped version to 0.20.0 in SKILL.md metadata (was 0.19.0)
- No other content or functionality changes
v1.0.2
- Updated metadata structure and moved skill version under metadata.
- Changed version from 1.0.0 to 0.19.0 in metadata.
- Removed redundant version field from the root of SKILL.md.
- No functional or usage changes.
v1.0.1
- Internal formatting in the SKILL.md metadata was adjusted for consistency (list style for "requires.bins").
- No changes to skill features, usage, or user-facing documentation.
v1.0.0
Initial release of gws-gmail-triage.
- Shows a summary of unread Gmail inbox messages including sender, subject, and date.
- Supports flags for max results, custom Gmail queries, and including label names.
- Defaults to showing 20 messages and outputs in table format.
- Read-only; does not modify your mailbox.
- Includes CLI help and usage examples.
Metadata
Frequently Asked Questions
What is Gws Gmail Triage?
Gmail: Show unread inbox summary (sender, subject, date). It is an AI Agent Skill for Claude Code / OpenClaw, with 655 downloads so far.
How do I install Gws Gmail Triage?
Run "/install gws-gmail-triage" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Gws Gmail Triage free?
Yes, Gws Gmail Triage is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Gws Gmail Triage support?
Gws Gmail Triage is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Gws Gmail Triage?
It is built and maintained by googleworkspace-bot (@googleworkspace-bot); the current version is v1.0.12.
More Skills