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 strongly actionable — real commands, a popular-actions table with keys, and a well-handled connection state machine with polling and error states. Its weaknesses are instructional padding (the Asana intro and overview sections), a dangling 'Step 2' reference, and no validation or confirmation guidance around destructive operations (delete-task, delete-project), which caps workflow clarity.
Suggestions
Add verification/confirmation guidance around destructive operations (delete-task, delete-project): e.g. get the task by GID first, confirm with the user, then delete, and check the output for success — the current skill runs deletes with no checkpoint.
Remove the concept-explanation padding: the 'Asana is a project management tool...' intro paragraph, the bare 'Asana Overview' object list, and the filler line 'Use action names and parameters as needed' add nothing Claude does not already know.
Fix the dangling 'skip to **Step 2**' reference by labeling the actual steps (there is a '1b' heading but no Step 2), and add one worked example resolving placeholders — e.g. `membrane action run create-task --connectionId=... --input '{"name": "Fix login bug", "projects": "120"}' --json`.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dominated by executable commands and tables (good), but contains unnecessary padding Claude does not need: the opening paragraph explaining what Asana is ('Asana is a project management tool that helps teams organize, track, and manage their work...'), a bare 'Asana Overview' object list with no purpose, the filler line 'Use action names and parameters as needed', and verbose best-practice prose (including the typo 'This will burn less tokens'). This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened'); not 2 because the padding is limited to a few short sections, not 4 because those sections are clearly trimmable. | 3 / 5 |
Actionability | Concrete, copy-paste-ready commands cover the whole flow: `npm install -g @membranehq/cli@latest`, `membrane login --tenant --clientName=<agentType>`, `membrane connection ensure "https://app.asana.com/" --json`, `membrane action run <actionId> --connectionId=... --input '{...}'`, plus a proxy flag table and a popular-actions table with real keys (list-tasks, create-task, delete-project). It falls short of anchor 5 only because parameter examples are generic — the sole `--input` example is placeholder `'{"key": "value"}'` and no real payload (e.g. creating a task with name/projects) is shown, and `<actionId>`/`CONNECTION_ID` placeholders are never resolved with a worked example. Not 3 because everything shown is executable, not pseudocode. | 4 / 5 |
Workflow Clarity | The setup sequence is present and well-branched (install → login with headless fallback → connection ensure → poll on BUILDING → interpret READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR with the `error` field), which approaches anchor 4. However, the skill includes destructive operations (delete-task, delete-project) with no verification or confirmation guidance around them, which per the rubric caps workflow clarity at 3. Additional gaps reinforce 3: the text says 'skip to **Step 2**' but no Step 2 is ever labeled or defined (only a '1b' heading exists), and running actions has no error-handling or output-validation checkpoint. Not 2 because the connection-state polling and state-machine interpretation are genuine, well-defined checkpoints. | 3 / 5 |
Progressive Disclosure | There are no bundle files, so structure rests on the single SKILL.md, which is a reasonable length (~165 lines) with clear section headers (Install, Authentication, Connecting, Searching, Popular actions, Running actions, Proxy requests, Best practices) and no nested references. This matches anchor 4 ('good structure; most content is appropriately placed; minor organization gaps'). Not 5 because the content exceeds the under-50-lines simple-skill exception and includes minor organization flaws — the pointless 'Asana Overview' object list, the dangling 'Step 2' reference, and slight redundancy between the 'Popular actions' table and 'Best practices' section. Not 3 because nothing is buried and no content that clearly belongs in a separate file is inlined at harmful scale. | 4 / 5 |
Total | 14 / 20 Passed |