CtrlK
BlogDocsLog inGet started
Tessl Logo

api-testing-observability-api-mock

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.

48

Quality

53%

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 ./skills/api-testing-observability-api-mock/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%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.

The skill is a lean, well-sectioned instruction-only skill with a sensible high-level workflow, but it stays abstract: no concrete examples, tooling, or deliverable formats, its purpose is restated three times, and its single progressive-disclosure reference points to a file that does not exist. It is serviceable as a prompt template but below the quality of the rubric's good examples.

Suggestions

Remove the redundant restatements: the opening paragraph and the Context section repeat the frontmatter description almost verbatim — collapse them into one sentence or drop them.

Add concrete grounding to Instructions, e.g. a minimal example of a route + scenario definition (JSON/YAML), a sample deterministic fixture, or named tooling options and the expected deliverable format (mock server config + README for switching scenarios).

Fix the broken reference: either create resources/implementation-playbook.md or remove the two pointers to it — currently the only progressive-disclosure path leads to a nonexistent file.

DimensionReasoningScore

Conciseness

The body is short and free of concept explanations, but the same purpose statement is repeated three times: the opening line ('You are an API mocking expert specializing in creating realistic mock services...') restates the frontmatter, and the Context section ('The user needs to create mock APIs for development, testing, or demonstration purposes. Focus on creating flexible, realistic mocks...') restates it again. This matches anchor 3 — mostly efficient but includes unnecessary repetition that could be tightened. Not a 2 because there is no explanation of known concepts or heavy padding; not a 4-5 because the triple restatement and generic Limitations boilerplate are tokens that earn no new information.

3 / 5

Actionability

The Instructions bullets name concrete artifacts to produce — routes, scenarios, state transitions, deterministic fixtures with randomness toggles, run/scenario-switch documentation — which goes beyond high-level hints (ruling out 2). But nothing is executable or specific: no example route/scenario structure, no sample fixture, no candidate tooling (e.g. WireMock, Prism, MSW, nock), and no expected deliverable format, so key details are missing — matching anchor 3, and falling short of 4's 'concrete code or commands with minor gaps'.

3 / 5

Workflow Clarity

The Instructions present a sensible ordered sequence (clarify contract and error/latency expectations → define routes, scenarios, state transitions → provide fixtures → document running and scenario switching), which exceeds anchor 2's 'rough sequence with many gaps'. However, validation checkpoints are only implicit — the sole guard is a generic 'Stop and ask for clarification if required inputs... are missing' in Limitations, with no step to verify the mock matches the contract or that scenarios behave as expected — matching anchor 3's 'sequence present but checkpoints missing or implicit'.

3 / 5

Progressive Disclosure

The body is well-sectioned and the single reference is clearly signaled with its contents ('resources/implementation-playbook.md for code samples, checklists, and templates', one level deep) — but no resources/ directory or implementation-playbook.md exists anywhere in the bundle, so the reference is a dangling pointer that breaks the disclosure path. Structure and signaling alone would support 4, but a referenced path that fails on open means navigation is only partially functional, landing at anchor 3. Not a 2 because the body itself is well-organized and nothing is over-inlined.

3 / 5

Total

12

/

20

Passed

Description

56%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.

The description names a clear niche (API mocking) with a couple of real capabilities and good natural keywords, but it is written in second-person persona voice, lacks an explicit 'Use when...' trigger clause (capping completeness), and misses common synonyms like 'stub' or 'fake API'. It sits noticeably above the vague bad examples but below the strong reference descriptions.

Suggestions

Rewrite in third person and enumerate concrete capabilities, e.g. 'Creates mock API servers with configurable routes, scenarios, and deterministic fixtures. Simulates auth flows, error shapes, and latency for testing and demos.'

Add an explicit trigger clause with natural synonyms: 'Use when the user asks to mock, stub, or fake an API, build a mock server, or simulate a partner/third-party API for frontend or integration testing.'

DimensionReasoningScore

Specificity

Actions are concrete but limited: 'Design mocks that simulate real API behavior and enable parallel development' names the domain and roughly two actions, matching anchor 3 — but the description opens with second-person voice ('You are an API mocking expert'), which the rubric penalizes by reducing specificity by 1. It is not a 1 because it does name real actions rather than pure abstraction, and not a 4 because even pre-penalty coverage was 1-2 actions, not 'several specific actions'.

2 / 5

Completeness

The 'what' is clear (design realistic mock services, simulate API behavior, enable parallel development) but there is no 'Use when...' clause or equivalent explicit trigger guidance; 'when' is only weakly implied by the contexts 'for development, testing, and demos', so completeness is capped at 3 per the judging guidelines. Not a 4 because the when-guidance is absent rather than merely under-specified; not a 2 because the what is clear, not vague.

3 / 5

Trigger Term Quality

Strong natural keywords users would say: 'API mocking', 'mock services', 'development, testing, and demos', 'simulate real API behavior' — good coverage akin to anchor 4's example. It falls short of 5 because common synonyms like 'stub', 'fake API', 'mock server', and 'sandbox' are absent.

4 / 5

Distinctiveness Conflict Risk

'API mocking' / 'mock services' is a clear niche with distinct triggers, distinct from general testing or API-client skills — matching anchor 4. Not a 5 because without explicit trigger phrases it could still fire for adjacent requests like general API testing or integration-test scaffolding.

4 / 5

Total

13

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
sickn33/agentic-awesome-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.