odyssey4me/google-sheets
Read, write, and format Google Sheets spreadsheets. Manage cell values, ranges, formulas, pivot tables, and charts. Use when asked to update a gsheet, edit a Google spreadsheet, add formulas, or work with spreadsheet data.
71
89%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Risky
Do not use without reviewing
Quality
Discovery
100%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 is a strong skill description that clearly communicates specific capabilities, includes natural trigger terms with common variations (including the colloquial 'gsheet'), and explicitly states both what the skill does and when to use it. It is well-scoped to Google Sheets, minimizing conflict risk with other spreadsheet-related skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Read, write, and format', 'Manage cell values, ranges, formulas, pivot tables, and charts'. These are concrete, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both what ('Read, write, and format Google Sheets spreadsheets. Manage cell values, ranges, formulas, pivot tables, and charts.') and when ('Use when asked to update a gsheet, edit a Google spreadsheet, add formulas, or work with spreadsheet data.'). | 3 / 3 |
Trigger Term Quality | Includes excellent natural trigger terms users would say: 'gsheet', 'Google spreadsheet', 'formulas', 'spreadsheet data', 'Google Sheets'. Covers common variations including the informal 'gsheet'. | 3 / 3 |
Distinctiveness Conflict Risk | Clearly scoped to Google Sheets specifically, distinguishing it from generic spreadsheet or Excel skills. The 'gsheet' and 'Google spreadsheet' terms create a distinct niche unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 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 solid, comprehensive skill with excellent actionability — every command has executable examples with expected output. The main weaknesses are moderate verbosity from repeated information (the check command appears three times, argument descriptions are formulaic) and missing validation checkpoints for destructive operations like clearing ranges or deleting sheets. Progressive disclosure is well-handled with clear references to supporting documents.
Suggestions
Consolidate the 'Setup Verification' section into the 'check' command description to eliminate redundancy — the check command is described in three separate places.
Add explicit validation steps after destructive operations (values clear, sheets delete) — e.g., 'Read the range after clearing to confirm it's empty' or 'Run spreadsheets get to verify the sheet was deleted'.
Trim repetitive 'Arguments: spreadsheet_id - The Google Sheets spreadsheet ID' blocks by stating once at the top that all commands take a spreadsheet ID as the first positional argument.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is fairly well-structured but includes redundant information — the 'check' command is described three times (setup verification, quick start, and commands section), and many command descriptions repeat the same argument/option patterns verbosely. Some sections like 'Setup Verification' explaining what the check command checks are unnecessary given the command section covers it. | 2 / 3 |
Actionability | Every command includes fully executable bash examples with concrete arguments, expected output, and clear option descriptions. The examples section provides realistic multi-step workflows with copy-paste ready commands including formula usage and batch operations. | 3 / 3 |
Workflow Clarity | The 'Create and populate a spreadsheet' example shows a clear multi-step sequence, and error handling distinguishes retryable vs non-retryable errors. However, the batch operations example clears data without any validation checkpoint, and there's no explicit verify-after-write pattern for destructive operations like 'values clear' or 'sheets delete'. | 2 / 3 |
Progressive Disclosure | The skill provides a clear overview with well-signaled references to external docs (permissions.md, range-notation.md, formulas-guide.md, OAuth setup guides). Content is appropriately split between the main file (commands and examples) and referenced materials (detailed notation, permissions, troubleshooting). | 3 / 3 |
Total | 10 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
Reviewed
Table of Contents