sapcc-hac-skilllisted
Install: claude install-skill eljoujat/sapcc-hac-skill
# SAP Commerce Cloud HAC Skill
Interact with a SAP Commerce Cloud (Hybris/CCv2) instance through the **Hybris Administration Console (HAC)** using [`sapcc-hac-client`](https://www.npmjs.com/package/sapcc-hac-client).
The skill automatically decides whether to use:
- **FlexibleSearch** – for data queries (SELECT/WHERE on SAP CC types)
- **Groovy script** – for complex logic, service calls, multi-step operations, or writes
Works with **Claude Code, Cursor, Copilot, Codex, Pi** and any agent compatible with the [Agent Skills](https://agentskills.io) format.
---
## Setup
Run once after installation:
```bash
cd <skill-dir> && npm install
```
Create a `.env` file in your project root (or in the skill directory as fallback):
```bash
cp <skill-dir>/.env.example .env
# Then fill in your values
```
Required `.env` variables:
```
HAC_URL=https://backoffice.<your-instance>.commerce.ondemand.com
HAC_USERNAME=admin
HAC_PASSWORD=your_password
HAC_IGNORE_SSL=false # set true for self-signed certs
HAC_TIMEOUT=30000
```
Verify setup:
```bash
node <skill-dir>/scripts/setup.js
node <skill-dir>/scripts/execute.js --health-check
```
---
## Decision Guide: FlexSearch vs Groovy
Read [references/decision-guide.md](references/decision-guide.md) for the full matrix.
**Quick rule:**
| Use FlexSearch when… | Use Groovy when… |
|---|---|
| Pure data retrieval (SELECT) | Business service calls (ProductService, OrderService…) |
| Simple WHERE conditions | Multi-step / conditional logic