Content
70%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 actual skill instructions are excellent — executable, well-sequenced, and validated at every step — but they arrive only after ~340 lines of generic gstack framework policy (persona, telemetry onboarding, formatting rules) that belongs in a shared reference file. The file reads as a template dump rather than a skill-focused document.
Suggestions
Move the framework policy sections (Voice, AskUserQuestion Format, Completeness Principle, Repo Ownership, Contributor Mode, Completion Status Protocol, Plan Status Footer) into a shared gstack reference file (e.g., $GSTACK_ROOT/ETHOS.md or a FRAMEWORK.md) and keep SKILL.md focused on the connect-chrome workflow.
Trim the preamble's onboarding dialogs (lake intro, telemetry, proactive prompts) to a short pointer or a single conditional block instead of full quoted AskUserQuestion scripts, cutting several hundred tokens from every skill load.
If the boilerplate must stay inline, add a table of contents or move the '# /connect-chrome' workflow section to the top so the actual task instructions are not buried below line 340.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Roughly 340 of the ~530 body lines are gstack framework boilerplate unrelated to launching Chrome — the Voice persona essay, telemetry onboarding dialogs, AskUserQuestion format rules, Completeness Principle, Contributor Mode, and Plan Status Footer — which is several padded sections competing with the ~200 lines of actual skill instruction. Not 1 because the skill-specific portion itself is lean and free of concept explanations Claude already knows. | 2 / 5 |
Actionability | The workflow is fully executable: copy-paste-ready bash for the setup check, pre-flight cleanup, `$B connect`, `$B status`, `$B goto`, and `$B snapshot -i`, with expected outputs named ("Confirm you see `Mode: headed`", port 34567) and specific fallback commands for each failure branch. Not 4 because there is no missing detail blocking execution of the common cases. | 5 / 5 |
Workflow Clarity | The sequence SETUP → Step 0 cleanup → connect → verify → user confirmation → demo → next steps is explicit, with validation checkpoints at each transition (mode check, port check, A/B/C user confirmation) and feedback loops for error recovery (option C: re-run Step 0 + Step 1, try `$B focus`, then ask the user). This matches the top anchor; the operation is not destructive or batch, so no cap applies. | 5 / 5 |
Progressive Disclosure | There is real structure (clear ## sections, numbered steps) and one-level-deep references that are reasonably signaled ("See $GSTACK_ROOT/ETHOS.md", read gstack-upgrade/SKILL.md for the upgrade flow), but a large amount of framework policy that clearly belongs in a separate shared file is inlined, burying the actual /connect-chrome instructions on line 341. Not 4 because the misplaced inline content is substantial, not a minor organization gap. | 3 / 5 |
Total | 15 / 20 Passed |