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.
The body is strongly actionable with concrete, executable CLI patterns and clear error-recovery guidance, and it makes good use of one-level-deep references with explicit load triggers. It is let down by token inefficiency: triple-stated rules, duplicated sections, and metadata filler (TOC, version history, support/license) that should be trimmed or moved out of SKILL.md.
Suggestions
State the "always use -p" rule once (Production Rules) and reference it from Quick Start and the errors section; likewise merge the duplicated model-selection guidance into the Model Selection section.
Remove or relocate the Table of Contents, Version History, Related Skills, License, and Support sections — none of them help Claude execute the skill.
Either document the scripts/ directory in the "When to Load References" section or delete install-gemini-coach.sh, which belongs to the deprecated gemini-coach wrapper the skill no longer uses.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Noticeably verbose: the "always use -p" rule is stated three times (Quick Start, Error 3, Production Rule 1), model-selection guidance is duplicated (Model Selection section vs Production Rule 2, synthesis pattern in both Integration Example and Rule 5), and ~45 lines go to a Table of Contents, Version History with dates/versions, License, and Support sections that earn no tokens for Claude. Not a 3 because this volume of repetition and non-instructional padding is more than "some unnecessary explanation", and time-sensitive version/date details are not confined to a deprecated section. | 2 / 5 |
Actionability | Fully executable copy-paste commands throughout — exact flags (-p, -m, --all-files, -i), concrete prompts with context/question/considerations structure, numbered installation steps with verification, real error strings paired with fixes, and a ready if/else fallback shell snippet. The top three use cases cover the common scenarios with complete commands. | 5 / 5 |
Workflow Clarity | The sub-workflows are well sequenced with checkpoints: install → authenticate → verify (expected output stated), a decision guide mapping scenario to model, error cause → solution pairs, and a graceful-failure fallback pattern. Not a 5 because the skill reads as parallel reference sections rather than one explicitly ordered end-to-end workflow (consult → run → synthesize → fallback), and the "2+ failed attempts" trigger has no defined retry/feedback loop. | 4 / 5 |
Progressive Disclosure | A dedicated "When to Load References" section signals each of the three reference files with explicit per-file triggers, notes one file as obsolete, and the references are one level deep (verified: no nested cross-references). Not a 5 because the three scripts in scripts/ are never mentioned in the body — undocumented bundle files, one of which (install-gemini-coach.sh) relates to the deprecated wrapper the skill says it moved away from. | 4 / 5 |
Total | 15 / 20 Passed |