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.
The body is highly actionable with a complete MCP prompt, concrete fallback chain, and explicit output schema, and the workflow is well sequenced. Its main weaknesses are verbose time-sensitive model/version detail and the absence of any progressive disclosure — everything lives inline in one large file.
Suggestions
Move the model/version compatibility notes (gemini-cli v0.40+, auto-gemini-3 routing, downgrade behavior) into a short reference file or a clearly labeled 'legacy models' section, keeping only DEFAULT_MODEL and the override syntax in the body.
Make the CLI fallback fully executable by including the complete prompt in the `gemini -p` command instead of the '...same prompt as above...' placeholder.
Extract the full search prompt template and the sibling-skill comparison table into references/ files (e.g. PROMPT.md) and link to them, so SKILL.md stays a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly operational content, but the DEFAULT_MODEL constant carries a long time-sensitive parenthetical ('Required by mcp__gemini-cli__ask-gemini and gemini-cli v0.40+; explicit gemini-3-pro-preview can be silently downgraded... when capacity is exhausted') and sections like 'When to use which' re-explain things Claude can infer, so it sits at anchor 3 rather than the tighter anchor 4. | 3 / 5 |
Actionability | The MCP call includes a complete copy-paste-ready prompt with an exact per-paper output format, plus concrete install, `codex mcp add`, and `gemini --version` commands; however the CLI fallback abbreviates the prompt ('...same prompt as above...') instead of giving the full executable command, which keeps it below anchor 5. | 4 / 5 |
Workflow Clarity | Five clearly numbered steps with an explicit error-recovery chain (MCP first, CLI fallback, then alternative skills if both unreachable) and a setup verification command; but parsed results get no real validation step beyond 'note this but do not re-query', leaving minor checkpoint gaps versus anchor 5. | 4 / 5 |
Progressive Disclosure | Section structure is clean, but there are no bundle files at all — the full search prompt template, the model/version compatibility notes, and the sibling-skill comparison table are all inlined in a ~200-line SKILL.md where they belong in one-level-deep reference files, matching anchor 3 rather than anchor 4. | 3 / 5 |
Total | 14 / 20 Passed |