Content
22%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill reads more like a product marketing page and API overview than an actionable skill for Claude. It lacks a clear end-to-end workflow, omits critical details like authentication token usage across requests, and includes unnecessary promotional content (fees, incentives, best practices). The API examples provide some concrete guidance but are disconnected from a coherent operational sequence.
Suggestions
Remove promotional content (fees, incentive system, best practices) and focus on a clear sequential workflow: register → get token → authenticate → sync positions/trades, with explicit validation at each step.
Add authentication details to every API example (show the X-Claw-Token header consistently) and include error response examples with recovery guidance.
Replace the 'auto-install' pseudocode with either a real executable installation script or remove it entirely—the current example fetches a URL and prints it, which isn't actionable.
Consolidate the three installation/setup paths into one recommended approach with a complete working example from registration to first successful signal sync.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is verbose with unnecessary sections like explaining what each feature does in a bullet list, best practices that are generic advice Claude already knows, fee tables, incentive system details, and multiple installation methods including a vague 'auto-install' example that doesn't actually do anything useful. Much of this content is marketing/promotional rather than actionable instruction. | 1 / 3 |
Actionability | API endpoints are shown with concrete request/response examples, which is helpful. However, the installation 'auto-install' code is essentially pseudocode that doesn't actually install anything, the self-registration endpoint lacks response format and token retrieval details, and there's no complete workflow showing how to authenticate and then make API calls end-to-end. Key details like how to obtain and use the auth token are missing from most examples. | 2 / 3 |
Workflow Clarity | There is no clear sequenced workflow for the multi-step process of registering, authenticating, and syncing trades. The skill jumps between installation methods, registration, API reference, and best practices without a coherent sequence. No validation checkpoints exist—there's no guidance on error handling, verifying successful sync, or what to do when API calls fail. | 1 / 3 |
Progressive Disclosure | The content has some structure with headers and sections, and links to external docs/console at the end. However, there are no bundle files to offload detailed content to, and the skill includes inline content that could be separated (fee tables, incentive system, subscriber management) while lacking depth where it matters (authentication flow, error handling). | 2 / 3 |
Total | 6 / 12 Passed |