Content
75%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 CLI-integration skill with copy-paste commands and a well-validated connection workflow. The main weaknesses are minor intro padding that assumes Claude lacks context, and the absence of verification steps before destructive action execution.
Suggestions
Trim the introductory paragraph ("Piggy is a personal finance app...") and the "so you can focus on the integration logic rather than auth plumbing" clause; Claude does not need Piggy's marketing context.
Add a verification/check step before running actions that mutate Accounts, Budgets, or Goals (e.g. confirm the action's inputSchema and dry-run intent before `membrane action run`) to satisfy the destructive-operation workflow cap.
Consider moving the proxy flags table and extended connection-state handling into a reference file, keeping SKILL.md as a lean overview with one-level-deep links.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with concrete commands, but includes unnecessary padding Claude does not need ("Piggy is a personal finance app that helps users track their spending..." and "so you can focus on the integration logic rather than auth plumbing"); not a 4 because these explanatory sentences are noticeable rather than minor. | 3 / 5 |
Actionability | Fully executable, copy-paste-ready commands throughout ("npm install -g @membranehq/cli@latest", "membrane connection ensure", "membrane action run", "membrane request") with a flags table and JSON-output guidance covering the common cases. | 5 / 5 |
Workflow Clarity | The connection workflow has explicit validation checkpoints (READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR) and a feedback loop (poll again after user action); not a 5 because running actions that can modify Accounts, Budgets, or Goals lacks a pre-flight verification step for destructive operations. | 4 / 5 |
Progressive Disclosure | Single-file skill (~90 lines) with well-organized sections (Install, Authentication, Connecting, Searching, Running, Proxy, Best practices) and no need for external bundle files; not a 5 because it exceeds the under-50-lines simple-skill threshold and a few subtopics (e.g. the proxy flag table) could optionally live in a reference file. | 4 / 5 |
Total | 16 / 20 Passed |