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.
The body delivers a largely executable, well-sectioned guide for connecting to Beebole and discovering/running actions, with efficient command-first writing. Its main weaknesses are a broken step-numbering scheme (references to a nonexistent "Step 2"), no worked example of running a real action with concrete input, and no verification guidance for destructive operations like delete-time-entry.
Suggestions
Fix the dangling workflow references: "skip to **Step 2**" and the "1b" subsection numbering point to steps that are never labeled — either number the workflow explicitly (1. Connect, 2. Discover actions, 3. Run) or drop the cross-references.
Add a worked example with a real action from the table, e.g. "membrane action run list-time-entries --connectionId=CONNECTION_ID --input '{\"from\": \"2026-01-01\", \"to\": \"2026-01-31\"}' --json".
Add verification guidance for write/delete operations — e.g. fetch the target with get-person/get-time-entry before deleting, and check the output field for errors after create/update.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is command-dense and lean in most sections (Install, Authentication, Connecting, Proxy), with only minor trimmable content like the filler line "Use action names and parameters as needed." and the marketing-style intro "It's used by businesses of all sizes to monitor employee work hours...". This matches anchor 4 ("Efficient; minor instances of over-explanation that could be trimmed") rather than 3, since padding is sparse and the app context is arguably necessary for a niche SaaS. | 4 / 5 |
Actionability | Nearly all guidance is copy-paste executable: "npm install -g @membranehq/cli@latest", "membrane connection ensure \"https://beebole.com/\" --json", "membrane action run <actionId> --connectionId=CONNECTION_ID --input '{\"key\": \"value\"}' --json", plus a concrete proxy flag table. It falls short of anchor 5 only because there is no worked example running a real action from the table (e.g. list-time-entries) with concrete input values — anchor 4 ("concrete code or commands with minor gaps"). | 4 / 5 |
Workflow Clarity | A rough sequence exists (Install → login → connection ensure → poll states → action list → action run) with connection-state checkpoints (re-poll after CLIENT_ACTION_REQUIRED), but the text says "skip to **Step 2**" and numbers a section "1b" while no Step 1/Step 2 labels exist anywhere — a dangling workflow reference. Additionally, the actions table includes destructive operations (delete-time-entry, update-person) with no validation/verification guidance, which caps workflow clarity at 3 per the destructive-operations rule. Not anchor 2, since a coherent sequence and some error-recovery checkpoints are present. | 3 / 5 |
Progressive Disclosure | This is a single-file skill with no bundle directories, and the body is well-sectioned with clear headers (Install the CLI, Authentication, Connecting to Beebole, Searching for actions, Popular actions, Proxy requests, Best practices). It matches anchor 4 ("Good structure; most content is appropriately placed; references mostly clear; minor organization gaps") rather than 5 because the ~20-row actions table and full proxy flag reference are inlined in SKILL.md instead of being split into reference files, though they arguably mirror what "membrane action list" returns. | 4 / 5 |
Total | 15 / 20 Passed |