Production-tested patterns for composable commerce development from Aries Solutions — a commercetools Platinum partner with the most live commercetools implementations in North America.
These skills give AI coding assistants expert-level knowledge of commercetools APIs, data modeling, Merchant Center customization, and storefront development. They encode hundreds of real-world lessons into structured guidance that prevents costly mistakes.
| Skill | Description | Install |
|---|---|---|
| commercetools-api | Backend API patterns — cart/checkout, orders, payments, extensions, subscriptions, B2B, promotions, search | npx skills add ariessolutionsio/composable-skills --skill commercetools-api |
| commercetools-data | Data modeling — product types, custom types/objects, categories, import/export, migration | npx skills add ariessolutionsio/composable-skills --skill commercetools-data |
| commercetools-merchant-center | MC customization — custom applications, custom views, UI Kit, deployment | npx skills add ariessolutionsio/composable-skills --skill commercetools-merchant-center |
| commercetools-frontend | Storefront development — Next.js, React, SSR/SSG, commercetools Frontend, performance, SEO | npx skills add ariessolutionsio/composable-skills --skill commercetools-frontend |
| akeneo | Akeneo PIM development | Coming soon |
| algolia | Algolia commerce search | Coming soon |
| marketplacer | Marketplacer operator integration — GraphQL Operator API, per-seller order splits, MPay payouts, caller-shaped webhooks, Golden Product PIM sync | npx skills add ariessolutionsio/composable-skills --skill marketplacer |
| kibo-ecommerce | Kibo Commerce eCommerce — unified REST + GraphQL APIs, tenant/site/catalog hierarchy, OAuth, catalog, cart, checkout, B2B, promotions, built-in CMS, API Extensions, Events | npx skills add ariessolutionsio/composable-skills --skill kibo-ecommerce |
| kibo-oms | Kibo Order Management — fulfillment workflows, order routing, location-based inventory, BOPIS / ship-from-store, returns, standalone OMS behind external commerce platforms | npx skills add ariessolutionsio/composable-skills --skill kibo-oms |
| kibo-subscriptions | Kibo Subscription Commerce — subscription lifecycle, plans, billing cycles, dunning, modifications, cancellation and retention | npx skills add ariessolutionsio/composable-skills --skill kibo-subscriptions |
Install individual skills into your project:
# Install a single skill
npx skills add ariessolutionsio/composable-skills --skill commercetools-api
# Install multiple skills
npx skills add ariessolutionsio/composable-skills --skill commercetools-api
npx skills add ariessolutionsio/composable-skills --skill commercetools-data
npx skills add ariessolutionsio/composable-skills --skill commercetools-frontendAfter installation, your AI assistant will automatically consult the skill when working on matching tasks.
Each skill uses a hub-and-spoke architecture:
- SKILL.md (the hub) — Categorized index of patterns organized by priority level (CRITICAL > HIGH > MEDIUM > LOW). Contains trigger keywords so the AI knows when to activate, and links to reference files for detailed guidance.
- references/*.md (the spokes) — Focused reference files covering specific topics. Include correct/incorrect code pairs, checklists, pitfall warnings, and real error messages. Loaded on-demand — only what's needed for the current task.
This structure keeps context windows efficient. The AI reads the hub to understand what's available, then loads only the specific reference files relevant to the task at hand.
These skills provide judgment and patterns — when to use which approach, what goes wrong in production, and how to structure code correctly. They complement (not replace) the commercetools MCP servers:
| Need | Use |
|---|---|
| Understanding the right pattern and avoiding pitfalls | These skills |
| Searching documentation, fetching GraphQL/OAS schemas | Developer MCP |
| CRUD operations on products, carts, orders | Commerce MCP (requires auth) |
Best workflow: Use a skill to understand the right pattern → use the Developer MCP to look up exact field names and API shapes → write the code → use the Commerce MCP to test against your project.
Aries Solutions is a commercetools partner specializing in composable commerce implementations. We build, launch, and maintain commerce platforms for brands across North America.
See CONTRIBUTING.md for guidelines on adding new skills, improving existing ones, and the PR process.