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 content is highly actionable — concrete, executable Membrane commands with a clear connection-state feedback loop — and well structured. Its main weaknesses are a confusing, unrelated overview block and a wrong official-docs URL, plus inconsistent step numbering that slightly muddies the workflow.
Suggestions
Remove or replace the bogus 'Encore Overview' section (Project/Track/Clip/Member/User) and the Spotify Web API docs URL — both appear copy-pasted from an unrelated skill and mislead the model.
Fix the inconsistent step numbering: the body references 'Step 2' but labels the wait step '1b' with no Step 1; renumber the connecting flow coherently.
Tighten prose in Authentication and Best practices (e.g., drop 'so you can focus on the integration logic' and correct 'burn less tokens' to 'burn fewer tokens') to reclaim tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Most of the body is efficient command reference, but it includes unnecessary prose ('so you can focus on the integration logic rather than auth plumbing', 'This will burn less tokens...') and an unrelated, confusing 'Encore Overview' block (Project/Track/Clip/Member/User) that pads the context, matching 'mostly efficient but includes some unnecessary explanation that could be tightened'. | 3 / 5 |
Actionability | The body is dominated by concrete, copy-paste-ready commands with exact flags and a flag reference table — 'membrane connection ensure "https://encore.dev/" --json', 'membrane action run <actionId> --connectionId=CONNECTION_ID --json' — fully covering the common cases, matching the level-5 anchor. | 5 / 5 |
Workflow Clarity | The connection flow has an explicit, sequenced state-checking feedback loop (READY/BUILDING/CLIENT_ACTION_REQUIRED with re-polling), giving clear checkpoints; it stops at 4 rather than 5 because step numbering is inconsistent ('#### 1b', a referenced 'Step 2' with no matching Step 1) and pre-action validation for run/proxy calls is implicit. | 4 / 5 |
Progressive Disclosure | The body is organized into clear, mostly well-placed sections (Install, Authentication, Connecting, Searching, Running, Proxy, Best practices) with no bundle files to delegate to; it is not 5 because the skill exceeds 50 lines and some material (the full proxy flag table, popular actions) could be split out, leaving minor organization gaps. | 4 / 5 |
Total | 16 / 20 Passed |