Content
68%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.
A highly actionable, command-first skill body with excellent executable coverage of the Membrane CLI workflow. Its weaknesses are mild intro padding, incoherent step cross-references ('Step 2' is never defined), and missing validation guidance for destructive actions like delete-room and delete-message.
Suggestions
Fix the workflow numbering: label the post-connection steps explicitly (e.g., 'Step 2: Search for actions') so the two 'skip to Step 2' references resolve, and renumber or drop the orphaned '#### 1b' heading.
Add a brief verification step before destructive actions (delete-room, delete-message), e.g., confirm the target room/message ID with a get-room/get-message call and confirm with the user before running the delete.
Trim the overview paragraph ('Chatwork is a team collaboration and communication tool...') and the filler line 'Use action names and parameters as needed' to cut tokens without losing guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with concrete commands and tables, but the intro ('Chatwork is a team collaboration and communication tool... used by businesses of all sizes to streamline internal communication') explains a concept Claude already knows, and filler like 'Use action names and parameters as needed' adds tokens without guidance. | 3 / 5 |
Actionability | Fully executable, copy-paste-ready commands cover the common cases: install ('npm install -g @membranehq/cli@latest'), login including headless completion ('membrane login complete <code>'), 'membrane connection ensure "https://go.chatwork.com/en/" --json', action list/run with '--input' JSON, and the proxy request flag table. Not below 5: no pseudocode or missing key details found. | 5 / 5 |
Workflow Clarity | A rough install → authenticate → connect → search → run sequence exists with state-polling checkpoints (READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR), but two 'skip to **Step 2**' references point to a step that is never labeled, and destructive actions (delete-room, delete-message) include no verification guidance, capping this at 3. | 3 / 5 |
Progressive Disclosure | No bundle files exist; the single SKILL.md is well-sectioned with headers, an actions table, and no nested references. Fits anchor 4 rather than 5 due to minor organization gaps such as the dangling 'Step 2' cross-references and the orphaned '#### 1b' heading numbering. | 4 / 5 |
Total | 15 / 20 Passed |