Content
81%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 highly actionable with executable commands, a well-sequenced connection workflow including polling/validation checkpoints, and clean section organization. The chief weakness is conciseness: the intro paragraph, an auth-plumbing aside, and a rambling agent-types note add tokens Claude doesn't need.
Suggestions
Trim the opening Rapyd overview paragraph and the "so you can focus on the integration logic rather than auth plumbing" aside to assumed knowledge.
Rewrite the agent-types line into a concise list (e.g. "claude, openclaw, codex, warp, windsurf") and fix the stray colon/wording.
Consider moving the entity list and/or proxy flag table into a references/ file and linking from the overview to push the skill toward one-level-deep progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with concrete commands throughout, but includes some unnecessary padding — the opening paragraph on what Rapyd is, "so you can focus on the integration logic rather than auth plumbing", and a slightly rambling/typo-ridden agent-types note — fitting the mostly-efficient-but-could-be-tightened anchor. | 3 / 5 |
Actionability | Provides fully executable, copy-paste-ready bash commands for every stage (install, login, connection ensure/get with --wait, action list/run, request) plus a concrete flag table for proxying, covering the common cases. | 5 / 5 |
Workflow Clarity | Clear install -> auth -> connect -> wait -> search -> run sequence with explicit validation checkpoints and a feedback loop (poll while BUILDING, branch on CLIENT_ACTION_REQUIRED, re-poll after the user acts), matching the explicit-validation anchor. | 5 / 5 |
Progressive Disclosure | Well-organized into clear single-level sections with no nested file references, but it is a monolithic ~155-line SKILL.md with no bundle files, so structure is good rather than the ideal clear-overview-pointing-to-one-level-deep-references arrangement. | 4 / 5 |
Total | 17 / 20 Passed |