Content
76%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 content is highly actionable with concrete, copy-paste commands and a clear connection-state feedback loop, organized into clean sections. Its weaknesses are mild over-explanation in the intro and a lack of validation checkpoints for destructive operations, plus an undefined 'Step 2' reference.
Suggestions
Add a validation/confirmation checkpoint before destructive actions (e.g. 'Confirm the D.O. with the user before running delete-job') to lift workflow clarity above the destructive-op cap.
Define the referenced 'Step 2' explicitly or remove the dangling cross-reference so the connection workflow is unambiguous.
Trim the opening descriptive paragraph about what DeTrack is, since Claude and the user already know the product when invoking this skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient commands and tables, but the opening paragraph ("DeTrack is a delivery management software...") and the Agent Types note explain context Claude largely already knows, fitting 'efficient; minor instances of over-explanation that could be trimmed'. | 4 / 5 |
Actionability | It provides copy-paste-ready commands throughout (install, login, connection ensure, action list/run with --input, request with flags) plus a popular-actions table, fully covering the common cases per the top anchor. | 5 / 5 |
Workflow Clarity | The connection setup has a real feedback loop (poll BUILDING -> handle CLIENT_ACTION_REQUIRED -> poll again), but 'Step 2' is referenced without being defined and destructive operations (delete-job, update-job) lack validation checkpoints; the destructive-op cap holds this at 3. | 3 / 5 |
Progressive Disclosure | With no bundle files present, the single SKILL.md is organized into clear, navigable sections (Overview, Auth, Connecting, Searching, Popular actions, Proxy, Best practices); the inlined action and proxy-flag tables could be separate references, but inline placement is reasonable for a CLI skill. | 4 / 5 |
Total | 16 / 20 Passed |