Content
38%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 operational section (CLI install, authentication, connection lifecycle, action search/run, proxy fallback) is concrete and mostly executable, but it is buried under ~1300 lines of a padded, repetitive app catalog largely unrelated to 0codekit's utilities, plus an obvious generation artifact ('I don't have enough information to do that.'). The connection workflow is the strongest part, yet it points to a nonexistent 'Step 2' and offers no validation guidance for action results. This skill needs its catalog removed or extracted and its workflow steps numbered and verified.
Suggestions
Move the ~1300-line app catalog out of SKILL.md into a separate reference file — or delete it entirely, since it is a generic app listing unrelated to 0codekit's utilities — keeping SKILL.md to the ~150-line operational guide.
Delete the stray artifact line 'I don't have enough information to do that. Can you tell me more about the app?' and the duplicated catalog entries.
Fix the dangling 'Step 2' references (no such heading exists), number the workflow steps, and add one worked end-to-end example (e.g. find and run 'convert-csv-to-json' with a real --input payload) including how to handle a failed action run.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Roughly 1300 of the 1445 body lines are a repetitive bullet catalog of hundreds of unrelated apps and file types, each ending in '**Columns**' with many duplicated entries (e.g. 'Trello Board', 'Jira Project', 'Monday Board' each appear twice), plus the stray artifact line 'I don't have enough information to do that. Can you tell me more about the app?'. This is anchor 1 ('Severely verbose; heavily padded') — the catalog is content Claude neither needs nor would use for 0codekit tasks. | 1 / 5 |
Actionability | The operational section gives concrete, executable commands: 'npm install -g @membranehq/cli@latest', 'membrane connection ensure "https://www.0codekit.com/" --json', and 'membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json', plus a proxy flag table. Not 5 because the Popular actions table lists every description as 'No description', the text references a 'Step 2' heading that does not exist, and there is no worked end-to-end example of a real action. | 4 / 5 |
Workflow Clarity | A sequence is present (install → login → connection ensure → poll → search actions → run → proxy fallback) with good state branching ('CLIENT_ACTION_REQUIRED — the user or agent needs to do something... poll again', 'CONFIGURATION_ERROR or SETUP_FAILED — check the error field'). However, the referenced 'Step 2' target is undefined, the main run-an-action step has no error-handling or output validation guidance, and steps are unnumbered — anchor 3 ('sequence present but checkpoints missing or implicit') fits better than 4. | 3 / 5 |
Progressive Disclosure | The giant app catalog ('- **Slack Workspace** / **Channels** / **Messages** / **Columns**' and ~300 similar blocks) is inlined monolithically in SKILL.md with no section headers and no links to separate files, and the bundle contains no references/, scripts/, or assets/ directories at all. This is anchor 2 ('content that clearly belongs in separate files is inlined'); not 1 because the ~145-line operational section does have usable header structure, not 3 because the overwhelming bulk of the file is an undifferentiated inline dump. | 2 / 5 |
Total | 10 / 20 Passed |