ai

Design content models in Crystallize using Shapes, Pieces, Components, Topic Maps, and Grids. Create product structures, define document types, build taxonomies, organize catalogue items, design relationships between items, implement classification bridges, configure item relations with shape restrictions, and architect scalable data models. Use when modeling content, creating shapes, defining components, building taxonomies, designing relationship patterns, implementing semantic bridges, configuring product variants, or structuring catalogue hierarchies.

Generate and format catalogue items (products, documents, folders) for Crystallize PIM from sample/demo requests or user-supplied data (spreadsheets, lists, descriptions). Use when the user wants to populate a tenant with realistic items, bulk-create catalogue entries, import a spreadsheet of products, generate demo data for a shape, map raw data onto shape components, assign items to folder locations, or produce the `json:itemData` payload consumed by the Crystallize item-import grid. Also use when the user mentions sample data, seed data, demo items, mock products, populating a catalogue, importing rows, mapping columns to components, or filling a shape with variants.

Design folder hierarchies and navigation structures in Crystallize. Create category trees, organize products and content, plan URL structures, and build scalable information architectures. Use when designing storefront navigation, category pages, collection structures, content organization, mega menus, or site maps. Also use when the user mentions organizing their catalog, planning their store structure, restructuring navigation, or asks how to organize products or content in Crystallize — even if they don't explicitly say "information architecture."

Use the @crystallize/js-api-client package to interact with Crystallize APIs in JavaScript/TypeScript. Use when setting up the Crystallize API client, configuring credentials (including bearer tokens for plugins and delegated calls), calling catalogueApi/discoveryApi/pimApi/nextPimApi/meApi/shopCartApi, working with high-level helpers for catalogue fetching, cart management, orders, customers, subscriptions, navigation, or using any helper from the @crystallize/js-api-client npm package.

How to build Crystallize Plugins — vendor-hosted apps that extend the Crystallize App UI via iframes. Use when the user wants to create, register, install, or develop a Crystallize plugin: scaffolding the upstream server, generating the plugin keypair, writing the configuration schema (JSON Schema), declaring entrypoints / placements / scopes, handling the post-installation webhook, decrypting the iframe payload and Backend Token, encrypting installation secrets, or testing a plugin locally with `issuePluginPayload`. Also use when the user mentions plugins, plugin revisions, plugin store, plugin installations, plugin payload, or plugin permissions.

Design topic maps (taxonomies) for Crystallize PIM. Plan hierarchical classification systems used to tag and categorize products, documents, and media; enable faceted navigation and filtering; power search and discovery; and create cross-category collections. Use when the user wants to design a topic map, build a taxonomy, plan filters/facets for a storefront, model attributes like color/size/material/style/season, classify content (categories, difficulty, content type), organize brands/origins/certifications, design temporal tags (seasons, collections, events), or generate the `topicTree` JSON for topics. Also use when the user mentions classification, tagging, facets, filters, attribute taxonomies, or cross-cutting tags for items in Crystallize — even if they don't explicitly say "topic map" or "taxonomy".

Query Crystallize APIs for product data, content, and commerce information. Use this skill when fetching product catalogs, listing items, searching products, filtering by attributes, browsing categories, building storefronts, retrieving cart data, reading orders or customers, building admin dashboards, getting item details by path or ID, implementing faceted navigation, paginating results, or reading any data from Crystallize. Covers Core API, Discovery API, Catalogue API, and Shop API queries. Also use when the user asks about GraphQL queries against Crystallize, reading product variants, getting component data, checking stock levels, or any read operation — even if they don't explicitly say "query".

Mutate 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. Use this skill when creating or updating any content in Crystallize, adding products to the catalogue, modifying descriptions or fields, setting up checkout, placing orders, managing stock, recording payments, tracking order fulfillment, or writing data through the Core API or Shop API.

Manage user roles, permissions, and access control in Crystallize. Use when configuring field-level permissions (read-only or hidden fields for specific roles), managing user roles and team access, setting up access tokens with specific scopes, controlling who can view/edit specific content areas or component fields, designing role-based access for multi-team tenants, or planning permission strategies for content workflows.

Design and implement pricing strategies in Crystallize using Price Variants, Price Lists, Promotions, and Markets. Use when recommending pricing structures, setting up multi-currency support, configuring B2B/B2C pricing, planning promotional campaigns, defining markets, or advising on pricing architecture for commerce projects. Also use when the user asks about currencies, multi-market setup, was/now pricing, strikethrough prices, wholesale pricing, coupon codes, discount campaigns, tiered pricing, cart discounts, tax-inclusive/exclusive pricing, or any question about how prices work in Crystallize — even if they don't explicitly mention "pricing".