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 concise catalogue stub that delegates the real workflow to the upstream repository, so it is well-structured but lacks executable, in-skill guidance. Actionability and workflow clarity are weak because no concrete API usage or install commands are provided.
Suggestions
Add a minimal executable example for the core skill operation (e.g., a `replicate run` or curl/Python snippet that actually calls a model), rather than only opening the upstream URL.
Specify the install step with a concrete command or exact path instead of 'install the upstream bundle into your active agent's skills directory'.
Include a brief validation checkpoint (e.g., how to confirm the skill is installed and invokable) so the workflow has a feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and sectioned; only minor meta commentary ('This catalogue entry advertises the skill in OpenDesign...') and the repeated description sentence could be trimmed. | 4 / 5 |
Actionability | The only concrete command is `open https://github.com/replicate/skills`, which merely opens a URL; there is no executable guidance for actually discovering, comparing, or running models via the Replicate API. | 2 / 5 |
Workflow Clarity | A rough sequence is implied (inspect upstream README, install bundle, invoke by name/trigger) but the install step is undefined with no actual command, and there are no validation checkpoints. | 2 / 5 |
Progressive Disclosure | Short, well-organized into clear sections with the upstream reference clearly signaled; no bundle files exist locally so there is no local one-level-deep navigation to evaluate. | 4 / 5 |
Total | 12 / 20 Passed |