CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

gws-install

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

Quality

86%

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

82%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 highly actionable, executable install guide with validation checkpoints and a useful troubleshooting section. The main weaknesses are a logically flawed skip instruction in Step 1, some inline content that could be split into a reference file, and minor padding such as the full credential JSON schema.

Suggestions

Fix the Step 1 conditional: "If already authenticated with the right scopes, skip to Step 4" should skip authentication entirely (go to Step 5, Install Agent Skills), since Step 4 is the Authenticate step.

Trim the 12-line expected-format JSON block (or move it to a reference file) — a one-line statement of the required keys would suffice for validation.

Replace or qualify the macOS-only `open` command (e.g. use `xdg-open` on Linux) in the URL-opening step, or state the platform assumption explicitly.

DimensionReasoningScore

Conciseness

The body is command-first and efficient with essentially no explanation of concepts Claude already knows, e.g. "npm install -g @googleworkspace/cli" and "grep -o 'https://accounts.google.com[^ ]*' /tmp/gws-auth-output.txt". Minor over-explanation could be trimmed: the 12-line "Expected format" JSON block for client_secret.json and the explanation of why the OAuth URL wraps in the terminal. This fits anchor 4 ("Efficient; minor instances of over-explanation that could be trimmed"); it is not 5 because those padded spots exist, and not 3 because the excess is minor.

4 / 5

Actionability

Every step is backed by copy-paste-ready commands covering the common cases: pre-flight checks ("which gws && gws --version"), three credential options (paste, file path, env vars), background auth with output capture, URL extraction and programmatic open, and end-to-end verification ("gws calendar +agenda --today"). This matches anchor 5 ("Fully executable; copy-paste ready code or commands; specific examples cover the common cases").

5 / 5

Workflow Clarity

The 6-step sequence is clearly ordered with validation checkpoints at each stage ("gws --version" after install, "gws auth status" after auth, a dedicated Verify step) and a Troubleshooting section for error recovery. However, Step 1's branch "If already authenticated with the right scopes, skip to Step 4" is incoherent — Step 4 is Authenticate, so an already-authenticated machine should skip to Step 5. This fits anchor 4 ("Clear sequence with most checkpoints present; minor validation gaps"); the explicit feedback loops keep it above 3, and the flawed conditional keeps it below 5.

4 / 5

Progressive Disclosure

There are no bundle files (no references/, scripts/, or assets/ directories), and the ~125-line body is organized into clear sections with a See Also list linking sibling skills ("[gws-setup](../gws-setup/SKILL.md)", "[gws-shared](...)"). Structure is good, but all content is inline in a file over 50 lines — the troubleshooting detail and the client_secret.json format spec are candidates for a one-level-deep reference file. This fits anchor 4 ("Good structure; most content is appropriately placed... minor organization gaps") rather than 5, which would require well-signaled external references with appropriately split content.

4 / 5

Total

17

/

20

Passed

Description

86%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 with excellent explicit trigger coverage and a clear what/when structure. The main gaps are modest specificity (only the top-level install action is named) and minor conflict risk with the sibling gws-setup skill on shared trigger phrasing.

Suggestions

Enumerate the concrete sub-actions the skill performs (install the CLI, configure credentials, authenticate, install agent skills, verify) instead of only "Quick install", to raise specificity.

Sharpen the boundary with gws-setup inside the description (e.g. "For first-time setup including GCP project creation, use gws-setup instead") to reduce overlap on triggers like "install gws".

DimensionReasoningScore

Specificity

The description names the domain and one concrete action — "Quick install of the Google Workspace CLI (gws) on an additional machine using existing OAuth credentials" — plus the prerequisite "Requires client_secret.json from a previous gws-setup", but does not enumerate the sub-actions performed (credential setup, authentication, agent-skill installation). This matches anchor 3 ("Names domain and 1-2 concrete actions, but not comprehensive"); it is not 4 because it does not list several specific actions, and not 2 because the language is concrete rather than generic.

3 / 5

Completeness

It explicitly answers both what ("Quick install of the Google Workspace CLI (gws) on an additional machine using existing OAuth credentials") and when ("Use whenever the user wants to install gws on a new computer, reinstall after a fresh OS...") with concrete trigger phrases. This mirrors the anchor-5 good example structure; a 4 would require the 'when' clause to be less explicit, which it is not.

5 / 5

Trigger Term Quality

"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'" provides comprehensive natural-language triggers with synonym and phrasing variations users would actually say. This clearly matches the anchor-5 example pattern (comprehensive natural terms including synonyms); score 4 would require missing common variations, which is not the case.

5 / 5

Distinctiveness Conflict Risk

The niche is clear — reinstall on an additional machine using existing credentials, explicitly gated by "Requires client_secret.json from a previous gws-setup" — but triggers like "install gws" and "set up gws again" overlap with the closely related gws-setup skill for first-time users. This fits anchor 4 ("Mostly distinct; minor overlap risk with closely related skills") better than 5, since a first-time user asking to "install gws" could still land here.

4 / 5

Total

17

/

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-install/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.