Content
35%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a brief catalogue entry that defers essentially all real guidance to an external GitHub repo rather than providing executable instructions. It is tidy and avoids over-explanation, but it lacks concrete commands and local reference materials.
Suggestions
Replace the abstract install instruction with a concrete, copy-pasteable command (e.g., git clone / symlink / file copy into the skills directory) so the guidance is actionable.
Either bundle the upstream scripts/references locally so the referenced 'full upstream workflow' actually exists in the skill, or explicitly state which subset the agent should perform in-session without the external bundle.
Trim the verbatim restatement of the description and the planning-rationale prose to tighten token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short and does not explain concepts Claude already knows, but it restates the description verbatim and pads with prose ('advertises the skill in Open Design so the agent discovers it during planning') that earns little of its tokens. | 2 / 3 |
Actionability | Guidance is abstract rather than executable: 'install the upstream bundle into your active agent's skills directory' with no commands, and the only code block is a comment plus an `open <url>` instruction. It describes rather than instructs. | 1 / 3 |
Workflow Clarity | There is a light sequence (inspect upstream, install bundle, invoke by name/trigger), but no concrete commands, no validation checkpoints, and key install steps are deferred to the upstream README. | 2 / 3 |
Progressive Disclosure | Content is organized into short sections and points one level deep to the upstream repo, but there are no local bundle files (references/, scripts/, assets/ absent), so the 'full upstream workflow' referenced in the body is not actually present in the bundle. | 2 / 3 |
Total | 7 / 12 Passed |