Content
61%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 well-organized, token-efficient overview with a clear instruction sequence and properly signaled one-level references. The main gaps are the total absence of executable code or a quick-start command in the body, no verification step in the workflow, and two reference files whose content is misaligned with the mock-server topic they are cited for.
Suggestions
Add a minimal quick-start snippet to the body (e.g. `npx @stoplight/prism-cli mock openapi.yaml --port 4010`) so the primary path is executable without opening a reference file.
Insert an explicit validation step in the Instructions, e.g. after generating fixtures: verify each fixture validates against its OpenAPI response schema and smoke-test one endpoint per method before wiring error scenarios.
Rewrite references/implementation.md and references/errors.md to actually cover mock-server implementation and mock-server error patterns (the current content describes production API development), so the cited links deliver the promised guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and assumes Claude's competence — no padding, no explaining what OpenAPI or Faker is; instructions carry concrete specifics ("50-500ms per endpoint", "400, 401, 404, 429, or 500") and the error table is compact. Minor instances could be trimmed (the Prerequisites list mixes requirements with context like "Frontend ... needing API stubs"), so it fits anchor 4 rather than the fully lean anchor 5. | 4 / 5 |
Actionability | The body gives specific guidance (tools to use, latency ranges, status codes, exact output file layout) but contains no executable code or commands at all — even a one-line quick start like `npx @stoplight/prism-cli mock openapi.yaml` lives only in references/examples.md. Worse, the deferred "full implementation guide" (references/implementation.md) actually describes building a production API (ORM models, rate limiting, load testing) rather than mock servers, so key execution details are effectively missing. This fits anchor 3 (some concrete guidance but incomplete); it is not 4 because no executable command or code sample appears in the body. | 3 / 5 |
Workflow Clarity | Steps 1-8 form a clear, logical sequence (read spec → generate fixtures → configure matching → stateful CRUD → latency → error scenarios → recording → startup script), but no validation checkpoint exists in the workflow — there is no step to verify generated fixtures conform to the OpenAPI schema or to smoke-test the running server; fixture-vs-schema checking appears only reactively in the error-handling table. That matches anchor 3 (steps listed, checkpoints missing or implicit); it is not 4 because a verify step is wholly absent rather than a minor gap. | 3 / 5 |
Progressive Disclosure | Good structure: a ~65-line overview with three clearly signaled, one-level-deep markdown-linked references (implementation.md, errors.md, examples.md), all of which exist, with bulk detail appropriately pushed out of SKILL.md. It falls short of anchor 5 because two of the three referenced files (implementation.md, errors.md) drift from the mock-server topic — they cover production API development and real API error handling — so the "See ... for the full implementation guide" navigation does not deliver matching content. | 4 / 5 |
Total | 14 / 20 Passed |