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 skill is highly actionable with concrete CLI commands and a well-structured connection-readiness workflow including validation checkpoints. Its main weakness is conciseness — a marketing-style intro paragraph and some redundant explanation could be trimmed without losing clarity.
Suggestions
Cut the opening marketing paragraph about OnePageCRM's sales philosophy and the 'so you can focus on integration logic rather than auth plumbing' aside; keep only what Claude needs to operate the CLI.
Fix the broken step references: replace 'skip to Step 2' with a concrete heading and add a '1a' before '1b. Wait for the connection to be ready' (or renumber).
Merge the 'Searching for actions' and 'Popular actions' sections, which both demonstrate `action list --intent=QUERY`, to remove the duplicated command block.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly executable commands, but the opening OnePageCRM marketing paragraph ('emphasizes a single next action… Sales teams and individual salespeople use it to manage leads, track deals, and ensure consistent follow-up'), the 'so you can focus on the integration logic rather than auth plumbing' line, and the duplicated 'action list --intent=QUERY' block are unnecessary explanations Claude does not need. | 3 / 5 |
Actionability | Provides copy-paste-ready bash commands for install, login, connection ensure, action search, action run with JSON input, and proxy requests, plus a complete flags table covering the common cases. | 5 / 5 |
Workflow Clarity | A clear install→authenticate→connect→poll-until-ready→search→run sequence with a genuine feedback loop (polling READY/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR states and re-polling after user action), held below 5 by the dangling 'skip to Step 2' reference and a '1b' heading with no '1a'. | 4 / 5 |
Progressive Disclosure | No bundle files exist, so all content lives in a single file organized into clear sections (Overview, Working with OnePageCRM, Install, Authentication, Connecting, Searching, Proxy, Best practices); minor redundancy between 'Searching for actions' and 'Popular actions' and the >50-line length keep it at 4 rather than 5. | 4 / 5 |
Total | 16 / 20 Passed |