本文へ移動
cccskills
無料GitHub で公開

gws-shared

gws CLI shared patterns for authentication, global flags, and output formatting. Read this before using any other gws-* skill.

インストール方法を見る

含まれるファイル(1)

  • SKILL.md3.4 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

gws — Shared Reference

gws is a unified CLI for all Google Workspace APIs. It reads Google's Discovery Service at runtime, so every Workspace API endpoint is available without custom integration code.

Installation

npm install -g @googleworkspace/cli
gws --version

Authentication

Interactive (desktop / laptop)

gws auth setup    # One-time: creates Cloud project, enables APIs, logs you in (requires gcloud)
gws auth login    # Subsequent scope selection and login

Log in with specific services to stay within testing-mode scope limits:

gws auth login -s drive,gmail,calendar,sheets

Service Account (server / CI)

export GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE=/path/to/service-account.json
gws drive files list   # Works without interactive login

Pre-obtained access token

export GOOGLE_WORKSPACE_CLI_TOKEN=$(gcloud auth print-access-token)

Headless / CI export flow

# On machine with browser
gws auth export --unmasked > credentials.json

# On headless machine
export GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE=/path/to/credentials.json

CLI Syntax

gws <service> <resource> [sub-resource] <method> [flags]

Global Flags

FlagDescription
--format <FORMAT>Output format: json (default), table, yaml, csv
--dry-runValidate request locally without calling the API
--sanitize <TEMPLATE>Screen responses through Model Armor

Method Flags

FlagDescription
--params '{"key": "val"}'URL / query parameters
--json '{"key": "val"}'Request body
-o, --output <PATH>Save binary responses to file
--upload <PATH>Upload file content (multipart)
--page-allAuto-paginate (NDJSON output)
--page-limit <N>Max pages when using --page-all (default: 10)
--page-delay <MS>Delay between pages in ms (default: 100)

Discovering Commands

# Browse all services
gws --help

# Browse a service's resources
gws drive --help

# Inspect a specific method's schema
gws schema drive.files.list
gws schema gmail.users.messages.send

Shell Tips

zsh ! expansion in ranges

Sheet ranges like Sheet1!A1 contain ! which zsh interprets as history expansion. Use double quotes:

# WRONG (zsh mangles the !)
gws sheets +read --spreadsheet ID --range 'Sheet1!A1:D10'

# CORRECT
gws sheets +read --spreadsheet ID --range "Sheet1!A1:D10"

JSON with inner double quotes

gws drive files list --params '{"pageSize": 5}'

Security Rules

  • Never output secrets, tokens, or API keys in responses
  • Always confirm with the user before executing write or delete commands
  • Prefer --dry-run for any destructive or sending operation
  • Use --sanitize for PII screening when processing user-generated content

MCP Server (for AI agents)

# Start a built-in MCP server exposing selected APIs
gws mcp -s drive,gmail,calendar,sheets

This exposes all methods of the selected services as MCP tools, giving any MCP-compatible AI agent direct Workspace access without additional integration code.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.

日本語の概要は準備中です。原文の説明を表示しています。

nvdigitalsolutions/mcp-ai-wpoos72026年10月13日 更新

Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.

日本語の概要は準備中です。原文の説明を表示しています。

nvdigitalsolutions/mcp-ai-wpoos72026年10月13日 更新

Control a headless browser to navigate URLs, click elements, fill forms, extract content from JavaScript-rendered pages, take screenshots, and automate end-to-end web workflows.

日本語の概要は準備中です。原文の説明を表示しています。

nvdigitalsolutions/mcp-ai-wpoos72026年10月13日 更新

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

日本語の概要は準備中です。原文の説明を表示しています。

nvdigitalsolutions/mcp-ai-wpoos72026年10月13日 更新

Review code for quality, simplicity, and maintainability. Identifies unnecessary abstractions, duplicated logic, oversized functions, missing error handling, and naming issues — then fixes them automatically before presenting the result.

日本語の概要は準備中です。原文の説明を表示しています。

nvdigitalsolutions/mcp-ai-wpoos72026年10月13日 更新

WooCommerce store operations through NV oOS Pro — product research, catalog cross-referencing, inventory lookups, and Shopify or Flowhub comparisons where integrations are configured.

日本語の概要は準備中です。原文の説明を表示しています。

nvdigitalsolutions/mcp-ai-wpoos72026年10月13日 更新

nvdigitalsolutions のスキルをすべて見る

このスキルの問題を報告する