New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Gws Install

by jezweb in jezweb/claude-skills

Quick install of the Google Workspace CLI (gws) on an additional machine using existing OAuth credentials.

MITAuto-check passedDocuments & Office

Install Gws Install

skills CLI
$ npx skills add jezweb/claude-skills --skill gws-install -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jezweb/claude-skills gws-install --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jezweb/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/integrations/skills/gws-install .claude/skills/gws-install && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
gws-install
GitHub stars
1.1k
Token cost
~1.1k tokens
SKILL.md length
392 words
Files
1
Skills in repo
52
Repo updated
First seen
Licence
MIT

At a glance

Quick install of the Google Workspace CLI (gws) on an additional machine using existing OAuth credentials.

  • Works in 6 steps: Pre-flight Checks → Install the CLI → Set Up Credentials → …
  • The user wants to install gws on a new computer
  • SKILL.md covers Workflow, Troubleshooting and See Also
  • Calls npm and npx; reaches accounts.google.com and oauth2.googleapis.com; needs GOOGLE_WORKSPACE_CLI_CLIENT_SECRET

What it does

Gws Install is an agent skill from jezweb/claude-skills. Quick install of the Google Workspace CLI (gws) on an additional machine using existing OAuth credentials. Requires clientsecret.json from a previous gws-setup. Use whenever the user wants to install gws on a new computer, reinstall after a fresh OS, configure a second workstation, or says 'install gws', 'gws on new machine', 'set up gws again'.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: claude-code-only

It sits in Documents & Office, covering Cloud office suites and OAuth and OpenID Connect. It works with Google Workspace and Google Cloud. The repository describes itself as: Skills for Claude Code CLI such as full stack dev Cloudflare, React, Tailwind v4, and AI integrations. The licence is MIT.

When your agent uses it

  • The user wants to install gws on a new computer
  • Reinstall after a fresh OS
  • Configure a second workstation
  • Says install gws

Example prompts

  • “install gws”
  • “gws on new machine”
  • “set up gws again”
  • “/gws-install”

Requirements

  • Node.js
  • A credential in GOOGLE_WORKSPACE_CLI_CLIENT_SECRET
  • Compatibility (from SKILL.md): claude-code-only

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Pre-flight Checks
  2. Install the CLI
  3. Set Up Credentials
  4. Authenticate
  5. Install Agent Skills
  6. Verify

What it can do on your machine

Read from SKILL.md and the folder at commit 64965d9. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm
    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • accounts.google.com
    • oauth2.googleapis.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • GOOGLE_WORKSPACE_CLI_CLIENT_SECRET

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    claude-code-only

    From compatibility in the SKILL.md frontmatter.

Context cost

Gws Install loads about 1.1k tokens when it runs. Until then it costs about 90 tokens; SKILL.md has 392 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~90
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jezweb/claude-skills at commit 64965d9, republished under its MIT licence (© jezweb). 392 words, ~1,068 tokens.

