Content
67%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 well-structured, largely executable guide to the Membrane/HypeAuditor workflow with strong connection-state feedback loops, held back by scattered verbosity, a duplicated command section, and broken step numbering.
Suggestions
Trim filler ('so you can focus on the integration logic rather than auth plumbing', 'This is the fastest way to get a connection') and merge the redundant 'Popular actions' section into 'Searching for actions'.
Fix the step numbering: label the missing '1a'/'Step 2' anchors or replace 'skip to Step 2' with a concrete section name like 'Searching for actions'.
Add at least one concrete, fully-substituted action-run example (e.g. a real HypeAuditor action id with sample --input) so the running-actions guidance is copy-paste ready.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient executable commands, but includes padded phrases ('so you can focus on the integration logic rather than auth plumbing', 'This is the fastest way to get a connection'), a product-intro paragraph, and a 'Popular actions' section that repeats the already-shown action-list command, fitting 'Mostly efficient but includes some unnecessary explanation or could be tightened.' | 3 / 5 |
Actionability | It provides copy-paste-ready commands for install, login, connection, action search/run, and proxy requests plus a complete flag table, but uses generic placeholders like <actionId> and CONNECTION_ID without a concrete real-action example, matching 'Mostly executable guidance; concrete code or commands with minor gaps.' | 4 / 5 |
Workflow Clarity | The Install→Auth→Connect→Poll→Search→Run sequence includes explicit state feedback loops (READY/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR with re-polling), but step numbering is broken — it references an unlabeled 'Step 2' and a '1b' with no '1a' — fitting 'Clear sequence with most checkpoints present; minor validation gaps.' | 4 / 5 |
Progressive Disclosure | No bundle files exist, so all content lives in one well-organized SKILL.md with clear section headers and a category overview; structure and navigation are good, with minor gaps such as the full proxy flag table and schema details kept inline, matching 'Good structure; most content is appropriately placed; minor organization gaps.' | 4 / 5 |
Total | 15 / 20 Passed |