You are an API mocking expert specializing in realistic mock services for development, testing, and demos. Design mocks that simulate real API behavior and enable parallel development.
56
Quality
37%
Does it follow best practices?
Impact
86%
1.19xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/api-testing-observability-api-mock/SKILL.mdQuality
Discovery
32%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description establishes the API mocking domain but relies on vague language ('realistic mock services', 'enable parallel development') rather than concrete actions. It critically lacks explicit trigger guidance ('Use when...') which makes it difficult for Claude to know when to select this skill. The description also uses second-person framing ('You are') which violates the third-person voice requirement.
Suggestions
Add an explicit 'Use when...' clause with trigger terms like 'mock API', 'stub endpoints', 'fake backend', 'API simulation for testing'
Replace vague language with specific actions: 'Create mock endpoints, generate realistic response data, simulate error conditions and latency, configure stateful mock behaviors'
Rewrite in third person voice: 'Designs and implements API mocks...' instead of 'You are an API mocking expert...'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (API mocking) and mentions some actions ('Design mocks that simulate real API behavior'), but lacks concrete specific actions like 'create mock endpoints', 'generate response schemas', or 'configure latency simulation'. | 2 / 3 |
Completeness | Describes what it does (design API mocks) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per rubric guidelines, missing explicit trigger guidance caps this at 2, but the 'what' is also weak, warranting a 1. | 1 / 3 |
Trigger Term Quality | Includes relevant terms like 'API mocking', 'mock services', 'development', 'testing', 'demos', but misses common variations users might say like 'stub', 'fake API', 'mock server', 'API simulation', or 'test doubles'. | 2 / 3 |
Distinctiveness Conflict Risk | The API mocking focus provides some distinctiveness, but 'development, testing, and demos' is broad enough to potentially overlap with general testing skills, API development skills, or demo preparation skills. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
42%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides a reasonable high-level framework for API mocking but lacks the concrete, executable guidance that would make it immediately actionable. The progressive disclosure to external resources is well-structured, but the main content relies too heavily on abstract instructions without code examples, specific commands, or validation steps.
Suggestions
Add at least one concrete, executable code example showing a basic mock server setup (e.g., using Express, MSW, or similar)
Include a specific example of a mock route definition with request/response shapes
Add validation checkpoints to the workflow, such as 'Verify mock responds correctly: curl localhost:3000/api/test'
Remove or condense the 'Context' section as it restates information already in the description
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably efficient but includes some unnecessary sections like 'Context' that restates the obvious, and the 'Use this skill when' section explains scenarios Claude could infer from the skill description. | 2 / 3 |
Actionability | The skill provides only vague guidance like 'Clarify the API contract' and 'Define mock routes' without any concrete code examples, commands, or executable snippets. It describes what to do rather than showing how to do it. | 1 / 3 |
Workflow Clarity | Instructions are listed as bullet points suggesting a sequence, but there are no explicit validation checkpoints, no feedback loops for error recovery, and the steps are abstract rather than concrete actions with verification. | 2 / 3 |
Progressive Disclosure | The skill appropriately keeps the overview concise and references a separate implementation playbook for detailed code samples and templates, with clear one-level-deep navigation. | 3 / 3 |
Total | 8 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
9c177eb
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.