gws-sheets

Google Sheets: Read and write spreadsheets.

Quality

45%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Advisory

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./skills/gws-sheets/SKILL.md

Quality

Content

57%

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

This skill serves as a reasonable hub/overview for Google Sheets operations, with good progressive disclosure through linked helper commands and a prerequisite reference. However, it lacks concrete executable examples of actual API calls and includes verbose API method descriptions that add little value. The workflow for common operations could be more explicit.

Suggestions

Add 1-2 concrete, copy-paste-ready examples showing common operations (e.g., reading a range, updating cells) with actual `gws sheets` commands including `--params` flags.

Trim API resource descriptions to just method names and brief labels (e.g., `batchUpdate — Apply multiple updates`, `get — Get spreadsheet by ID`) since Claude can discover details via `gws schema`.

Add an explicit workflow for write operations that includes a validation/verification step (e.g., read back after write to confirm changes).

Dimension	Reasoning	Score
Conciseness	Mostly efficient, but the long descriptions of API methods (e.g., batchUpdate, get, getByDataFilter) include verbose explanations that Claude already knows or could discover via `gws schema`. These could be trimmed to just method names and one-line summaries.	2 / 3
Actionability	Provides concrete CLI commands for discovery (`gws sheets --help`, `gws schema`) and references helper commands, but lacks executable examples of actual read/write operations. There are no copy-paste-ready examples showing how to actually use `gws sheets spreadsheets.values.get --params ...` or similar.	2 / 3
Workflow Clarity	The discovery workflow (browse → inspect → build flags) is present but implicit. There's no explicit sequenced workflow for common tasks like reading or writing data, and no validation/verification steps for operations that modify spreadsheets.	2 / 3
Progressive Disclosure	Well-structured with clear one-level-deep references to helper commands (+append, +read) and the shared prerequisite skill. The content is appropriately split between this overview and linked sub-skills, with clear navigation via the helper commands table.	3 / 3
	Total	9 / 12 Passed

Description

32%

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

The description is too terse—it identifies the platform and two basic operations but lacks specific capabilities, trigger guidance, and natural keyword variations. It would benefit significantly from listing concrete actions and adding an explicit 'Use when...' clause to help Claude select it appropriately among competing skills.

Suggestions

Add a 'Use when...' clause with trigger terms like 'Google Sheets', 'gsheets', 'spreadsheet data', 'sheet formulas', 'Google Spreadsheet'.

List more specific concrete actions such as 'create and edit cells, apply formulas, format ranges, manage tabs, and import/export data'.

Include file-type or platform-specific keywords to distinguish from Excel or generic spreadsheet skills, e.g., 'Google Workspace', 'Sheets API', '.gsheet'.

Dimension	Reasoning	Score
Specificity	Names the domain (Google Sheets) and two actions (read and write), but does not list more specific concrete actions like creating formulas, formatting cells, creating charts, or managing multiple sheets.	2 / 3
Completeness	Describes what it does (read and write spreadsheets) but has no 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill, which per the rubric caps completeness at 2, and the 'what' is also quite thin, warranting a 1.	1 / 3
Trigger Term Quality	Includes 'Google Sheets' and 'spreadsheets' which are relevant keywords, but misses common variations like 'gsheets', '.gsheet', 'Google Spreadsheet', 'cells', 'rows', 'columns', or 'tabular data'.	2 / 3
Distinctiveness Conflict Risk	'Google Sheets' is fairly specific and distinguishes it from generic spreadsheet or Excel skills, but 'spreadsheets' is broad enough to potentially overlap with Excel or other spreadsheet-related skills.	2 / 3
	Total	7 / 12 Passed

Validation

90%

Warnings & errors only

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

Validation — 10 / 11 Passed

Validation for skill structure

Criteria	Description	Result
metadata_field	'metadata' should map string keys to string values	Warning

	Total	10 / 11 Passed

Repository: googleworkspace/cli
Commit: a3768d0

Reviewed: 3 months ago

Table of Contents

Discovery Implementation Validation

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.