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

Content Model

Design content structures using Shapes, Pieces, Components, Topic Maps, and Grids.

Information Architecture

Design folder hierarchies, catalogue trees, and navigation structures.

JS API Client

Use @crystallize/js-api-client to interact with Crystallize APIs in JavaScript/TypeScript.

Query

Query data using the Core API, Discovery API, Catalogue API, and Shop API.

Mutation

Create and modify data — items, orders, customers, carts, and checkout flows.

Pricing

Design pricing strategies with Price Variants, Price Lists, Markets, and Promotions.

Permissions

Manage user roles, field-level permissions, and access control.

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.