sap-commerce-skill
An agent skill for SAP Commerce CloudSAP Commerce CloudSAP's commerce platform, once Hybris: a Java platform extended with extensions, ImpEx and its type system, run by SAP as SAP Commerce Cloud, with the composable storefront in front of it. The product behind the SAP Commerce door: what is entered there is the tooling that reaches into or builds on an instance, and the product itself is not an option. 2211-jdk21.1 and later: 21 reference guides, 58 code templates and three shell scripts, installed through the skills CLI.
It is written against one baseline, stated on its first line: SAP Commerce Cloud 2211-jdk21.1 or later, with JDK 21, Spring 6, Jakarta APIs and OpenAPI 3, and older releases and the JSP Accelerator covered only where marked as legacy material. The reference guides cover the platform's own machinery — the type system and items.xml, the Facade/Service/DAO layer, extension structure, ImpEx, FlexibleSearch, the OCC API, the B2C and B2B accelerators, CronJobs and the task engine, business processes, Solr, the Drools rule engine, region caches and Backoffice — with code templates beside them and three shell scripts, for scaffolding an extension, validating ImpEx and running a FlexibleSearch query through HAC. Installation is npx skills add Emenowicz/sap-commerce-skill, and the CLI configures the skill for whichever of the agents it names are installed. What it hands an agent is knowledge: apart from that one query script, nothing here reads the project or the running system.
Facts
Where it sits
Who is behind it
In the atlas: maintains 1, contributes to 1@Emenowiczmaintainer
Before choosing this
Conditions
PracticalFunctional boundary
Not for a project below the 2211-jdk21.1 baseline: older releases and the JSP Accelerator are covered only as explicitly marked legacy material, so a JSP storefront or a pre-JDK-21 platform is outside what the guides are written against. Knowledge with reach only through one script — it can tell an agent what to write and, apart from query-items.sh, cannot let it read what a given system contains.
What it declares
Every artifact
- Type
- Skill
- Origin
- Independently maintained
As a skill
- Distributed through
- npm
Connections
Packaged knowledge that teaches a coding agent a framework
SAP's commerce platform, once Hybris: a Java platform extended with extensions, ImpEx and its type system, run by SAP as SAP Commerce Cloud, with the composable storefront in front of it. The product behind the SAP Commerce door: what is entered there is the tooling that reaches into or builds on an instance, and the product itself is not an option.
Download
README
quoted from Emenowicz/sap-commerce-skill under MIT, readSAP Commerce Skill
A comprehensive AI coding agent skill targeting SAP Commerce Cloud 2211-jdk21.1 or later with JDK 21, Spring 6, Jakarta APIs, and OpenAPI 3.
Older releases and the JSP Accelerator are covered only as explicitly marked legacy material.
Works with 35+ AI coding agents including Claude Code, Cursor, Cline, GitHub Copilot, Windsurf, Codex, and more.
Installation
npx skills add Emenowicz/sap-commerce-skill
The CLI auto-detects which agents you have installed and configures the skill for all of them.
Supported Agents
Claude Code, Cursor, Cline, GitHub Copilot, Codex, Continue, Windsurf, Aider, Gemini, OpenCode, Augment, Zed, Kilo Code, Roo Code, Trae, and many more.
What's Included
Reference Documentation
- Type System - items.xml, attributes, relations, enumerations
- Service Layer - Facade/Service/DAO patterns, Spring DI
- Extension Development - Structure, configuration, Cloud vs On-Premise
- JDK 21 Migration - 2211-jdk21 baseline, Spring 6 and Jakarta migration
- ImpEx Guide - Data import/export scripting
- FlexibleSearch - Query syntax, joins, performance
- OCC API - REST endpoints, DTOs, authentication
- Accelerators - B2C/B2B customization, checkout flows
- Spring Configuration - Beans, AOP, events
- Data Modeling - Products, orders, users, pricing
- Troubleshooting - Common errors and solutions
- CronJobs & Task Engine - Scheduled jobs, triggers, task runners
- Business Processes - Order flows, return processes, workflow actions
- Solr Search - Indexed types, facets, value providers, boost rules
- Promotions & Rule Engine - Drools rules, coupons, custom actions
- Caching - Region caches, Spring cache, cluster invalidation
- Backoffice - Widget config, editors, search, wizards
Code Templates
- Complete extension boilerplate
- Service layer (Facade/Service/DAO/DTO)
- Item type definitions
- ImpEx import scripts
- FlexibleSearch queries
- OCC REST API customization
- Checkout flow extension
- CronJob implementation and configuration
- Business process definitions and actions
- Solr search setup and custom value providers
- Promotion rules and coupon setup
Utility Scripts
generate-extension.sh- Scaffold new extensionsvalidate-impex.sh- Validate ImpEx syntaxquery-items.sh- Execute FlexibleSearch via HAC
Coverage
| Aspect | Support |
|---|---|
| Deployment | Cloud (CCv2), On-Premise |
| Project Types | B2C, B2B |
| Integrations | Payment, ERP/SAP, Solr, CMS |
| Background Jobs | CronJobs, Task Engine |
| Workflows | Business Processes, Order/Return Flows |
| Search | Solr Configuration, Facets, Indexing |
| Marketing | Promotions, Coupons, Rule Engine |
| Performance | Caching, Cache Regions, Monitoring |
| Admin UI | Backoffice Configuration, Widgets |
Usage
Once installed, your agent automatically activates this skill when you:
- Ask to create SAP Commerce extensions
- Need to define item types
- Want to write ImpEx scripts
- Implement service layer components
- Customize OCC REST APIs
- Work with FlexibleSearch queries
- Extend B2C/B2B accelerators
- Create CronJobs or scheduled tasks
- Define business processes or order flows
- Configure Solr search and indexing
- Set up promotions and coupons
- Customize Backoffice admin UI
Examples
> Create a custom extension for loyalty points management
> Write ImpEx to import products with prices and stock levels
> Implement a service layer for customer wishlists
> How do I add a custom checkout step?
> Create a CronJob that exports order data nightly
> Configure Solr faceted search for product categories
Structure
sap-commerce-cloud/
├── SKILL.md # Skill definition
├── references/ # 21 detailed guides
├── assets/ # 58 code templates
└── scripts/ # 3 utility scripts
License
MIT License - see LICENSE
Contributing
Contributions welcome! Please open an issue or submit a PR.
Related
- skills.sh - Skills directory
- SAP Commerce Cloud Help
Others providing
Compare all 2 on the Agent guidance page →- sap-cx-developer-companionsap-cx-developer-companionAn agent skill for SAP Customer Experience work that routes a request to one of three jobs: finding a Commerce Cloud, Sales Cloud or Service Cloud API, writing CDS for a CX extension, or explaining an error.independent, commerceAgent skill for SAP Customer Experience APIs, CDS and errors
Details
Sources
Sources are graph entities: the same page may back several entries, and an unreachable source flags every row that rests on it.
Compatibility and provenance
History in the atlas
- Declined on scope on 2026-09-10, with no Commerce door and no Commerce capability for it to attach to, and reopened in data/curation/decisions.json once the product door opened (docs/concepts/product-doors.md, ADR-0033). Written from the repository's own README; hard rule 7: skills are indexed, never authored here.
- First seen.
For your agent
- Ref
artifact:emenowicz-sap-commerce-skill- JSON
- /artifacts/emenowicz-sap-commerce-skill.json
- MCP
- Connecting an agent