Content
71%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 an actionable, well-structured guide to driving Ghost through the Membrane CLI, with concrete commands and a clear connection-state workflow. Its main weaknesses are inconsistent step numbering and the absence of any progressive disclosure into reference files despite a sizeable inline actions table.
Suggestions
Fix the workflow numbering: label "Step 1: Connect" and "Step 2: Search and run actions" explicitly so the "skip to Step 2" and "1b" references resolve.
Add at least one concrete create/update example with a real Ghost field payload (e.g. create-post with title/mobiledoc) instead of the generic {"key":"value"}.
Move the 20-row popular-actions table and the proxy-flags table into a references/ file (e.g. ACTIONS.md) and link to it from SKILL.md to improve progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean commands, tables, and state-handling detail that Claude does not already know about the Membrane CLI; the only clear over-explanation is the opening "Ghost is a content management system..." intro and a few Membrane-internals asides. | 4 / 5 |
Actionability | It provides copy-paste-ready commands for install, login, connection ensure/get, action list/run, and proxy requests, plus a 20-row actions table, but create/update examples only show a generic {"key":"value"} input rather than a concrete post payload. | 4 / 5 |
Workflow Clarity | The connection lifecycle is sequenced with explicit state checkpoints (READY / BUILDING / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR) and a re-poll feedback loop, but numbering is inconsistent (a "1b" with no "1a" and a reference to "Step 2" that is never labeled). | 4 / 5 |
Progressive Disclosure | The file is well-sectioned with headers but is ~170 lines entirely inline with no bundle files or one-level-deep references; the large popular-actions and proxy-options tables are content that could live in a reference file for a skill this size. | 3 / 5 |
Total | 15 / 20 Passed |