Content
82%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 an efficient, actionable overview that defers implementation to real bundle scripts and provides copy-paste usage examples with a validated consent flow. Minor over-explanation and the absence of an auth error-recovery loop keep it from the top band.
Suggestions
Trim the CDP-vs-Chrome-DevTools-MCP aside in Authentication to a single clause; it explains context Claude does not need to act.
Add an explicit error-recovery note for authentication (e.g., 'if cookie refresh fails, retry with --login or a dedicated --profile-dir') to give the fragile auth path a feedback loop.
Make script references navigational rather than tabular where detail lives in the bundle (e.g., 'See scripts/gemini-webapi/ for the client implementation') so progressive disclosure is clearly signaled.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely lean with tables and code blocks and no beginner-concept padding, but a few lines over-explain (e.g., the CDP-vs-DevTools-MCP aside and the AskUserQuestion runtime-equivalent guidance), keeping it just short of fully lean. | 4 / 5 |
Actionability | Copy-paste-ready commands cover the common cases (text, image, vision, multi-turn, JSON), the options and env-var tables give concrete flags, and the {baseDir}/${BUN_X} placeholders are resolved via explicit substitution instructions. | 5 / 5 |
Workflow Clarity | The consent flow is a clearly sequenced numbered list with a validation checkpoint (check consent file for accepted:true and disclaimerVersion) and accept/decline branching, but there is no error-recovery feedback loop for the fragile auth/cookie path. | 4 / 5 |
Progressive Disclosure | Well-organized sections with real one-level-deep bundle references (scripts/main.ts, scripts/gemini-webapi/*) listed in a reference table and EXTEND.md paths in a priority table; references are real but script pointers are listed rather than navigational 'See X for details' links. | 4 / 5 |
Total | 17 / 20 Passed |