ariessolutionsio/commercetools-api
skills/commercetools-api/SKILL.md
Production-tested patterns for commercetools cart/checkout, orders, payments, B2B, promotions, extensions, and subscriptions from a Platinum partner with 50+ live implementations.
$ install --global
skillsauthnpx skillsauth add ariessolutionsio/composable-skills commercetools-apiInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 16, 2026, 5:44 AM132.2s1 file scanned
SKILL.md
- name:
- commercetools-api
- description:
- Production-tested patterns for commercetools cart/checkout, orders, payments, B2B, promotions, extensions, and subscriptions from a Platinum partner with 50+ live implementations.
commercetools API Development
Progressive loading — only load what you need:
- Setting up the SDK or client? Load
references/sdk-setup.md - Building cart or checkout? Load
references/cart-checkout.md - Working with orders? Load
references/order-management.md - Managing customers? Load
references/customer-management.md - Setting up extensions or subscriptions? Load
references/extensions-subscriptions.md - Implementing discounts? Load
references/promotions-pricing.md - Building B2B features? Load
references/b2b-patterns.md - Implementing search? Load
references/search-discovery.md - Optimizing performance? Load
references/performance.md - Code review or debugging? Load
references/anti-patterns.md
MUST load the relevant reference file before writing commercetools API code. For SDK client setup, always start with references/sdk-setup.md.
CRITICAL Priority
| Pattern | File | Impact | |---------|------|--------| | Optimistic concurrency & version handling | references/sdk-setup.md | Every update/delete fails without correct version tracking | | Cart lifecycle & freeze before payment | references/cart-checkout.md | Price changes during checkout cause order failures | | Payment flow — never reuse/delete Payments | references/cart-checkout.md | Lost audit trail, double charges, PSP inconsistencies | | Extension timeout constraints (2s / 10s) | references/extensions-subscriptions.md | Entire API call fails on timeout — affects all clients | | Discount stacking & sort order | references/promotions-pricing.md | Unexpected pricing, revenue loss, customer complaints | | Direct Discounts block Discount Codes | references/promotions-pricing.md | Codes silently stop working when Direct Discounts exist |
HIGH Priority
| Pattern | File | Impact | |---------|------|--------| | Client setup & auth flows | references/sdk-setup.md | Wrong setup causes auth failures and token leaks | | Order state machines & returns | references/order-management.md | Invalid state transitions, incomplete fulfillment | | Customer auth & email verification | references/customer-management.md | Broken sign-up/login, unverified accounts | | Subscription idempotency & ordering | references/extensions-subscriptions.md | Duplicate side effects, stale data overwrites | | Business unit hierarchies & permissions | references/b2b-patterns.md | Security gaps, broken approval workflows | | Product Search API vs Query API | references/search-discovery.md | 10-100x slower queries on large catalogs | | N+1 queries & reference expansion | references/performance.md | Cascading latency on listing pages |
MEDIUM Priority
| Pattern | File | Impact | |---------|------|--------| | Tax mode configuration | references/cart-checkout.md | Failed order creation from incomplete tax data | | Approval rules & quote lifecycle | references/b2b-patterns.md | Blocked B2B purchasing workflows | | Connect application patterns | references/extensions-subscriptions.md | Deployment failures, resource constraint issues | | Pagination & query optimization | references/performance.md | Slow page loads, unnecessary API load | | Customer groups & address management | references/customer-management.md | Wrong pricing tiers, address data issues | | Faceting & search performance | references/search-discovery.md | Slow search responses, poor relevance |
Common Anti-Patterns (Quick Reference)
| Anti-Pattern | File | Consequence | |-------------|------|-------------| | Creating a client per request | references/anti-patterns.md | Memory leaks, token exhaustion | | Not batching update actions | references/anti-patterns.md | Version conflicts under load | | Using /products instead of /product-projections | references/anti-patterns.md | 2x response payload size | | Polling instead of Subscriptions | references/anti-patterns.md | Wasted API quota, delayed detection | | Ignoring ConcurrentModification errors | references/anti-patterns.md | Silent data loss, corrupt state | | Expanding all references "just in case" | references/anti-patterns.md | Bloated responses, slow queries | | Creating empty carts for every visitor | references/anti-patterns.md | Millions of unused cart resources | | Not monitoring Subscription health | references/anti-patterns.md | Silent notification failures for 7 days |
MCP Complement
Use this skill to understand the right pattern, then use the Developer MCP to look up exact field names and schemas, and the Commerce MCP for CRUD operations.
Related Skills
ariessolutionsio/marketplacer
tools
VerifiedTrustedCommunity
Operator-side patterns for integrating Marketplacer into a composable commerce stack — GraphQL Operator API, per-seller order splits via Invoices, caller-shaped webhooks with HMAC, MPay deposit-and-reconcile payouts, Golden Product PIM sync, wholesale orders, additional charges, and Catalog Rules. Use when implementing or maintaining a Marketplacer marketplace behind any commerce platform (commercetools, Kibo, Scayle, etc.), any search engine, any PIM, OMS, or ERP. Triggers on Marketplacer, marketplace, multi-vendor, multi-seller, Advert, Seller, Invoice, Golden Product, MPay, Airwallex, Hyperwallet, Xero, RefundRequest, RemittanceAdvice, Remittance, Taxon, Prototype, Catalog Rule, marketplace commission, marketplace fees, marketplace operator, marketplace webhooks, paymentReferences. Consult this skill before writing code that talks to a Marketplacer instance, defines a Marketplacer webhook, or maps Marketplacer data into another system.
1SKILL.mdUpdated May 15, 2026
ariessolutionsio/kibo-subscriptions
tools
VerifiedTrustedCommunity
Use for Kibo Subscription Commerce work — implementing recurring billing, configuring plans (evergreen, fixed-term, subscribe-and-save), managing subscriptions (pause, skip, swap, cancel), setting up dunning / retry for failed payments, handling cycles and continuity orders, building customer self-service portals, and understanding the Subscription-to-Order relationship. Triggers on Kibo Subscription, Kibo Subscription Commerce, subscriptionCreate, subscriptionUpdate, subscription cycle, subscription pause / skip / swap, subscription dunning, recurring billing Kibo, evergreen subscription, fixed-term subscription, subscribe and save, continuity order, payment recycling, subscription churn, subscription retention. Invoke for any Kibo Subscription question — API integration, implementation, configuration, debugging, or projecting subscription state into reporting/ERP.
1SKILL.mdUpdated May 15, 2026
ariessolutionsio/kibo-oms
development
VerifiedTrustedCommunity
Use for Kibo Order Management (OMS) implementation — design order routing strategies (DC-to-store fallback, location-based), implement fulfillment workflows (BOPIS, curbside pickup, ship-from-store), build RMA and returns processing, integrate inventory APIs with WMS (Refresh vs Adjust semantics), set up standalone-OMS behind Shopify / SFCC / custom storefronts, or import orders from external platforms. Triggers on Kibo OMS, Kibo Order Management, Kibo fulfillment, order routing, BOPIS, ship-from-store, fulfiller, fulfillment task, RMA, Kibo returns, Kibo inventory location, Kibo dropship, Kibo carrier, agentic order routing, standalone OMS. Covers routing rules, allocation logic, carrier integration, location capabilities, and the OMS-behind-non-Kibo-storefront pattern.
1SKILL.mdUpdated May 15, 2026
ariessolutionsio/kibo-ecommerce
tools
VerifiedTrustedCommunity
Build, debug, and integrate Kibo Commerce eCommerce features — implement checkout/cart/catalog flows, troubleshoot cart and promotion issues, develop B2B portals, write API Extensions (Arc.js), configure Event Subscriptions, or connect to external PIMs/OMS/search. Covers OAuth, `x-vol-tenant`/`x-vol-site`/`x-vol-master-catalog` headers, tenant/site/catalog hierarchy, `@kibocommerce/rest-sdk`, REST vs GraphQL selection. Triggers on Kibo, Kibo Commerce, KiboCommerce, KiboSoftware, x-vol-tenant, x-vol-site, MasterCatalog, Kibo cart/checkout/catalog/storefront/B2B/promotions, API Extensions, Arc.js, Event Subscription, @kibocommerce/rest-sdk. Use whenever working with Kibo's commerce platform — implementing new features, debugging existing code, or integrating external systems.
1SKILL.mdUpdated May 15, 2026