CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

mocking-apis

Generate mock API servers for testing and development with realistic response data. Use when creating mock APIs for development and testing. Trigger with phrases like "create mock API", "generate API mock", or "setup mock server".

Quality

74%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/api-development/api-mock-server/skills/mocking-apis/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%Weight 40%Scale 1-5

Reviews 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.

DimensionReasoningScore

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

Description

78%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A solid description with an explicit what/when structure and natural trigger phrases. Its main weakness is that it undersells the skill's concrete capabilities (OpenAPI-driven generation, stateful CRUD, latency/error simulation, request recording), which also slightly blurs its distinctiveness against generic testing helpers.

Suggestions

Expand the opening sentence to enumerate the concrete capabilities, e.g. "Generate mock API servers from OpenAPI specifications with realistic Faker-based response data, stateful CRUD behavior, configurable latency, and error scenarios."

Add missing natural trigger synonyms such as "stub API", "fake API", "mock endpoints", or "API stubbing for frontend development" to broaden keyword coverage.

Consider mentioning OpenAPI in the 'Use when' clause (e.g. "Use when an OpenAPI spec or API contract needs to be stubbed") to sharpen distinctiveness against general server-setup skills.

DimensionReasoningScore

Specificity

The description names the domain and a single concrete action — "Generate mock API servers ... with realistic response data" — but does not list the several specific capabilities the skill actually covers (OpenAPI-spec-driven generation, stateful CRUD, latency simulation, request recording). It fits anchor 3 (domain + 1-2 concrete actions, not comprehensive); it is not 4 because no list of several specific actions is present.

3 / 5

Completeness

It clearly answers "what" ("Generate mock API servers for testing and development with realistic response data") and explicitly answers "when" with an explicit Use-when clause plus concrete trigger phrases ("Use when creating mock APIs for development and testing. Trigger with phrases like 'create mock API', 'generate API mock', or 'setup mock server'"). This matches anchor 5; it is not 4 because the 'when' is fully explicit with concrete triggers rather than merely present.

5 / 5

Trigger Term Quality

Explicit natural trigger phrases ("create mock API", "generate API mock", "setup mock server") match what a user would actually say, but common synonyms and variations like "stub", "fake API", "mock endpoints", or "API stubbing" are missing. Good coverage with a few natural terms absent fits anchor 4; not 5 because synonym coverage is incomplete.

4 / 5

Distinctiveness Conflict Risk

"Mock API servers" with triggers like "setup mock server" is a fairly distinct niche unlikely to hijack unrelated skills. There is minor overlap risk with general testing, server-setup, or API-development skills ("setup mock server" could match broader server-setup requests), so it fits anchor 4 rather than 5; it is clearly not 3 since the mock-API focus is specific.

4 / 5

Total

16

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

jeremylongshore/tons-of-skills-marketplace

Path

plugins/api-development/api-mock-server/skills/mocking-apis/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.