Content
61%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 a well-structured, command-driven integration guide with good connection-setup feedback loops, but it carries an unnecessary intro paragraph and lacks validation guidance and a concrete worked example for actual Keap data operations.
Suggestions
Remove or trim the introductory paragraph explaining what Keap is and the 'so you can focus on the integration logic' aside; assume Claude's competence.
Add a concrete worked Keap example with real-ish values (e.g., a `membrane action run` call that lists or creates a contact) so the common case is copy-paste ready.
Add a validation/verification checkpoint before destructive action runs or proxy writes (e.g., 'For create/update/delete actions, confirm the target record and dry-run where possible before applying').
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The bulk is lean commands and a flag table, but the opening paragraph explaining what Keap is and prose asides like 'so you can focus on the integration logic rather than auth plumbing' are unnecessary explanation Claude does not need. | 3 / 5 |
Actionability | Provides concrete, executable commands for install, login, connection, action list/run, and proxy with a flags table, but placeholders like <actionId>, CONNECTION_ID, and QUERY are unfilled and no worked Keap-specific example is shown. | 4 / 5 |
Workflow Clarity | The install-auth-connect-poll-search-run sequence is clear with strong state-based feedback loops for connection setup, but data-mutating operations (action run, proxy on CRM records) lack validation/verification steps, capping this destructive/batch context at 3. | 3 / 5 |
Progressive Disclosure | Single well-organized SKILL.md with clear section headers, a flag table, and a one-level external reference (official docs URL); no bundle files exist, and the >50-line file is not split into reference files. | 4 / 5 |
Total | 14 / 20 Passed |