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 body is highly actionable with concrete, copy-paste commands and a well-structured connection state machine, but it carries some redundant prose, an incoherent 'Step 2' reference, and no validation guidance for the destructive Record operations the skill exists to perform.
Suggestions
Add a short Records CRUD workflow with a verification step (e.g. re-fetch or list the record after create/update/delete) to satisfy the destructive-operations validation requirement.
Fix the broken cross-reference: replace 'skip to Step 2' with a concrete anchor like 'skip to Searching for actions', and label the section sequence consistently (e.g. Step 1 / 1b / Step 2).
Remove the duplicated `membrane action list` command in 'Popular actions' and the Shopee background paragraph that Claude does not need.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly executable commands, but the opening 'Shopee is a mobile-first e-commerce platform…' background prose and the duplicated `membrane action list` command (shown in both 'Searching for actions' and 'Popular actions') are unnecessary padding that could be tightened. | 3 / 5 |
Actionability | Provides copy-paste-ready bash commands for every stage (install, login, connection ensure, poll, action list/run, request) plus a full proxy flag table; minor gap is the lack of a concrete filled example with a real Shopee action id rather than <actionId> placeholders. | 4 / 5 |
Workflow Clarity | The connection flow has a real poll-until-READY feedback loop, but 'skip to Step 2' references a Step 2 that is never labeled, and the skill's core destructive CRUD on Records has no validation checkpoint, so per the destructive-ops cap it cannot exceed 3. | 3 / 5 |
Progressive Disclosure | A single well-sectioned CLI reference file with clear headers and no need for external bundle files; it exceeds 50 lines so the simple-skill 5 exception does not apply, leaving minor organization gaps that hold it at 4. | 4 / 5 |
Total | 14 / 20 Passed |