Content
71%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 highly actionable, well-structured skill body with concrete commands and validation-aware workflows. Its main weakness is progressive disclosure: five provided bundle files (three references, two assets) are orphaned — never linked from SKILL.md — while comparable command detail is inlined.
Suggestions
Add a navigation/links section that points to references/gws-command-reference.md, references/recipes-cookbook.md, references/troubleshooting.md, and assets/persona-profiles.md so the provided bundle material is discoverable instead of orphaned.
Move the bulk of the inlined `gws <service> <resource> <method>` command surface into references/gws-command-reference.md, keeping only one representative example per workflow in SKILL.md.
Replace the `...` placeholder helper commands (e.g. `gws gmail +reply ...`, `gws sheets +read ...`) with one complete worked example each, or link directly to the relevant reference entry.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely lean and command/table-driven, assuming Claude's competence, but the repeated "(verify)" disclaimers and "check exact flags with --help" lines recur enough to be trimmable, keeping it just short of fully lean. | 4 / 5 |
Actionability | Mostly copy-paste-ready commands and code, but several helper commands are shown as `...` placeholders (e.g. `gws gmail +reply ...`, `gws sheets +read ...`), which are minor execution gaps. | 4 / 5 |
Workflow Clarity | Workflows are clearly sequenced with validation checkpoints (gws_doctor.py pre-flight, `--dry-run` before bulk ops, `--validate --json`), satisfying the destructive/batch validation rule, though not every workflow has an explicit error-recovery feedback loop. | 4 / 5 |
Progressive Disclosure | The body is well-sectioned and all scripts/ are linked one level deep, but the provided references/ (gws-command-reference, recipes-cookbook, troubleshooting) and assets/ (persona-profiles, workspace-config) files are never referenced from the body, and inlined command-surface content duplicates what those reference files likely hold. | 3 / 5 |
Total | 15 / 20 Passed |