CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

google-drive-sheets

Find, read, export, edit, and manage the user's Google Drive, Docs, Sheets, and Slides through per-user OAuth.

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

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.

The content is a strong, lean API cookbook: fully executable curl recipes for all four Google services with genuinely non-obvious operational gotchas (allDrives params, shared token, per-host variables) and approval gating on every write. Its only weaknesses are minor: repeated approval boilerplate, and no post-write verification or error-recovery feedback loops around the destructive operations.

DimensionReasoningScore

Conciseness

The body is efficient and teaches only non-obvious facts ("The three `allDrives` params matter", the shared-token fallback, "Add `supportsAllDrives=true` to every per-file call"), but the write-approval pattern ("This is a write — summarize the exact change... and get approval first") is repeated across four sections and could be consolidated. Fits anchor 4 (minor instances that could be trimmed) rather than 5, and not 3 since there is no padded or redundant explanation of concepts Claude already knows.

4 / 5

Actionability

Every section provides copy-paste-ready curl commands with concrete headers, query parameters, and JSON bodies (e.g. the files list query with `q=name contains 'deadline'`, the multipart upload with `-F "metadata=..."`, the Docs `batchUpdate` with `insertText` at `index:1`), covering the common cases for all four APIs. Fully executable as required by anchor 5; not 4 because there are no gaps in executable detail.

5 / 5

Workflow Clarity

Sequences are clear with most checkpoints present: fetch metadata first before per-file operations, read the document for `startIndex`/`endIndex` before editing, approval gates before all writes, pagination ("keep fetching with `pageToken=` before concluding anything is missing"), and report-after requirements. Destructive operations exist (delete/trash/move), and while verification is not missing (pre-reads, approval, response reporting), there are no post-write verification or error-recovery feedback loops (e.g. confirming a `batchUpdate` landed or handling a failed write), which keeps this at anchor 4 rather than 5 and above the missing-validation cap of 3.

4 / 5

Progressive Disclosure

No bundle files exist and the body is organized into clean per-operation sections (Find, Read, Read Sheets, Writes, Upload, Rename/Move/Delete, Edit Doc, Edit Slides) with no nested or buried references. The skill is ~215 lines, so the under-50-line simple-skill exception doesn't apply and some per-API detail (e.g. Docs/Slides request catalogs) could be offloaded to reference files — fitting anchor 4 (good structure, minor organization gaps) rather than 5.

4 / 5

Total

17

/

20

Passed

Description

75%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.

The description states a clear, comprehensive "what" with concrete verbs and a highly distinct Google-product niche, but it entirely lacks a "when to use" clause, which caps its completeness despite it being the highest-weighted dimension. Trigger terms cover the product names well but omit common synonyms like "spreadsheet" or "presentation".

Suggestions

Append an explicit trigger clause, e.g. "Use when the user mentions Google Drive, Google Docs, Sheets, Slides, or asks to read, edit, search, share, or upload files/spreadsheets/presentations in their Google account."

Include natural synonyms and variations users actually say — "spreadsheet", "presentation", "deck", "Google Doc" — to broaden trigger-term coverage beyond the bare product names.

Mention sharing/permission troubleshooting explicitly (the body covers it: "sharing/access problems") since "manage" only vaguely hints at it.

DimensionReasoningScore

Specificity

"Find, read, export, edit, and manage" lists five concrete actions across four named services ("Google Drive, Docs, Sheets, and Slides"), matching the anchor for multiple specific concrete actions with comprehensive coverage. Not 4: there are no meaningful gaps in action coverage for the domain.

5 / 5

Completeness

The "what" is clear and concrete ("Find, read, export, edit, and manage... Google Drive, Docs, Sheets, and Slides"), but the description contains no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. Not 4: the "when" is entirely absent, not merely implicit or underspecified.

3 / 5

Trigger Term Quality

"Google Drive, Docs, Sheets, and Slides" are the natural product names users would say, giving good keyword coverage, but common synonyms like "spreadsheet", "presentation", or "deck" are missing. Fits anchor 4 rather than 5 because synonym/extension coverage is absent, and not 3 because the product names are the dominant natural trigger terms.

4 / 5

Distinctiveness Conflict Risk

Naming the specific Google products ("Google Drive, Docs, Sheets, and Slides through per-user OAuth") carves out a clear niche with distinct triggers and minimal conflict risk with other skills. Not 4: the product names are unambiguous and unlikely to trigger the wrong skill.

5 / 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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

yc-software/qm

Path

skills-seed/google-drive-sheets/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.