Composable Commerce Skills
Production-tested skills for composable commerce development with commercetools.
Composable Commerce Skills
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 Catalog
| 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 |
Installation
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-frontend
After installation, your AI assistant will automatically consult the skill when working on matching tasks.
How Skills Work
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.
Complements the commercetools MCP
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.
About Aries Solutions
Aries Solutions is a commercetools partner specializing in composable commerce implementations. We build, launch, and maintain commerce platforms for brands across North America.
Contributing
See CONTRIBUTING.md for guidelines on adding new skills, improving existing ones, and the PR process.