integration-builder

Scaffold marketplace integration provider packages with adapters, credentials, and tests.

Updated Mar 17, 2026
One-click install
npx skills add https://github.com/comerito/om-hackathon-starter --skill integration-builder-comerito
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: integration-builder
Source: https://github.com/comerito/om-hackathon-starter/tree/main/.ai/skills/integration-builder
Command: npx skills add https://github.com/comerito/om-hackathon-starter --skill integration-builder-comerito

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Open Mercato integration development is boilerplate-heavy and error-prone. The Integration Builder standardizes scaffolding to accelerate delivery and ensure marketplace contracts are followed.

Core Features & Use Cases

  • Scaffolds npm workspace packages under packages/<provider> with consistent structure.
  • Generates adapter, credentials schema, widget injection, webhook processing, health checks, i18n, and tests.
  • Use Case: create a new Stripe-style payment gateway, a DHL carrier integration, or a SendGrid-like email provider quickly.

Quick Start

Run the project generator to scaffold a new provider package and register it with the marketplace.

Frequently Asked Questions about integration-builder

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

FAQPage Schema
How do I scaffold a new Open Mercato provider integration package?

Scaffolding a provider integration requires running the project generator to create a consistent npm workspace package under packages/<provider>. The generator outputs a ready-to-register marketplace integration package with adapters, credentials, and dependency injection wiring.

What is the best way to add a new external payment or shipping service to a marketplace?

Adding a new external service like a payment or shipping provider requires scaffolding a provider package that implements adapters, credentials schemas, and webhook processing. The Integration Builder standardizes this scaffolding to ensure the new service adheres to marketplace contracts and patterns.

Can I use the Integration Builder for webhook processing and health checks?

Yes, the Integration Builder generates webhook processing and health check components alongside adapters, credentials schemas, and i18n files. These components are scaffolded to align with marketplace contracts and reference patterns, ensuring the integration is fully formed and testable.

Does the scaffolding process include internationalization and test generation?

Yes, scaffolding includes internationalization (i18n) and test scaffolds alongside adapters and widget injection. The generated package mirrors the gateway-stripe reference patterns, providing a fully-formed integration provider package with all necessary metadata and testing frameworks pre-configured.

What marketplace contract patterns should a provider integration follow?

A provider integration should follow the documented integration contract and mirror the gateway-stripe reference patterns. This ensures the scaffolded package includes correct metadata, dependency injection wiring, and health checks, resulting in a ready-to-register marketplace integration that meets compliance requirements.

Why does creating a marketplace integration from scratch lead to boilerplate errors?

Creating a marketplace integration from scratch is boilerplate-heavy and error-prone because it requires manually wiring adapters, credentials, and webhooks. The Integration Builder standardizes scaffolding to eliminate these manual errors and ensure marketplace contracts are followed consistently across provider packages.