gws-apps-script

Google Apps Script: Manage and execute Apps Script projects.

1.72x

Quality

47%

Does it follow best practices?

Impact

81%

1.72x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/gws-apps-script/SKILL.md

Quality

Discovery

22%

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

This description is too brief and vague to effectively guide skill selection. While it identifies the technology domain (Google Apps Script), it fails to specify concrete capabilities and completely lacks trigger guidance. The description would benefit significantly from listing specific actions and adding explicit 'Use when...' conditions.

Suggestions

Add a 'Use when...' clause with trigger terms like 'Google Apps Script', 'GAS', 'automate Google Sheets', 'Google Workspace automation', 'clasp', or '.gs files'

Replace vague 'Manage and execute' with specific actions like 'Create and deploy Apps Script projects, automate Google Sheets/Docs/Forms, set up time-based triggers, build custom functions'

Include common user scenarios such as 'spreadsheet automation', 'Google Workspace integrations', or 'custom menu creation'

Dimension	Reasoning	Score
Specificity	The description uses vague language with 'Manage and execute' being abstract actions. It doesn't list concrete capabilities like 'create scripts', 'deploy web apps', 'automate Google Sheets', or 'set up triggers'.	1 / 3
Completeness	The description only weakly addresses 'what' with vague terms and completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill.	1 / 3
Trigger Term Quality	Includes 'Google Apps Script' and 'Apps Script projects' which are relevant keywords, but misses common variations users might say like 'GAS', 'Google script', 'Sheets automation', 'Google Workspace automation', or '.gs files'.	2 / 3
Distinctiveness Conflict Risk	'Google Apps Script' is a specific technology which provides some distinctiveness, but 'Manage and execute projects' is generic enough to potentially overlap with other scripting or project management skills.	2 / 3
	Total	6 / 12 Passed

Implementation

72%

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

This is a well-structured reference skill that efficiently documents the Apps Script CLI interface. Its main strengths are excellent organization and token efficiency. However, it lacks concrete usage examples and validation guidance for destructive operations like updateContent.

Suggestions

Add at least one complete executable example showing a common workflow (e.g., getting project content, modifying it, and updating)

Add a warning or validation step for updateContent since it 'clears all existing files in the project' - this destructive operation needs explicit guidance

Dimension	Reasoning	Score
Conciseness	The content is lean and efficient, providing only essential information without explaining concepts Claude already knows. Every section serves a clear purpose with no padding or unnecessary context.	3 / 3
Actionability	Provides concrete command patterns and references to helper commands, but lacks executable examples showing actual usage with real parameters. The API resource descriptions are brief but don't show how to actually use them.	2 / 3
Workflow Clarity	The 'Discovering Commands' section provides a clear two-step pattern for exploring and using the API, but there's no validation or error handling guidance for operations like updateContent which clears existing files (a destructive operation).	2 / 3
Progressive Disclosure	Excellent structure with clear prerequisite reference, well-organized tables, and appropriate linking to helper commands and shared skills. Content is appropriately split with one-level-deep references.	3 / 3
	Total	10 / 12 Passed

Validation

72%

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 — 8 / 11 Passed

Validation for skill structure

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning
metadata_field	'metadata' should map string keys to string values	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	8 / 11 Passed

Repository: googleworkspace/cli
Commit: 6ed836c

Reviewed: 26 days 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.