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 body is a strong, actionable CLI reference with a well-sequenced connection workflow and explicit state-based validation, weakened mainly by an unnecessary RPA intro paragraph and the absence of any file-level progressive disclosure. It scores high on actionability and workflow clarity, modestly on conciseness.
Suggestions
Delete or trim the opening "Robocorp is a platform for developing and deploying software robots..." paragraph; Claude already knows what RPA is.
Move the detailed clientAction object schema and the proxy flag table into a references/ file, leaving a brief inline summary with a link, to improve progressive disclosure and reduce token load.
Relabel the connection steps explicitly (Step 1, Step 2) so the "skip to Step 2" references resolve to visible anchors.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Most of the body is lean CLI reference, but the opening paragraph explains what Robocorp/RPA is ("Robocorp is a platform for developing and deploying software robots...") — a concept Claude already knows — plus a few prose restatements, fitting the "mostly efficient with some unnecessary explanation" anchor. | 3 / 5 |
Actionability | The body provides copy-paste-ready, executable commands covering the full flow (npm install, membrane login with headless variant, connection ensure, action list/run with --input JSON, request proxy with a full flag table), matching the fully-executable anchor. | 5 / 5 |
Workflow Clarity | The connect-and-use flow is well sequenced with explicit validation checkpoints (poll --wait for state, branch on READY/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR, re-poll after user action), but step labeling is loose ("skip to Step 2" without a labeled Step 2 anchor), a minor gap below a 5. | 4 / 5 |
Progressive Disclosure | No bundle files exist and the skill is a single ~140-line file, but it is well organized into clear sections (Overview, Install, Authentication, Connecting, Searching, Running actions, Proxy, Best practices); inline reference material like the clientAction schema and proxy flag table is reasonably placed, leaving only minor organization gaps. | 4 / 5 |
Total | 16 / 20 Passed |