Skills gws-shared

📦

gws-shared

Name: gws-shared
Author: googleworkspace

v0.23.0 Content revision r2 Safe ⚙️ External commands🌐 Network access🔑 Env variables

Use 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.

Supports: Claude Codex Code(CC)

🥈 81 Silver

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-shared" from https://skillstore.io/skills/googleworkspace-gws-shared.md and its manifest at https://skillstore.io/api/skills/googleworkspace-gws-shared/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.

Markdown detail GET /skills/googleworkspace-gws-shared.md Signed manifest GET /api/skills/googleworkspace-gws-shared/manifest Signed lockfile GET /api/skills/googleworkspace-gws-shared/lockfile

Test it

Using "gws-shared". How should I authenticate for an interactive personal account task?

Expected outcome:

Use browser-based OAuth with gws auth login. Complete the browser consent flow before running the requested read command.

Using "gws-shared". I need five Drive files in a readable terminal view.

Expected outcome:

Use the Drive files list method with a page size of five and table output. Keep the request read-only.

Using "gws-shared". My zsh command fails on a sheet range containing an exclamation mark.

Expected outcome:

Place the full sheet range inside double quotes. This prevents zsh history expansion from changing the range.

Security Audit

Safe

v5 • 8/5/2026 Open versioned report

All 27 static findings are false positives caused by Markdown backticks, documented shell examples, standard credential setup, or official GitHub links. The file contains no executable implementation, prompt injection, credential exfiltration, or suspicious network destination.

Files scanned

Lines analyzed

Review items

False positives ignored

Risk Factors

⚙️ External commands (24)

🌐 Network access (2)

SKILL.md:79 SKILL.md:80

🔑 Env variables (1)

SKILL.md:26

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.

Open versioned report

Copy report link

https://skillstore.io/skills/googleworkspace-gws-shared/audits/5?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown badge

[![Skillstore security assessment](https://skillstore.io/badges/skills/googleworkspace-gws-shared/security.svg)](https://skillstore.io/skills/googleworkspace-gws-shared?utm_source=security_passport_badge)

HTML badge

<a href="https://skillstore.io/skills/googleworkspace-gws-shared?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/googleworkspace-gws-shared/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Embed card

<iframe src="https://skillstore.io/embed/skills/googleworkspace-gws-shared.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-shared security audit report (audit version 5) [Author version 0.23.0]. Skillstore. https://skillstore.io/skills/googleworkspace-gws-shared/audits/5

BibTeX citation

@techreport{googleworkspace-googleworkspace-gws-shared-2026,
  author = {googleworkspace},
  title = {gws-shared security audit report (audit version 5)},
  institution = {Skillstore},
  year = {2026},
  number = {5},
  url = {https://skillstore.io/skills/googleworkspace-gws-shared/audits/5},
  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-shared security audit report (audit version 5)"
version: "0.23.0"
type: report
authors:
  - name: "googleworkspace"
date-released: "2026-08-05"
url: "https://skillstore.io/skills/googleworkspace-gws-shared/audits/5"
identifiers:
  - type: other
    value: "skillstore:googleworkspace-gws-shared:audit:5"
    description: "Skillstore immutable audit report identifier"

Skillstore Score

Why this score Evidence Confidence: High

Architecture

100

Maintainability

Content

Community

Spec Compliance

What You Can Build

Prepare a first gws session

Set up authentication and choose readable output before running a Google Workspace query.

Build reliable CLI automation

Apply consistent request, pagination, upload, and output flags in scripted workflows.

Generate correctly quoted commands

Avoid shell expansion errors when using sheet ranges and structured command arguments.

Try These Prompts

Choose an authentication method

Explain whether I should use browser OAuth or a service account for this gws task: [task].

Create a read command

Draft a gws command to read [resource] from [service]. Use [format] output and explain each flag.

Add pagination and safety controls

Prepare a gws command for [method] with pagination. Limit it to [pages] pages and include appropriate safety flags.

Design an advanced file workflow

Plan a gws workflow for [goal] using [upload or output path]. Validate destructive steps and handle shell quoting safely.

Best Practices

Confirm with the user before running any write or delete operation.
Use dry-run validation before destructive operations whenever the method supports it.
Sanitize responses when they may contain personal or sensitive content.

Avoid

Do not print API keys, access tokens, or credential file contents.
Do not run write operations without explicit user confirmation.
Do not pass structured request values without protective shell quoting.

Frequently Asked Questions

Does this skill install the gws CLI?

No. Install the gws binary separately and ensure it is available on PATH.

Which authentication methods are covered?

The skill covers interactive browser OAuth and service account configuration.

Which output formats are available?

The documented formats are JSON, table, YAML, and CSV.

Can it validate a destructive request?

The dry-run flag validates locally without calling the API. User confirmation is still required before execution.

How does it handle large result sets?

It documents automatic pagination, page limits, and delays between pages.

Why do sheet ranges need careful quoting?

zsh treats exclamation marks as history expansion. Double-quote sheet ranges to preserve the intended value.

Developer Details

Author

googleworkspace

License

MIT

Author version

v0.23.0

Skillstore revision

Repository

https://github.com/googleworkspace/cli/tree/main/skills/gws-shared/

Ref

286d37c9c189ddd1aafd3548415fb031d1df79d5

Maintenance freshness

8/6/2026

Usage

7 downloads · 76 views

File structure

📄 SKILL.md