Content
67%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 mostly lean, executable guide with a genuine connection-state feedback loop, undermined by an unnecessary intro paragraph and inconsistent step numbering. No bundle files exist, so all content is appropriately inline and well-sectioned.
Suggestions
Cut the opening "Instatus is a status page platform..." background paragraph; Claude does not need the business rationale.
Fix the step numbering: define an explicit "Step 1/Step 2" structure or relabel the orphan "1b" and the undefined "Step 2" references.
Add one complete proxy example with method, data, and a real endpoint to close the actionability gap.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The opening paragraph explaining what Instatus is and why companies use it ("helps companies communicate incidents... improve transparency and build trust") is background Claude does not need, plus promotional lines like "so you can focus on the integration logic rather than auth plumbing". | 3 / 5 |
Actionability | Copy-paste-ready commands cover install, login, connect, poll, search, run, and proxy with an options table, but examples lean on placeholders (CONNECTION_ID, <id>) and the proxy section lacks one complete annotated example. | 4 / 5 |
Workflow Clarity | There is a clear install→auth→connect→discover→run sequence with an explicit poll/retry feedback loop for connection readiness, but step numbering is broken (references to "Step 2" with no Step 2 header, an orphan "1b" subsection). | 4 / 5 |
Progressive Disclosure | Clean section headers make the single-file skill navigable, and inlined content (lifecycle states, options table) is reasonable with no bundle files present, but nothing is split into references so it stays just below a 5. | 4 / 5 |
Total | 15 / 20 Passed |