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.

56

1.19x

Quality

37%

Does it follow best practices?

Impact

86%

1.19x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/antigravity-api-testing-observability-api-mock/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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

DimensionReasoningScore

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

DimensionReasoningScore

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
boisenoise/skills-collections
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.