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.
The body is highly actionable with complete, executable Membrane CLI commands and a solid connection-state feedback loop, but it opens with unnecessary background on what Bitwarden is and provides no validation steps for destructive vault operations.
Suggestions
Remove or trim the introductory paragraph and 'Bitwarden Overview' section — Claude already knows what Bitwarden and vaults/items are.
Add a validation/check step before running destructive actions (e.g., deleting or overwriting vault items), such as listing the target item and confirming with the user first.
Consider moving the proxy-request flag table and connection-state reference into a separate reference file to keep SKILL.md a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with concrete CLI commands, but the opening paragraph ('Bitwarden is an open source password manager...used by individuals, teams, and businesses') and the generic Vault/Items/Organizations overview explain concepts Claude already knows, which the rubric penalizes. | 3 / 5 |
Actionability | Copy-paste-ready commands cover the common cases end to end — install, login (interactive and headless), connection ensure, polling, action list/run with JSON inputs, and proxy requests with a full flag table — fully executable guidance. | 5 / 5 |
Workflow Clarity | The connection setup has an explicit feedback loop (poll state → handle READY/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR → re-poll), but there is no validation guidance for destructive action runs against vault data, leaving a minor checkpoint gap. | 4 / 5 |
Progressive Disclosure | No bundle files exist, so all content is inline in a single well-organized file with clear section headers and no nested references; structure is good though ~100 lines of CLI detail could arguably be split into a reference file. | 4 / 5 |
Total | 16 / 20 Passed |