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 solid, command-heavy integration guide with good actionability and a real connection-readiness feedback loop. Its main weaknesses are some trimmable explanatory prose and a dangling "Step 2" cross-reference that slightly weakens workflow navigation.
Suggestions
Remove concept-explainer prose (e.g., the restaurant/POS sentence and "rather than auth plumbing") so every line earns its place for token efficiency.
Fix the dangling "Step 2" reference by labeling the post-connection section (e.g., "## Step 2: Discover and run actions") so the cross-reference resolves.
Add one concrete end-to-end example using a real Deliverect action (e.g., listing recent orders) so the actionability gap between placeholders and real usage closes.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly command-driven and efficient, but includes unnecessary prose such as the Deliverect explainer ("This helps restaurants manage orders efficiently and reduce errors") and filler like "so you can focus on the integration logic rather than auth plumbing" that could be trimmed, matching the mostly-efficient-but-could-tighten level 3. | 3 / 5 |
Actionability | It provides concrete, executable CLI commands for the common cases (login, connection ensure, action list/run, proxy requests) with a flags table, but uses placeholders like CONNECTION_ID and `--intent "QUERY"` and lacks a concrete end-to-end Deliverect example, fitting the mostly-executable level 4. | 4 / 5 |
Workflow Clarity | The connection flow has a clear sequence with an explicit readiness feedback loop (poll until READY, handle CLIENT_ACTION_REQUIRED, surface error states), but the "skip to Step 2" reference has no matching Step 2 anchor, a minor navigation gap that keeps it at level 4. | 4 / 5 |
Progressive Disclosure | With no bundle files, the single SKILL.md is organized into clear, well-labeled sections (Install, Authentication, Connecting, Searching, Actions, Proxy, Best practices); at ~150 lines it stays appropriately single-file, matching level 4 with only minor organization gaps. | 4 / 5 |
Total | 15 / 20 Passed |