Download SKILL.mdSave it as .claude/skills/gws-install/SKILL.md (or your agent's skills folder).
name
gws-install
description
Quick install of the Google Workspace CLI (gws) on an additional machine using existing OAuth credentials. Requires client_secret.json from a previous gws-setup. Use whenever the user wants to install gws on a new computer, reinstall after a fresh OS, configure a second workstation, or says 'install gws', 'gws on new machine', 'set up gws again'.
compatibility
claude-code-only

Google Workspace CLI — Quick Install

Install gws on an additional machine using OAuth credentials from a previous setup. Produces an authenticated CLI with all agent skills ready to use.

Prerequisite: The user must have client_secret.json from a previous gws-setup (or from Google Cloud Console). If they don't have it, use the gws-setup skill instead.

Workflow

Step 1: Pre-flight Checks
bash
which gws && gws --version
ls ~/.config/gws/client_secret.json
gws auth status

If already authenticated with the right scopes, skip to Step 4.

Step 2: Install the CLI
bash
npm install -g @googleworkspace/cli
gws --version
Step 3: Set Up Credentials

Ask the user to provide their client_secret.json. Three options:

Option A — Paste the JSON content:

Ask the user to paste the JSON. Write it to ~/.config/gws/client_secret.json:

bash
mkdir -p ~/.config/gws

Expected format:

json
{
  "installed": {
    "client_id": "...",
    "project_id": "...",
    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
    "token_uri": "https://oauth2.googleapis.com/token",
    "client_secret": "...",
    "redirect_uris": ["http://localhost"]
  }
}

Option B — File path:

If the user has the file locally (e.g. in Downloads):

bash
mkdir -p ~/.config/gws
cp /path/to/client_secret.json ~/.config/gws/client_secret.json

Option C — Environment variables:

bash
export GOOGLE_WORKSPACE_CLI_CLIENT_ID="your-client-id"
export GOOGLE_WORKSPACE_CLI_CLIENT_SECRET="your-client-secret"
Step 4: Authenticate

IMPORTANT: This step prints a very long OAuth URL (30+ scopes) that the user must open in their browser. The URL is too long to copy from terminal output — it wraps across lines and breaks. Always extract it to a file and open it programmatically.

Ask which Google account to use, then:

  1. Run auth in the background and capture output:
bash
gws auth login -s gmail,drive,calendar,sheets,docs,chat,tasks 2>&1 | tee /tmp/gws-auth-output.txt

Running as a background task is fine — it will complete once the user approves in browser.

  1. Extract and open the URL (run separately after output appears):
bash
grep -o 'https://accounts.google.com[^ ]*' /tmp/gws-auth-output.txt > /tmp/gws-auth-url.txt
cat /tmp/gws-auth-url.txt | xargs open

If open doesn't work, tell the user: "The auth URL is saved at /tmp/gws-auth-url.txt — open that file and copy the URL from there."

  1. Wait for the user to approve in their browser, then verify:
bash
gws auth status

Alternative — --full for all scopes:

bash
gws auth login --full

The user can check their original machine's scopes with gws auth status to see what was granted.

Show full SKILL.md (118 more words)Show less
Step 5: Install Agent Skills
bash
npx skills add googleworkspace/cli -g --agent claude-code --all

This installs 90+ skills into ~/.claude/skills/. Safe to re-run if skills are already installed.

Step 6: Verify
bash
gws auth status
gws calendar +agenda --today
gws gmail +triage

Troubleshooting

"Auth error — credentials missing or invalid" (exit code 2)
  • Check ~/.config/gws/client_secret.json exists and has valid JSON
  • Re-run gws auth login
Token expired
  • If the GCP app is in "Testing" status, tokens expire after 7 days
  • Re-run gws auth login to refresh
  • For permanent tokens, push the app to Production in GCP Console OAuth consent screen
Skills not appearing in Claude Code
  • Skills load at session start — restart Claude Code after installing
  • Verify: ls ~/.claude/skills/gws-* | wc -l should show 30+ directories

See Also

  • gws-setup — First-time setup including GCP project creation
  • gws-shared — Auth patterns and global flags

© jezweb, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/integrations/skills/gws-install of jezweb/claude-skills.

Open the folder on GitHubat commit 64965d9

Compare with similar skills

Gws Install next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Gws Install compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gws Install this skilljezweb/claude-skills1.1k—~1.1kAutomated safety check: PassMIT
Google Workspacetaracodlabs/aiden851—~1.1kAutomated safety check: PassApache-2.0
GCP Workspace Pivotwgpsec/AboutSecurity1.8k—~2.9kAutomated safety check: PassNone
Community Google WorkspaceArgentAIOS/argentos-core126—~2.8kAutomated safety check: PassMIT
Google WorkspaceTommy-yw/RunbookHermes5461 repos~2.7kAutomated safety check: PassMIT
Google Workspaceericrisco/rsc-harness174—~3.2kAutomated safety check: PassMIT

Similar skills

  • Google Workspace

    taracodlabs/aiden

    Gmail, Calendar, Drive, Sheets, Docs via Google API (SA / OAuth)

    851 GitHub stars~1.1k tokensUpdated 25 days ago
    Documents & OfficeAuto-check passed

  • GCP Workspace Pivot

    wgpsec/AboutSecurity

    GCP 到 Google Workspace 的穿越攻击方法论。当已获取 GCP Service Account 或 Project 权限并发现目标组织使用 Google Workspace、需要从云平台穿越到企业邮件/文档/管理控制台、或发现 Domain-Wide Delegation 配置时使用。覆盖 Domain-Wide Delegation 滥用、OAuth…

    1.8k GitHub stars~2.9k tokensUpdated today
    Backend & APIsAuto-check passed

  • Community Google Workspace

    ArgentAIOS/argentos-core

    Gmail, Calendar, Drive, Contacts, Sheets, and Docs integration for community skills.

    126 GitHub stars~2.8k tokensUpdated 3 mo ago
    Documents & OfficeAuto-check passed

  • Google Workspace

    Tommy-yw/RunbookHermes

    Gmail, Calendar, Drive, Contacts, Sheets, and Docs integration for Hermes.

    546 GitHub starsUsed in 1 repo~2.7k tokens
    Documents & OfficeAuto-check passed

  • Google Workspace

    ericrisco/rsc-harness

    A skill your agent uses when server-side code reads or writes Gmail, Drive, Calendar, or Sheets with a GCP service account and no human in the OAuth loop: picking the auth mode (app-owned vs…

    174 GitHub stars~3.2k tokensUpdated yesterday
    Backend & APIsAuto-check passed

  • Google Workspace

    google/adk-recipes

    Official

    Read/write Google Drive, Docs, Sheets, Gmail, Calendar, Chat, Tasks, Slides via the gws CLI.

    10k GitHub stars~4.6k tokensUpdated today
    Documents & OfficeAuto-check passed

More from jezweb/claude-skills

All 52 skills in this repo

  • Favicon Gen

    jezweb/claude-skills

    Generate custom favicons from logos, text, or brand colours.

    1.1k GitHub starsUsed in 1 repo~1k tokens
    Auto-check passed

  • Tailwind Theme Builder

    jezweb/claude-skills

    Set up Tailwind v4 + shadcn/ui themed UI with dark mode. An agent skill from jezweb/claude-skills.

    1.1k GitHub starsUsed in 1 repo~3.2k tokens
    Auto-check passed

  • Elevenlabs Agents

    jezweb/claude-skills

    Build conversational AI voice agents on the ElevenLabs platform.

    1.1k GitHub stars~3.3k tokensUpdated 3 days ago
    Auto-check passed

  • Responsiveness Check

    jezweb/claude-skills

    Test website responsiveness across viewport widths using browser automation.

    1.1k GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed

  • MCP Builder

    jezweb/claude-skills

    Build MCP servers in Python with FastMCP. An agent skill from jezweb/claude-skills.

    1.1k GitHub stars~3.1k tokensUpdated 3 days ago
    Auto-check: notes

  • GitHub Release

    jezweb/claude-skills

    Prepare and publish GitHub releases. An agent skill from jezweb/claude-skills.

    1.1k GitHub stars~944 tokensUpdated 3 days ago
    Auto-check: notes

Works with

Categories

Questions about Gws Install

What does Gws Install do?

Quick install of the Google Workspace CLI (gws) on an additional machine using existing OAuth credentials. Gws Install is an agent skill from jezweb/claude-skills. Quick install of the Google Workspace CLI (gws) on an additional machine using existing OAuth credentials.

When should I use Gws Install?

Gws Install fits situations like: the user wants to install gws on a new computer; reinstall after a fresh OS; configure a second workstation; says install gws.

How do I install Gws Install in Claude Code?

Run `npx skills add jezweb/claude-skills --skill gws-install -a claude-code`. Or copy the skill folder (plugins/integrations/skills/gws-install in jezweb/claude-skills) into .claude/skills/gws-install in your project. Claude Code loads it when a task matches its description.

How do I install Gws Install in Codex?

Run `npx skills add jezweb/claude-skills --skill gws-install -a codex`. Or copy the skill folder (plugins/integrations/skills/gws-install in jezweb/claude-skills) into .agents/skills/gws-install in your project. Codex loads it when a task matches its description.

Can I use Gws Install in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jezweb/claude-skills --skill gws-install -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gws-install, .gemini/skills/gws-install, .github/skills/gws-install and .opencode/skills/gws-install in your project.

What does Gws Install need to run?

Going by SKILL.md and its folder, Gws Install needs the command-line tools its instructions call (npm and npx) and credentials named GOOGLE_WORKSPACE_CLI_CLIENT_SECRET. Our summary lists: Node.js; A credential in GOOGLE_WORKSPACE_CLI_CLIENT_SECRET. Compatibility (from SKILL.md): claude-code-only.

Does Gws Install access the network?

SKILL.md names 2 domains. In commands or code: accounts.google.com and oauth2.googleapis.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Gws Install safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Gws Install use?

Gws Install is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Gws Install use?

About 1.1k tokens (SKILL.md is roughly 4.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Gws Install?

Skills that share tags, products or a category with Gws Install: Google Workspace (taracodlabs/aiden, 851 stars), GCP Workspace Pivot (wgpsec/AboutSecurity, 1.8k stars), Community Google Workspace (ArgentAIOS/argentos-core, 126 stars) and Google Workspace (Tommy-yw/RunbookHermes, 546 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gws Install?

jezweb (a GitHub user) maintains it in jezweb/claude-skills, which has 1,052 GitHub stars. The repository holds 52 skills in this directory. The repository was last updated on October 5, 2026.

Source: jezweb/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.