Content
100%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.
An exemplary API-integration skill body: dense with provider-specific facts, copy-paste-ready examples for the common booking flow, explicit sequencing with per-error-code recovery loops and pre-write confirmation, and clean one-level-deep delegation of exhaustive detail to the live docs and OpenAPI spec. No dimension shows more than a trivial weakness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Nearly every sentence carries Lexio-specific facts Claude cannot know ("Sending an offset answers `400 offset_not_allowed`", "`422 IDEMPOTENCY_KEY_REUSED`", "120 requests/min overall; writes 60/min", "Events are kept 30 days"), with no explanation of REST, curl, or auth basics — lean and dense, every token earning its place. It sits at anchor 5 rather than 4 because no over-explanation could be trimmed. | 5 / 5 |
Actionability | The bash example is copy-paste ready (key check via `GET /organization`, `GET /availability` with real query params, `POST /quotes` with body and `Idempotency-Key: $(uuidgen)`), and every workflow step names exact endpoints, fields, and headers ("`POST /rentals` with `quoteId` and the holder … plus your `partnerReference`"). Anchor 5 fits because the specific examples cover the common cases fully and the OpenAPI spec is designated the source of truth for the rest. | 5 / 5 |
Workflow Clarity | Three clearly numbered workflows each carry explicit checkpoints ("store it, then page through", "store the returned `nextCursor` (always present, even on an empty page)", "Upload inspection photos first", user confirmation plus "Prefer `?dryRun=true` first" before money-touching writes), and the idempotency section is a complete error-recovery feedback loop with per-code actions ("`409 IDEMPOTENCY_ALREADY_APPLIED` … do not resend; read the resource it points to", "Never retry blindly"). The destructive/batch validation cap does not apply because validation and confirmation steps are present. | 5 / 5 |
Progressive Disclosure | The body is a well-sectioned overview that inlines only operationally essential material and delegates exhaustive detail one level deep through clearly signaled references — "OpenAPI 3.1 spec … source of truth for paths, fields and error codes", "Full table: https://docs.lexio.rent/authentification.md", "Details:", "Walkthrough for partner keys:", "Lifecycle:" — with no nested references and easy navigation via descriptive headers. Anchor 5 fits: content is appropriately split and every reference is labeled with what it contains. | 5 / 5 |
Total | 20 / 20 Passed |