Content
75%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 strong, executable CLI integration guide with a well-sequenced connection workflow and concrete commands throughout. Its main weakness is conciseness: a marketing-style intro and a duplicated actions section add tokens that don't earn their place.
Suggestions
Delete the product-marketing intro paragraph ("PrintAutopilot is a SaaS application... marketing agencies...") and the "so you can focus on the integration logic rather than auth plumbing" aside; Claude does not need them.
Merge the near-duplicate "Searching for actions" and "Popular actions" sections into a single discovery section to remove the repeated `action list --intent` examples.
Fix the broken step numbering: define "Step 1"/"Step 2" (or remove the "Step 2" references and the orphaned "1b" heading) so the connection workflow reads as one coherent numbered sequence.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly an efficient CLI reference, but the marketing-style intro ("used by print service providers and marketing agencies to streamline the process..."), the "focus on the integration logic rather than auth plumbing" aside, and the duplicated action-list sections ("Searching for actions" vs "Popular actions") are unnecessary padding that could be trimmed. | 3 / 5 |
Actionability | Every workflow ships copy-paste-ready commands (install, login incl. headless completion, connection ensure/get with --wait, action list/run with --input, and a full proxy flag table) covering the common cases. | 5 / 5 |
Workflow Clarity | The connection lifecycle is clearly sequenced with explicit state branches (READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR) and a poll-again feedback loop, but "Step 2" is referenced without being defined and the "1b" heading sits oddly without a matching "1a"/"Step 1". | 4 / 5 |
Progressive Disclosure | No bundle files exist and all content lives inline in a reasonably sectioned ~140-line SKILL.md; structure is good with minor gaps (the near-empty "Popular actions" header and redundancy with "Searching for actions"). | 4 / 5 |
Total | 16 / 20 Passed |