integration-builder

Scaffold npm workspace packages for Open Mercato integration providers.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/TomekNocon/open-logistico --skill integration-builder-tomeknocon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: integration-builder
Source: https://github.com/TomekNocon/open-logistico/tree/main/packages/create-app/agentic/shared/ai/skills/integration-builder
Command: npx skills add https://github.com/TomekNocon/open-logistico --skill integration-builder-tomeknocon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates scaffolding and integration provider package setup for the Open Mercato Marketplace.

Core Features & Use Cases

  • Scaffolds an npm workspace package for a new external integration provider.
  • Implements adapter skeletons, credentials handling, widget injection, webhook processing, and health checks.
  • Generates i18n resources and tests, aligning with marketplace conventions and patterns.
  • Triggers on common integration events like build integration, create integration, add provider, and new connector.

Quick Start

Run the integration-builder to scaffold a new provider integration package.

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 external integration provider package for the Open Mercato Marketplace?

The integration-builder scaffolds the npm workspace package and wires adapter skeletons, credentials handling, and health checks following marketplace conventions. It triggers automatically on common integration events like build integration or add provider to generate the complete provider package.

Can I add webhook processing and front-end widget injection when creating a new marketplace integration?

Yes, webhook processing and front-end widget injection are included when creating a new marketplace integration. The scaffolding implements webhook handling, generates i18n resources and tests, and injects front-end widgets aligned with marketplace patterns for the new external provider.

What types of external integrations does the marketplace scaffolding support?

The marketplace scaffolding supports creating new external integrations for payments, shipping, data sync, channels, storage, and webhooks. It sets up the necessary adapters, credentials, widgets, and tests for each integration type following established marketplace patterns.

How do I set up adapter skeletons and health-check wiring for a new integration connector?

Setting up adapter skeletons and health-check wiring for a new integration connector is handled automatically during package scaffolding. The process implements the adapter structure, configures credentials handling, and applies health-check wiring alongside generated i18n resources and tests.

Does the scaffolding handle i18n resources and tests for integration provider packages?

Yes, the scaffolding handles i18n resources and tests for integration provider packages. It generates internationalization resources and test files aligned with marketplace conventions, ensuring the new external integration is fully wired for localization and validation.

Why do I need npm workspace setup for building external integrations on the marketplace?

Npm workspace setup is needed for building external integrations because it structures the provider package within the marketplace ecosystem. This scaffolding approach ensures adapters, credentials, widgets, and tests follow the correct workspace patterns for seamless integration registration and operation.