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
70%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/api-development/api-mock-server/skills/mocking-apis/SKILL.mdQuality
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.'
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
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 | |
3a2d27d
Table of Contents
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.