Content
61%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 actionable and well-structured CLI guidance with a real error-recovery loop for connection states, but it is padded with removable prose, has muddled step numbering, and inlines material that could be split out. Overall a solid, executable skill with modest trimming and organization gains available.
Suggestions
Remove the opening "MATTR is a platform..." paragraph and the "so you can focus on the integration logic rather than auth plumbing" aside; assume Claude knows what the platform is.
Fix the incoherent step labels: define explicit "Step 1 / Step 2" headers instead of a lone "1b" and a "skip to Step 2" with no visible Step 2.
Add a validation checkpoint before running actions (e.g., "review inputSchema and confirm parameters with the user before running actions that mutate data") and provide one fully worked action-run example with real input and output.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient CLI commands and tables, but retains unnecessary prose such as the MATTR intro paragraph, the "auth plumbing" aside, and a redundant second "Popular actions" action-list example. | 3 / 5 |
Actionability | Concrete, executable membrane commands with flags, JSON input examples, and a proxy options table cover the common cases; the only gap is a fully worked example showing a real actionId and its output payload. | 4 / 5 |
Workflow Clarity | The connection state-polling branch (READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR) is a genuine feedback loop, but the "skip to Step 2" and "1b" labeling is incoherent and there is no validation checkpoint before running potentially destructive actions. | 3 / 5 |
Progressive Disclosure | Sections are well-organized with clear headers and the skill is self-contained with no broken references, but inlined reference material (the clientAction schema and the proxy flag table) could live in a separate reference file. | 4 / 5 |
Total | 14 / 20 Passed |