Content
92%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.
A strong, dense SDK overview: fully executable commands and code, a clearly sequenced lifecycle with validation and error-recovery checkpoints, and well-structured one-level-deep references. The only weakness is mild redundancy in the repeated CLI invocations across Examples C–F and the inlined discovery-API parameter tables.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Nearly all content is project-specific (contract addresses, CLI flags, x402/EIP-3009 protocol behavior) with little explanation of concepts Claude already knows, though Examples C–F repeat near-identical CLI blocks and the Tool Discovery parameter tables are reference-heavy — minor trim opportunities, not padding. | 4 / 5 |
Actionability | Guidance is fully executable: copy-paste-ready 'npx @opensea/tool-sdk' commands, complete TypeScript for manifest/handler/adapters/registry client/usage reporting, curl examples, a full CLI command table with flags, and per-response-code remediation actions covering the common cases. | 5 / 5 |
Workflow Clarity | Sections 1–8 are numbered to mirror the create → register → gate → call lifecycle with sub-steps (1a–1d, 2a–2b) and numbered end-to-end examples; validation exists via 'validate', '--dry-run', 'dry-run-gate', 'verify', and 'smoke', and the response-codes table provides explicit error-recovery feedback loops (re-sign on 401, retry with payment on 402, correct verb on 405). | 5 / 5 |
Progressive Disclosure | SKILL.md is a workflow overview that correctly defers gating protocol details to one-level-deep references (x402.md, predicate-gating.md, known-predicates.md — all present in the bundle), each clearly signaled with a description in section 3 and again in the References section, making navigation easy. | 5 / 5 |
Total | 19 / 20 Passed |