CtrlK
BlogDocsLog inGet started
Tessl Logo

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

74

Quality

70%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

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

Quality

Discovery

89%

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

This is a solid description with explicit trigger guidance and a clear 'Use when' clause, making it easy for Claude to select appropriately. Its main weakness is that the capability description is somewhat general—it could benefit from listing more specific actions beyond just 'generate mock API servers with realistic response data.' The trigger terms and distinctiveness are strong.

Suggestions

Add more specific concrete actions, e.g., 'Define endpoints with custom routes, configure HTTP status codes, generate realistic JSON/XML response payloads, simulate latency and error conditions.'

DimensionReasoningScore

Specificity

It names the domain (mock API servers) and a general action (generate mock servers with realistic response data), but doesn't list multiple specific concrete actions like defining endpoints, setting response codes, configuring latency, generating sample payloads, etc.

2 / 3

Completeness

Clearly answers both 'what' (generate mock API servers with realistic response data for testing/development) and 'when' (explicit 'Use when' clause and 'Trigger with phrases' providing concrete trigger guidance).

3 / 3

Trigger Term Quality

Includes good natural trigger terms: 'create mock API', 'generate API mock', 'setup mock server', plus contextual keywords like 'testing', 'development', and 'realistic response data'. These are phrases users would naturally say.

3 / 3

Distinctiveness Conflict Risk

The focus on mock API servers is a clear niche with distinct triggers like 'mock API', 'mock server', and 'API mock'. This is unlikely to conflict with general API development or testing skills.

3 / 3

Total

11

/

12

Passed

Implementation

50%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The skill provides a well-organized conceptual framework for mock API server generation with good structural elements (error table, output listing, examples section). However, it lacks executable code examples and concrete commands, relying instead on descriptive instructions and non-existent reference files. The workflow would benefit from validation checkpoints and the content would be stronger with at least one complete, runnable code snippet demonstrating the core mock server setup.

Suggestions

Add at least one complete, executable code example showing a minimal mock server setup (e.g., a working server.js with one mocked endpoint) to improve actionability.

Add validation checkpoints to the workflow, such as 'Verify fixtures match schema by running: npx prism mock openapi.yaml --errors' after step 2, and a server health check after step 8.

Either provide the referenced bundle files (implementation.md, errors.md, examples.md) or inline the most critical content — currently the skill defers key details to files that don't exist.

Trim the Prerequisites and Overview sections to remove information Claude already knows (e.g., what OpenAPI specs are, what Faker.js does) and focus on project-specific constraints.

DimensionReasoningScore

Conciseness

The content is reasonably structured but includes some unnecessary verbosity. The Overview section restates what Claude already understands about mock servers. The Prerequisites section lists obvious items (e.g., 'Frontend or consumer application needing API stubs'). The Examples section describes use cases at a high level rather than providing executable guidance, adding tokens without proportional value.

2 / 3

Actionability

The instructions describe what to do at a conceptual level (e.g., 'Configure the mock server to match requests by method, path pattern...') but provide no executable code, no concrete commands, and no copy-paste-ready examples. The output section lists file paths but doesn't show what the generated code should look like. The skill relies on a referenced implementation.md that doesn't exist in the bundle.

2 / 3

Workflow Clarity

The 8 steps are sequenced logically and cover the full workflow from reading specs to launching the server. However, there are no validation checkpoints — no step verifies that generated fixtures match the schema, no step confirms the server starts correctly, and no feedback loop exists for error recovery during the generation process. For a workflow involving code generation and server configuration, this is a notable gap.

2 / 3

Progressive Disclosure

The skill references three external files (implementation.md, errors.md, examples.md) which is good progressive disclosure structure, but none of these files exist in the bundle. The main SKILL.md itself is moderately long with inline error handling tables and examples that could have been deferred to the referenced files. The references are one-level deep and clearly signaled, but their absence undermines the structure.

2 / 3

Total

8

/

12

Passed

Validation

81%

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

Validation9 / 11 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

9

/

11

Passed

Repository
jeremylongshore/claude-code-plugins-plus-skills
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.