Content
47%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 a well-organized, token-efficient catalogue stub, but as instructions it is mostly a pointer: the one runnable command opens a webpage and the actual installation workflow — the skill's core 'how to use' — is left unspecified. Strengthening the install step with concrete commands and checkpoints would address both of its lowest dimensions.
Suggestions
Replace the browser-open snippet with the actual installation steps, e.g. a concrete git clone or download command plus the target skills-directory path, so the core 'install the upstream bundle' action is executable rather than a hint.
Add a verification checkpoint after installation (e.g. how to confirm the bundle is discoverable by the agent) so the workflow has a validation step before invoking the skill.
Remove the duplicated description in 'What it does' and the repeated upstream URL to tighten conciseness toward the 5-anchor.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with no explanations of concepts Claude already knows, fitting 'efficient; minor instances that could be trimmed'. It is not 5 because the description is repeated verbatim in 'What it does' and the upstream URL appears twice (frontmatter, Source section, and the bash block), which is redundant padding. | 4 / 5 |
Actionability | The only executable command is `open https://github.com/garrytan/gstack`, which merely opens a page; the actual required action — 'install the upstream bundle into your active agent's skills directory' — has no command, path, or steps, matching 'minimal concrete guidance; high-level hints but missing the specific steps to execute'. It is not 3 because there is no partially-executable instruction for the core task, only a browser open and a vague directive. | 2 / 5 |
Workflow Clarity | A rough sequence exists (inspect upstream README → install bundle → invoke by name or trigger), but the central step is undefined — where to get the bundle, how to install it, and into which directory are all left to the reader, matching 'rough sequence present but many gaps; steps poorly defined'. It is not 3 because even the listed steps lack the concrete commands the 3-anchor assumes, and not 1 because the ordering that is present is coherent. | 2 / 5 |
Progressive Disclosure | The body is short, sectioned (What it does / Source / How to use), and defers all detailed material to a single clearly-labeled upstream pointer rather than inlining walls of text, fitting 'good structure; most content appropriately placed; minor organization gaps'. It is not 5 because no local reference structure exists at all and the one essential link is buried inside prose and a code comment rather than clearly signaled as the skill's reference layer; it is above 3 because nothing that belongs in a separate file is inlined and navigation of what exists is easy. | 4 / 5 |
Total | 12 / 20 Passed |