Content
67%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, mostly concrete skill body with real commands, config, and error-recovery guidance. Its weaknesses are redundant restatement of Gemini's strengths across four sections and pseudo-syntax workflow examples that aren't directly executable.
Suggestions
Consolidate the overlapping Gemini-strengths content: merge 'Key Differences' and 'Best Practices' points into the 'When to Use' section so search/big-context benefits are stated once.
Replace the pseudo-blocks in 'Example Workflows' ('[gemini_prompt] prompt: ...') with actual executable invocations, e.g. the real gemini_prompt tool call or a concrete gemini CLI command per workflow.
Move the Authentication methods and MCP/CLI configuration detail into a references/ file, keeping SKILL.md as a lean overview with one-level-deep links.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 'When to Use' list, 'Key Differences' table, 'Best Practices', and 'Example Workflows' each independently restate the same search/big-context strengths ('Gemini excels at queries needing real-time info', 'Leverage Search'), so there is more than minor redundancy. It stays at 3 rather than 2 because most sections carry concrete, non-obvious facts (rate limits, auth methods, commands) rather than concept explanations Claude already knows. | 3 / 5 |
Actionability | Mostly executable guidance: concrete bash invocations ('gemini -p "..." --output-format json'), pipe examples, a JSON MCP config block, env-var exports, and an install command. It falls short of 5 because the Example Workflows use non-executable pseudo-blocks ('[gemini_search] query: ...') rather than real tool-call forms, and MCP tool parameters like working_dir/yolo_mode are never shown in an actual invocation. | 4 / 5 |
Workflow Clarity | Usage patterns are clearly ordered (MCP recommended, then direct CLI, then library) and an Error Handling section provides explicit recovery steps ('Not Found: Install with npm install -g @google/gemini-cli', 'Auth Failed: Run gemini interactively'). Minor gaps: no explicit guidance for verifying which method is available before use, so it does not reach 5; the error-recovery steps keep it above 3. | 4 / 5 |
Progressive Disclosure | A single-file skill (~165 lines) with no bundle files, well-organized into scannable sections (Usage Patterns, Configuration, Error Handling, Authentication). Most content is appropriately placed at overview level, though the detailed auth methods and example workflows could move to a reference file, and the under-50-line exception for a 5 does not apply at this length. | 4 / 5 |
Total | 15 / 20 Passed |