mocking-apis_skill

Overview

This skill generates mock API servers for development and testing, producing realistic response data and scaffolded code. It helps define endpoints, request/response schemas, authentication stubs, and test hooks so teams can iterate without a full backend. Use it to quickly stand up repeatable mock environments that mirror planned production APIs.

How this skill works

The skill inspects your API design inputs or existing specifications and builds resource models, routes, controllers, and middleware scaffolding. It produces OpenAPI 3.0 specs, sample payloads, validation rules, and optional database/ORM stubs. It can emit framework-specific boilerplate (FastAPI, Flask, Express, Fastify) plus integration test templates and error-handling patterns.

When to use it

• Developing frontend features before backend implementation is available
• Creating integration tests that require predictable API behavior
• Prototyping API designs and validating contract assumptions
• Simulating third-party services during CI or local development
• Training or demo environments that need realistic but disposable data

Best practices

• Provide a clear API spec or example payloads to guide mock generation
• Choose a framework matching your tech stack to reduce integration friction
• Use realistic but non-sensitive sample data and configurable seeds
• Include authentication and error-case scenarios in mocks for robust testing
• Keep OpenAPI documentation synced with generated mocks and update tests accordingly

Example use cases

• Create mock API for a new frontend app to develop UI components in parallel
• Generate endpoint stubs to validate API contract between microservices
• Set up CI job that spins up a mock server with deterministic responses for end-to-end tests
• Produce demo data and endpoints for product demos without exposing production systems
• Rapidly prototype alternative API designs and compare integration effort