CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

gws-setup

Set up the Google Workspace CLI (gws) from scratch. Guides through GCP project creation, OAuth credentials, authentication, and installing 90+ agent skills for Claude Code. Use whenever the user wants to set up gws for the first time, configure Google Workspace API access, install the Google Workspace CLI, or troubleshoot gws auth issues.

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, highly actionable setup guide with strong sequencing, validation checkpoints, and valuable non-obvious GCP/gws domain knowledge. The main improvements are making the OAuth-URL-open command platform-portable, trimming the redundant intro, and splitting the reference tables out of the main file.

Suggestions

Make the Step 5 URL-opening command platform-portable (e.g., detect `xdg-open` on Linux vs `open` on macOS) so it is copy-paste ready everywhere instead of relying on a manual fallback (actionability).

Trim the opening paragraph, which repeats the frontmatter description, and tighten incidental asides to reduce token load (conciseness).

Move the Scope Reference table and Config Directory table into a references/ file (e.g., references/scopes.md) linked from Step 4, keeping SKILL.md as a lean workflow overview (conciseness / progressive disclosure).

DimensionReasoningScore

Conciseness

The body is efficient and focuses on non-obvious domain knowledge (Chat App config requirement, Testing-vs-Production token expiry, ~25 scope limit, the too-long-to-copy OAuth URL workaround) rather than concepts Claude already knows. Minor trimmable material keeps it at 4: the intro paragraph restates the frontmatter description, and the Scope Reference and Config Directory tables are reference material inlined in a ~270-line file. Not 5 because not every token earns its place; clearly above 3 since there is no padded or redundant explanation of known concepts.

4 / 5

Actionability

Guidance is almost fully executable: exact npm/npx/gws commands, console URLs with PROJECT_ID placeholders, numbered UI steps for OAuth client creation, the expected client_secret.json format, and verification commands. The gap that keeps it from 5: `cat /tmp/gws-auth-url.txt | xargs open` is macOS-only (no xdg-open alternative for Linux) with only a manual copy fallback, so that step is not copy-paste ready on all platforms. Well above 3 — nothing is pseudocode.

4 / 5

Workflow Clarity

Eight clearly sequenced steps with pre-flight skip logic ("If `gws auth status` shows `\"status\": \"success\"` with scopes, skip to Step 6"), explicit validation checkpoints after each phase (`gws --version`, `gws auth status`, `ls ~/.claude/skills/gws-* | wc -l`, final Step 8 verification commands), and an error-recovery feedback loop ("If any command fails with auth errors, re-run `gws auth login` with the needed scopes"). The skipped 3d sub-step numbering is a typo-level flaw that does not break the sequence, so this matches the 5 anchor rather than 4.

5 / 5

Progressive Disclosure

No bundle files exist, and the single SKILL.md is well-sectioned with clearly signaled one-level "See Also" links to sibling skills (gws-install, gws-shared). It sits at 4 rather than 5 because the Critical Patterns section (Scope Reference and Config Directory tables) is inline reference material that a ~270-line skill would ideally split into a references file; not 3, because the structure is good, nothing is buried, and there is no nested-reference chain.

4 / 5

Total

17

/

20

Passed

Description

96%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that clearly states what the skill does and when to use it, with concrete actions and natural trigger phrases in proper third-person voice. The only weakness is mild overlap risk with closely related gws skills on the install/troubleshoot triggers.

DimensionReasoningScore

Specificity

"Guides through GCP project creation, OAuth credentials, authentication, and installing 90+ agent skills for Claude Code" lists multiple concrete actions covering the full setup pipeline in third-person voice. This matches the comprehensive-coverage anchor rather than 4, since no meaningful setup action is missing.

5 / 5

Completeness

It explicitly answers both questions: the "what" is enumerated (GCP project creation, OAuth credentials, authentication, skill installation) and the "when" is a concrete "Use whenever..." clause with four distinct trigger phrases. Matches the 5 anchor exactly; clearly not 4 since the when-clause is explicit and specific.

5 / 5

Trigger Term Quality

"set up gws for the first time", "configure Google Workspace API access", "install the Google Workspace CLI", and "troubleshoot gws auth issues" are natural user phrasings with product-name synonyms (Google Workspace CLI / gws) covering setup, configuration, installation, and troubleshooting intents. Not 4, because no common variation of how a user would request this is absent.

5 / 5

Distinctiveness Conflict Risk

The niche (first-time gws CLI setup) is mostly distinct, but "install the Google Workspace CLI" and "troubleshoot gws auth issues" overlap with the sibling gws-install and gws-shared skills referenced in the body. Matches 4 (minor overlap risk with closely related skills); "for the first time" only partially disambiguates, so not 5.

4 / 5

Total

19

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 missing, 1 deeper-than-1-level, 1 suspicious

Warning

Total

15

/

16

Passed

Repository

jezweb/claude-skills

Path

plugins/integrations/skills/gws-setup/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.