Crystallize Skills

Crystallize Skills are knowledge modules that give AI coding agents deep expertise on Crystallize platform concepts. Each skill is a self-contained documentation package that agents can load on-demand to understand how to work with specific parts of Crystallize.

Skills are available through both the Crystallize MCP Server (as a tool) and as a Claude Plugin (bundled directly).

Available Skills

Bookable ResourcesSell Crystallize products that are held in time rather than counted in stock — rentals, services, rooms, courses, equipment, appointments.

Content JsonGenerate Crystallize Rich Text Content JSON — the tree-based AST format used by Crystallize for structured rich text.

Content ModelDesign content models in Crystallize using Shapes, Pieces, Components, Topic Maps, and Grids.

Data CreationGenerate and format catalogue items (products, documents, folders) for Crystallize PIM from sample/demo requests or user-supplied data (spreadsheets, lists, descriptions).

Information ArchitectureDesign folder hierarchies and navigation structures in Crystallize.

JS API ClientUse the @crystallize/js-api-client package to interact with Crystallize APIs in JavaScript/TypeScript.

Mass OperationsAuthor, validate, run, and monitor Crystallize mass operation files — the JSON batch format executed by the mass-operations runner as a BulkTask.

MutationMutate data in Crystallize - create products, documents, and folders, update item components, manage product variants and SKUs, publish/unpublish items, handle customers and orders, manage carts and checkout flows, convert cart to order, create orders from checkout or directly (POS, imports), record payments, track fulfillment pipeline stages, upload images and media, import data, delete items, and perform bulk operations.

PaymentsTake payment for a Crystallize Shop API checkout with Stripe, Adyen, Klarna, Qliro, Dintero, Vipps MobilePay, Mollie, Montonio, QuickPay, Two or Razorpay: placing (locking) the cart before charging, creating the provider session from the placed cart, verifying webhooks, creating exactly one order per cart, recording payments, and capture, refund and cancellation from fulfilment pipelines.

PermissionsManage user roles, permissions, and access control in Crystallize.

PluginsHow to build Crystallize Plugins — vendor-hosted apps that extend the Crystallize App UI via iframes.

PricingDesign and implement pricing strategies in Crystallize using Price Variants, Price Lists, Promotions, and Markets.

QueryQuery Crystallize APIs for product data, content, and commerce information.

Responsive ImagesRender Crystallize images efficiently on the web — srcset, sizes, picture, format choice, lazy loading, LCP and CLS.

SubscriptionsSell and run Crystallize subscriptions — memberships, plans with trials, metered usage, standing orders and recurring baskets.

TaxonomyDesign topic maps (taxonomies) for Crystallize PIM.

Vector RankingRank and personalize the Crystallize Discovery catalogue with vectors — author vocabularies and item taste on the Core API, then rank with rankBy, context.

Each skill includes a main guide and optional reference documents with detailed API examples, design patterns, and best practices.

How Skills Work

Skills are structured as markdown files with metadata. When an AI agent needs to work with a Crystallize concept, it requests the relevant skill(s) by name and receives comprehensive documentation including:

• Main guide — core concepts, architecture decisions, and workflows
• References — detailed API documentation, code examples, and design patterns

Via the MCP Server

When using the Crystallize MCP Server, skills are exposed as a skills tool. The agent can call this tool with:

{
    "skills": ["content-model", "query"],
    "includeAllReferences": true
}

By default, the MCP Server exposes the skills tool. If you have the skills installed locally via the Claude Plugin, you can disable them on the MCP by adding ?exposeSkills=false to the MCP URL.

Via the Claude Plugin

Skills are also bundled in the Crystallize Claude Plugin. When installed as a plugin, skills are loaded directly into the agent’s context without requiring MCP server calls.

Installation

1. Install as a Claude Plugin (recommended for Claude Code)

   claude plugin add https://github.com/crystallizeapi/ai

   This gives your agent access to all skills locally, without needing the MCP server for skill lookups.

2. Or use via the MCP Server

   Skills are included in the MCP Server by default. Follow the MCP Server installation guide to set it up.

Browse All Skills

Visit the Skills Overview to browse the full content of each skill and its reference documents.