api-mock-server

Generate HTTP and gRPC mock servers and clients from pinky-promise API specs.

10|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/superluminar-io/pinky-promise --skill api-mock-server-superluminar-io
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-mock-server
Source: https://github.com/superluminar-io/pinky-promise/tree/main/skills/api-mock-server
Command: npx skills add https://github.com/superluminar-io/pinky-promise --skill api-mock-server-superluminar-io

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically generate mock servers and mock clients from pinky-promise API specs to enable contract testing without implementing real services, reducing coordination overhead and speeding up integration validation.

Core Features & Use Cases

  • Generate a mock server to emulate a provider during consumer testing
  • Generate a mock client to validate producer behavior against a spec
  • Support for both HTTP (Prism) and gRPC (Go stubs) mocks from a single spec source

Quick Start

Run the skill to generate mocks from your pinky-promise spec.

Frequently Asked Questions about api-mock-server

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a mock server from an API spec for contract testing?

You can generate a mock server from a pinky-promise API spec to enable contract testing without implementing real services. The skill reads specs from a registry or local draft-spec.json and outputs ready-to-run mock servers.

Can I create both HTTP and gRPC mocks from a single API spec source?

Yes, you can generate both HTTP and gRPC mocks from a single pinky-promise spec. The skill supports Prism HTTP mocks and Go gRPC stubs to validate API contracts across producer and consumer workflows.

How do I test a producer's API behavior against a consumer contract?

You can generate a mock client from your pinky-promise API spec to validate producer behavior against the defined contract. This allows integration validation without coordinating with live consumer services.

Does the mock server generation work with local API spec files?

Yes, the mock server generation works with local API spec files by reading a local draft-spec.json. It also supports reading pinky-promise specs directly from the registry for broader workflow integration.

What is the best way to reduce coordination overhead when validating API integration?

The best way to reduce coordination overhead is auto-generating mock servers and clients from pinky-promise specs. This enables contract testing across producer and consumer workflows without implementing real services.