gws-admin-reports

Google Workspace Admin SDK: Audit logs and usage reports.

Install with Tessl CLI

npx tessl i github:googleworkspace/cli --skill gws-admin-reports

What are skills?

4.38x

Quality

45%

Does it follow best practices?

Impact

92%

4.38x

Average score across 3 eval scenarios

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/gws-admin-reports/SKILL.md

SKILL.md

Review

Evals

Discovery

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.

This description identifies the domain and two high-level capabilities but is too terse to be effective for skill selection. It lacks concrete action verbs, explicit trigger guidance, and sufficient keyword coverage for users who might phrase requests differently.

Suggestions

Add a 'Use when...' clause with explicit triggers like 'Use when the user asks about Google Workspace admin tasks, user activity logs, login reports, or G Suite usage analytics'

Expand with concrete actions such as 'Query audit logs, generate usage reports, track user activity, monitor login events, export admin data'

Include common keyword variations users might say: 'G Suite', 'admin console', 'user activity', 'login history', 'security events', 'workspace reports'

Dimension	Reasoning	Score
Specificity	Names the domain (Google Workspace Admin SDK) and mentions two capabilities (audit logs and usage reports), but lacks concrete actions like 'retrieve', 'analyze', 'export', or 'generate'.	2 / 3
Completeness	Describes what (audit logs and usage reports) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill.	1 / 3
Trigger Term Quality	Includes relevant terms like 'Google Workspace', 'Admin SDK', 'audit logs', and 'usage reports', but misses common variations users might say like 'G Suite', 'admin console', 'user activity', 'login history', or 'security logs'.	2 / 3
Distinctiveness Conflict Risk	The 'Google Workspace Admin SDK' qualifier provides some distinctiveness, but 'audit logs' and 'usage reports' are generic terms that could overlap with other logging or analytics skills.	2 / 3
	Total	7 / 12 Passed

Implementation

57%

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

This skill provides a reasonable reference structure for the Admin Reports API with clear organization and appropriate delegation to shared documentation. However, it lacks concrete executable examples showing real-world usage patterns, and the method descriptions are somewhat verbose with repeated boilerplate phrases about documentation links.

Suggestions

Add 1-2 concrete executable examples showing common operations like listing admin activities or getting user usage reports with actual --params values

Trim the method descriptions to remove repeated 'For more information' phrases - Claude can find documentation if needed

Include a brief workflow example showing how to set up and use the watch/push notification feature with validation steps

Dimension	Reasoning	Score
Conciseness	The content is reasonably efficient but includes some redundant phrasing in the method descriptions (e.g., 'For more information, see the guides' repeated multiple times). The descriptions could be tightened.	2 / 3
Actionability	Provides CLI command structure and discovery commands, but lacks concrete executable examples showing actual usage with real parameters. No example of a complete command with --params or --json flags.	2 / 3
Workflow Clarity	Shows a two-step discovery workflow (browse resources, then inspect method), but lacks validation steps or examples of complete workflows for common tasks like retrieving audit logs or setting up push notifications.	2 / 3
Progressive Disclosure	Appropriately structured with clear reference to prerequisite shared skill, organized sections for resources and discovery, and keeps content focused without unnecessary nesting.	3 / 3
	Total	9 / 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

Reviewed: about 23 hours 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.