AI agents
Learn how to set up Claude Code, Cursor, and Codex to build with Croct.
Our agent skills give your coding agent working knowledge of Croct, from installing the SDK and rendering slots to writing audiences, setting up experiments, and auditing your website for personalization opportunities. They follow the open Agent Skills format, so they work with any agent that supports it.
Available skills
Each skill covers one area of Croct. The examples below show the kind of requests that make the agent load each skill. In Claude Code, you can also run /croct to list them.
Audit a website
The croct-audit-website skill audits a website for personalization opportunities. It crawls your pages, detects your tech stack, compares your ads with the pages they land on, and writes a Markdown report with suggested audiences, slots, a first strategy, and an estimated lift. Afterwards, it can create the audiences, components, slots, and draft experiences in your workspace with a CLI template. Nothing is published without your review.
- “Audit example.com for personalization opportunities.”
- “What should I A/B test first on my website?”
- “Compare my ads with the pages they land on.”
- “Create the audiences and experiences from the audit in Croct.”
The audit works best when your agent has a browser tool, such as Claude in Chrome or the Playwright MCP server. Without one, it reads only the page HTML, so it can’t take screenshots or read ad libraries.
Get explanations
The croct-use-croct skill explains what Croct is, how its concepts fit together, and which skill to use next. It also teaches the agent to read the live documentation.
- “What is the difference between a slot and a component in Croct?”
- “How do I replace Optimizely with Croct?”
Use the CLI
The croct-use-cli skill drives the Croct CLI to set up projects, add slots and components, keep generated types and fallback content in sync, and write templates.
- “Set up Croct in this project.”
- “Add the home-hero slot to this project.”
- “My slot types are out of date. Update them.”
Integrate an SDK
The croct-integrate-sdk skill installs and uses the JavaScript, React, Next.js, Vue, Nuxt, Hydrogen, PHP, Laravel, Symfony, and Drupal SDKs to render slots, evaluate queries, and identify users.
- “Render the home-hero slot in this Next.js page.”
- “Show a different banner to returning visitors using useEvaluation.”
- “Why do I get the error ‘Croct is not plugged in’?”
Model content
The croct-model-content skill designs components and slots, writes schema and content definitions, and handles versioning and localization.
- “Model the content for a hero with a title, subtitle, and CTA.”
- “Add an optional image to the banner component.”
- “Localize the hero into Spanish and Portuguese.”
Write CQL
The croct-cql skill writes and debugs CQL for audiences, queries, and dynamic content.
- “Create an audience for returning visitors from New York on mobile.”
- “Target users who viewed the pricing page twice this week.”
- “Why does my audience never match?”
Track events
The croct-track-events skill tracks events and goals, writes user and session attributes, and handles identity and first-party routing.
- “Track a goal when someone submits the demo form.”
- “Identify users when they log in.”
- “Events are not showing up. Can you check?”
Personalize and test
The croct-personalize-and-test skill plans experiences and experiments, wires the code they need, and helps you read the results.
- “Personalize the hero for visitors coming from LinkedIn ads.”
- “A/B test this CTA against a shorter version.”
- “Which variant won my experiment?”
Use the API
The croct-use-api skill calls the content, evaluation, event tracking, and data export HTTP APIs from a backend, script, or data pipeline.
- “Fetch the home-hero content from my server with curl.”
- “Evaluate a CQL query from this edge function.”
- “Export Croct events to our data warehouse.”
Integrate platforms
The croct-integrate-platforms skill connects Croct to CMSs, ecommerce platforms, tag managers, CRMs, and firmographics providers, and migrates from other personalization tools.
- “Personalize Storyblok blocks with Croct.”
- “Track Shopify checkouts and orders.”
- “Build account-based audiences with 6sense data.”
- “Replace Mutiny with Croct.”
Install the skills
Pick your agent below, run the command, and you are ready to go.
Claude Code
In a Claude Code session, add our marketplace and install the plugin:
/plugin marketplace add croct-tech/agent-skills/plugin install croct@croct-agent-skillsThen run /reload-plugins to activate it without restarting.
Cursor
From the root of your project, run:
npx skills add croct-tech/agent-skills --agent cursorTo make the skills available in every project, add the --global flag.
Codex
Add our marketplace:
codex plugin marketplace add croct-tech/agent-skillsThen open the plugin directory, select the Croct Agent Skills marketplace, install Croct, and restart Codex.
Other agents
For GitHub Copilot, Windsurf, Gemini CLI, and other agents, run the following command from the root of your project:
npx skills add croct-tech/agent-skillsThe command detects the agents you use and asks which ones to install the skills for.
Try it out
To check that everything is set up, ask your agent “Which Croct skills do you have access to?”. From there, describe what you want in plain language, for example:
- “Add Croct to this project and render a personalized hero slot.”
- “Create an audience for returning visitors from New York on mobile.”
- “Why is my slot showing the fallback content?”
The agent loads the right skill on its own, so you do not need to name it.
Keep the skills up to date
The skills evolve with the documentation. To get the latest version, run /plugin marketplace update croct-agent-skills in Claude Code, or the following command for the other agents:
npx skills updateUse the docs with any tool
For tools that do not support skills, point them to our documentation, which is available in a format built for language models:
- llms.txt lists every page with a short description.
- Adding .md to any page URL returns the page as markdown.