WHEN YOUR AGENT SHOULD USE IT
USE FOR
- List the sites and pages available in the current XM Cloud instance.
- Run GraphQL queries or mutations against XM Cloud's content authoring API.
- Import or export content between XM Cloud environments.
- Search XM Cloud content items from inside a marketplace app.
- Invoke an XM Cloud agent from a custom marketplace app.
Documents
This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.
Add XM Cloud API Integration
You are helping the user add XM Cloud API integration to their Sitecore Marketplace app.
Prerequisites
The XMC package must be installed. If not:
npx shadcn@latest add https://marketplace-sdk.sitecorecloud.io/r/xmc.jsonStep 1: Determine Which API
Ask the user (or infer from $ARGUMENTS) which XMC API they need:
| API | Namespace | Use For |
|---|---|---|
| Sites | xmc.sites.* | List/get sites, current site context |
| Pages | xmc.pages.* | List/get pages, current page context |
| Authoring | xmc.authoring.* | GraphQL queries/mutations against authoring API |
| Content Transfer | xmc.contentTransfer.* | Import/export content |
| Search | xmc.search.* | Search content items |
| Agent | xmc.agent.* | Invoke XM Cloud agents |
Step 2: Choose Client-Side or Server-Side
- Client-side: Use
client.query()/client.mutate()— simpler, works in any architecture - Server-side: Use
experimental_createXMCClient()— requires Auth0 (full-stack architecture)
Step 3: Implement
See xmc-patterns.md for complete code patterns for each API.
Step 4: Suggest Related Skills
- Use
/marketplace-build-componentto build UI for the data - Use
/marketplace-sdk-referencefor detailed type information
Reference Files
- XMC Patterns — Code patterns for each XMC API
Installation
Install this skill from vercel-labs/sitecore-skills on GitHub, not from a copy somewhere else. The command below does this for you.
npx skills add vercel-labs/sitecore-skills --skill "marketplace-add-xmc" --full-depthRun this in your project — your agent picks the skill up automatically.
BEFORE IT WILL WORK
1 FOR THE AGENT- 01
Install the XM Cloud SDK package for the app
