Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -95,6 +95,7 @@ If you only want the skills, disable the `contentstack` MCP server in your tool'
| `dx-delivery-sdk` | Delivery SDK | Developer Experience | Production-ready TypeScript with `@contentstack/delivery-sdk` for entries, assets, references, filters, sorting, pagination, locales, Live Preview, and Visual Builder. |
| `dx-kickstart-next` | Contentstack Kickstart Next | Developer Experience | Maintaining Contentstack's Next.js kickstart: App Router structure, Delivery SDK setup, Live Preview, seeded stack alignment, env vars, validation, and PR reviews. |
| `dx-mcp-server` | Contentstack MCP | Developer Experience | Connecting AI agents with the local `@contentstack/mcp` server or the hosted MCP Profile Hub: choosing, client setup, auth, tool groups and profiles, and least-privilege safety. |
| `dx-sap-spartacus-import` | SAP Spartacus Content Import | Developer Experience | Importing an SAP Commerce Cloud (Spartacus) storefront's CMS content over OCC into Contentstack for the Spartacus connector: dry run, two approval gates, idempotent seed and publish, round-trip verify, extra locales, and the SAP Commerce Cloud app's product picker for carousels. |
| `dx-migrate-js-to-ts-sdk` | Migrate JS to TS SDK | Developer Experience | Migration from the JavaScript Contentstack SDK to the TypeScript Delivery SDK, including API mapping, rewrites, and unsupported pattern callouts. |
| `launch-platform` | Launch Platform | Launch | Hosting on Launch: frameworks and builds, Cloud and Edge Functions, launch.json routing, caching and revalidation, deploy hooks, domains, access control, log targets, monorepos, and limits. |
| `launch-sync-environment-variables-from-env-example` | Sync Launch environment variables from .env.example | Launch | Comparing a local `.env.example` with Launch environment variables and adding missing keys with a full-object update, without printing secrets. |
Expand Down
2 changes: 1 addition & 1 deletion docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ Every skill is written once in the open [Agent Skills](https://agentskills.io) f

| | |
| ------------------------ | -------------------------------------------------------------------------------------------------------------- |
| **Skills included** | 33 (see the [skill reference](skills/index.md)) |
| **Skills included** | 34 (see the [skill reference](skills/index.md)) |
| **Products covered** | CMS, Assets, Developer Experience, Studio, Launch, Brand Kit, Developer Hub, Marketplace, Personalize, Lytics, Automate |
| **Supported tools** | Claude Code, claude.ai / Cowork, Cursor, Codex, GitHub Copilot, Gemini CLI, `skills` CLI |
| **Source of truth** | `skills/<slug>/SKILL.md` |
Expand Down
37 changes: 37 additions & 0 deletions docs/skills/dx-sap-spartacus-import.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
---
title: SAP Spartacus Content Import
description: Import an SAP Commerce Cloud storefront's CMS content over OCC into Contentstack, shaped for the Contentstack Spartacus connector.
---

# SAP Spartacus Content Import

**Slug:** `dx-sap-spartacus-import` · **Product:** Developer Experience · **Type:** Action (gated) · **Ships references & scripts**

Takes the content an SAP Commerce Cloud (Spartacus / composable storefront) site serves over OCC and recreates it in a Contentstack stack, in the model `@contentstack/contentstack-spartacus-connector` reads. Pages, slots, banners, paragraphs, carousels, links, navigation, logo, footer and images come across. Products, prices, search, cart and checkout stay with SAP, following the connector's hybrid model.

## When it triggers

When a developer has added the connector to a Spartacus app (`ng add @contentstack/contentstack-spartacus-connector`) and wants the existing SAP storefront content in Contentstack. Also for seeding a demo stack from an SAP electronics or powertools site, re-running an import to update entries, or adding locales such as de-de, ja-jp and zh-cn.

## What it covers

- **Dry run first**: extracts the site and prints what would be written, without touching the stack.
- **Two approval gates**: unknown component types need a mapping decision, and nothing is written until the user approves the summary.
- **Starter-pack check**: the run stops if the plan needs a content type or field the installed connector doesn't ship.
- **Idempotent seed and publish**: entries upsert by their SAP uid, so re-runs update in place.
- **Verification**: a round-trip comparison against SAP and a Delivery API read of the home page.
- **Localization**: localized content and images per language from SAP's own localized responses.
- **SAP product picker**: optionally installs and configures the SAP Commerce Cloud marketplace app, so editors pick carousel products from SAP instead of typing SKUs. The agent checks the picker, repairs it at most twice, then lets the user fall back to the plain SKU list.
- **Your own login**: writes with a management token, or with the user's `csdx auth:login --oauth` session (required for the marketplace app).

## Example prompts

- "I just added the Spartacus connector. Import our SAP electronics storefront into my new stack."
- "Seed a demo stack from powertools-spa with German and Japanese."
- "Re-run the SAP import; we changed the homepage banners."
- "The import says a component type is unknown. What do I do?"
- "Let our editors pick the carousel products from SAP instead of typing SKUs."

## References

Ships `references/pipeline.md` (stages, gates, flags, run directory, exit codes), `references/mapping-profile.md` (how SAP templates, slots and typeCodes map to connector content types) and `references/sap-commerce-app.md` (the marketplace app stage and its verify, repair and fallback steps). The Python scripts in `scripts/` use only the standard library; the csdx login and the marketplace app step use Node.js and the Contentstack CLI. Built by Vaishnavi Kedar as the Spartacus content-modelling agent.
3 changes: 2 additions & 1 deletion docs/skills/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ description: The full catalog of Contentstack Agent Skills, grouped by product.

# Skills reference

The bundle includes 33 skills across ten Contentstack products. Each links to a dedicated page with what it does, when it triggers, example prompts, and its safety notes.
The bundle includes 34 skills across ten Contentstack products. Each links to a dedicated page with what it does, when it triggers, example prompts, and its safety notes.

> Each skill page mirrors its canonical `skills/<slug>/SKILL.md`. The slug is the skill's identifier: use it with the [`skills` CLI](../get-started/skills-cli.md).

Expand Down Expand Up @@ -37,6 +37,7 @@ The bundle includes 33 skills across ten Contentstack products. Each links to a
| [Contentstack MCP](dx-mcp-server.md) | `dx-mcp-server` | Local MCP server vs hosted MCP Profile Hub, client setup, auth, tool scoping, safety. |
| [Delivery SDK](dx-delivery-sdk.md) | `dx-delivery-sdk` | Production-ready TypeScript with `@contentstack/delivery-sdk` for entries, assets, queries, Live Preview. |
| [Contentstack Kickstart Next](dx-kickstart-next.md) | `dx-kickstart-next` | Maintaining the Next.js kickstart: App Router, Delivery SDK setup, Live Preview, seed alignment, env vars, validation. |
| [SAP Spartacus Content Import](dx-sap-spartacus-import.md) | `dx-sap-spartacus-import` | Importing an SAP Commerce Cloud storefront's content into Contentstack for the Spartacus connector. |
| [Migrate JS→TS SDK](dx-migrate-js-to-ts-sdk.md) | `dx-migrate-js-to-ts-sdk` | Migrating Delivery SDK code from the JavaScript SDK to the TypeScript SDK. |
| [Live Preview & Visual Editor Support](cms-live-preview-visual-editor-support-assistant.md) | `cms-live-preview-visual-editor-support-assistant` | Setting up or debugging Live Preview, Visual Editor (Visual Builder) or Timeline across CSR, SSR, SSG, BFF. |
| [Migration Companion](migration-companion.md) | `migration-companion` | Guided Contentful → Contentstack migration: content and application code. |
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
type: tool_used
tool: Skill
input_match: '"skill"\s*:\s*"(?:[\w-]+:)?dx-sap-spartacus-import"'
min: 1
---
The agent loads the `dx-sap-spartacus-import` skill.
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
type: tool_used
tool: Skill
input_match: '"skill"\s*:\s*"(?:[\w-]+:)?migration-companion"'
min: 0
max: 0
---
The agent doesn't load `migration-companion`, which covers Contentful migrations.
7 changes: 7 additions & 0 deletions evals/routing-dx-sap-spartacus-import-1/prompt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: routing-dx-sap-spartacus-import-1
tags: [routing, dx-sap-spartacus-import]
max_turns: 3
timeout_seconds: 180
---
I just ran ng add for the Contentstack Spartacus connector. Import the content from our SAP Commerce electronics storefront into my new stack.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
type: tool_used
tool: Skill
input_match: '"skill"\s*:\s*"(?:[\w-]+:)?dx-sap-spartacus-import"'
min: 1
---
The agent loads the `dx-sap-spartacus-import` skill.
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
type: tool_used
tool: Skill
input_match: '"skill"\s*:\s*"(?:[\w-]+:)?migration-companion"'
min: 0
max: 0
---
The agent doesn't load `migration-companion`, which covers Contentful migrations.
7 changes: 7 additions & 0 deletions evals/routing-dx-sap-spartacus-import-2/prompt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: routing-dx-sap-spartacus-import-2
tags: [routing, dx-sap-spartacus-import]
max_turns: 3
timeout_seconds: 180
---
Seed a Contentstack demo stack from our SAP composable storefront's OCC content, with German and Japanese as well.
Loading
Loading