Content
71%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 content is highly actionable with executable Membrane CLI commands and a clear, validated connection workflow, but it carries marketing padding and inlines bulk reference material (the actions table) that would benefit from a separate file. Overall a strong, practical skill body with modest conciseness and disclosure improvements available.
Suggestions
Cut the introductory marketing paragraph and the cryptic 'Cody Overview' bullet list; Claude does not need to be told what an AI coding assistant is.
Move the 18-row popular actions table and the clientAction field reference into a references/ file (e.g. ACTIONS.md) and link to it from a short summary, applying progressive disclosure.
Fix the dangling 'Step 2' reference and the '1b' sub-numbering so the connection workflow has a clean, explicit step sequence.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with concrete CLI commands, but the marketing-style opening ('Cody is an AI coding assistant that helps developers write code and understand code faster... Developers of all skill levels use Cody to improve their productivity and code quality.') and the cryptic 'Cody Overview' bullet list are unnecessary padding Claude does not need, fitting 'mostly efficient but includes some unnecessary explanation'. | 3 / 5 |
Actionability | It provides copy-paste-ready, fully executable commands for every common case (npm install, membrane login, connection ensure/get with --wait, action list/run with --input, request proxy) with flags explained, matching the level-5 anchor for fully executable guidance covering common cases. | 5 / 5 |
Workflow Clarity | The install→auth→connect→search→run sequence is clear and the connection section has explicit validation via state polling (READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR) with re-poll feedback loops, but the dangling 'skip to Step 2' reference and the odd '1b' numbering leave minor gaps, fitting level 4 rather than the fully-checkpointed level 5. | 4 / 5 |
Progressive Disclosure | No bundle files exist and the body references no separate files; the 18-row popular actions table and the detailed clientAction field reference are bulk content inlined in SKILL.md that could live in a reference file, fitting 'some structure but content that should be separate is inline' rather than level 4 (which expects bulk content split out) — the under-50-line exception does not apply to this ~160-line skill. | 3 / 5 |
Total | 15 / 20 Passed |