Content
63%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, highly actionable reference for Google Drive automation via Rube MCP, with concrete tool sequences, parameters, and pitfalls. The main weaknesses are duplicated pitfall content between workflow sections and the Known Pitfalls summary, and a monolithic single-file layout where reference material (query syntax, export formats, quick reference table) could be split into bundle files.
Suggestions
De-duplicate the pitfall content: keep the per-workflow Pitfalls subsections and reduce the trailing "Known Pitfalls" section to non-overlapping entries (or vice versa) to cut token cost.
Move the Query Syntax reference, Export Formats list, and Quick Reference table into a references/ file (e.g., references/drive-reference.md) with clearly signaled one-level-deep links from SKILL.md.
Add explicit validate-then-retry feedback loops for destructive/batch operations, e.g., verify a file's parents after GOOGLEDRIVE_MOVE_FILE and re-check permissions after GOOGLEDRIVE_DELETE_PERMISSION, to strengthen workflow checkpoints.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and assumes Claude's competence (no explanations of what Drive is), but there is noticeable duplication: pitfalls repeated between workflow sections and the "Known Pitfalls" section (e.g., "files must already be in internal storage" appears twice, "No wildcards" twice, "Multiple parents ... use remove_parents" twice), and Prerequisites overlaps Setup. This fits the level-3 anchor (mostly efficient but could be tightened); it is above level 2 because there is no padded conceptual explanation, but below level 4 due to the duplicated pitfall content. | 3 / 5 |
Actionability | Guidance is concrete and executable in the MCP context: exact tool slugs (GOOGLEDRIVE_UPLOAD_FILE, GOOGLEDRIVE_FIND_FILE), exact parameter names (file_to_upload.s3key, folder_to_upload_to, add_parents/remove_parents), concrete query syntax examples ("name contains 'report'", "'FOLDER_ID' in parents"), and specific error codes (403 PERMISSION_DENIED, 429). It fits level 4 (mostly executable, minor gaps) rather than level 5 because there are no complete tool-call examples covering common end-to-end cases (e.g., a full upload sequence with actual argument values). | 4 / 5 |
Workflow Clarity | Each workflow has a numbered tool sequence with explicit role tags ([Prerequisite], [Required], [Fallback], [Optional]) and several validation checkpoints ("Confirm connection status shows ACTIVE before running any workflows", "GOOGLEDRIVE_GET_FILE_METADATA - Verify file after upload/download", "Always verify parent folder exists before creating children", plus "get explicit user confirmation" for risky sharing). This fits level 4 (clear sequence, most checkpoints present) rather than level 5 because there are no explicit validate-then-retry feedback loops for the destructive/batch operations (permission deletion, bulk moves, pagination-heavy searches). | 4 / 5 |
Progressive Disclosure | The body is well-organized with clear section headers and a Quick Reference table, but no bundle files exist (references/, scripts/, assets/ are absent) and content that arguably belongs in a reference file — the full Query Syntax reference, Export Formats table, and the 16-row Quick Reference table — is inlined in a ~190-line monolithic SKILL.md. This matches the level-3 anchor (some structure, but content that should be separate is inline); it is above level 2 because structure and navigation are good, but below level 4 because the split is entirely absent. | 3 / 5 |
Total | 14 / 20 Passed |