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 acts as a thin catalogue stub that defers all real guidance to an external upstream repo, offering little actionable or verifiable instruction. It is concise but lacks executable steps, a real workflow, and any local progressive-disclosure structure.
Suggestions
Replace the external-repo pointer with at least one concrete, copy-paste-ready command or code snippet for the core task (e.g., creating a DOCX via OpenXML SDK).
Define a real multi-step workflow with explicit validation (e.g., create -> validate -> pack) instead of 'inspect the upstream README'.
Either ship local references/scripts and link to them with well-signaled one-level-deep paths, or clearly state that this entry is a discovery stub so reviewers don't expect in-skill instructions.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short and avoids re-explaining concepts Claude knows, but spends tokens on meta framing ('This catalogue entry advertises the skill in Open Design so the agent discovers it during planning') that does not advance the skill's purpose; matches the 'mostly efficient but includes some unnecessary explanation' anchor. | 2 / 3 |
Actionability | The only executable snippet is `open https://github.com/...`; the rest defers to 'install the upstream bundle' and 'ask the agent to invoke' with no concrete commands, paths, or steps, so it describes rather than instructs; matches the 'vague or abstract; no concrete code/commands' anchor. | 1 / 3 |
Workflow Clarity | There is a minimal ordering (inspect the upstream README, then invoke the skill) but no real sequence with validation checkpoints, and the actual workflow is offloaded to an external README; matches the 'steps listed but validation gaps / checkpoints missing' anchor. | 2 / 3 |
Progressive Disclosure | No local bundle files exist and the only reference points to an external GitHub repo rather than well-signaled one-level-deep local files; there is some section structure but no appropriately split local references, matching the 'some structure but could be better organized; references not clearly signaled' anchor. | 2 / 3 |
Total | 7 / 12 Passed |