Content
60%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 skill delivers highly actionable, executable CLI guidance with a clear connection workflow and validation feedback loops. Its major weakness is the massive inlined, duplicated entity catalog that bloats the token budget and should be split into a reference file.
Suggestions
Move the ~280-line entity catalog into a separate references file (e.g., references/entities.md) and replace it in SKILL.md with a one-line pointer plus a short representative sample, eliminating the duplicated 'Resource Resource ...' padding.
Clean up or remove the auto-generated 'Resource Resource Resource X' duplications entirely, as they are pure noise.
Tighten the opening paragraph ('Procore is a construction management software platform...') since Claude already knows the domain; keep only what is specific to this integration.
Enumerate the connection steps explicitly (Step 1, Step 2...) and fix the dangling 'skip to Step 2' reference so the workflow sequence is unambiguous.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is noticeably verbose due to a ~280-line auto-generated entity list (including nonsensical duplications like 'Resource Resource Resource Owner') that is heavily padded, although the surrounding CLI guidance is efficient; this fits the noticeably-verbose anchor rather than the severely-padded score-1 because real actionable content coexists. | 2 / 5 |
Actionability | Provides copy-paste-ready, fully executable commands throughout ('npm install -g @membranehq/cli@latest', 'membrane connection ensure', 'membrane action run ... --input', 'membrane request') with flags, JSON examples, and a popular-actions table covering common cases. | 5 / 5 |
Workflow Clarity | The connect→poll-until-ready→handle-clientAction→search→run→proxy sequence has explicit validation checkpoints and a state-based feedback loop, but step numbering is loose (it references a 'Step 2' that is not cleanly enumerated), placing it just below the score-5 anchor. | 4 / 5 |
Progressive Disclosure | No bundle files exist and the entire 280-line entity catalog is inlined in SKILL.md despite clearly belonging in a separate reference file; section headers provide minimal structure, matching the 'content that clearly belongs in separate files is inlined' anchor rather than a fully monolithic wall. | 2 / 5 |
Total | 13 / 20 Passed |