Readme of croct-tech/croct

Introduction

Croct is a headless CMS that helps you manage content, run A/B tests, and personalize experiences without the hassle of complex integrations.

This repository packages Agent Skills that give your AI coding agent working knowledge of Croct, so it can integrate the SDKs, drive the Croct CLI, model content, write CQL audiences, track events, and plan personalization and experiments without guessing. Every skill is derived from the official documentation at docs.croct.com.

Quick start

Pick your agent and run one command:

Agent	Install
Any Agent Skills-compatible agent	`npx skills add croct-tech/agent-skills`
Claude Code	`/plugin marketplace add croct-tech/agent-skills/plugin install croct@croct-agent-skills`
Codex	`codex plugin marketplace add croct-tech/agent-skills`

Then ask your agent in plain language. The right skill loads automatically:

Add Croct to this Next.js app 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?

To check the installation, ask: "Which Croct skills do you have access to?"

Claude Code

Add the marketplace and install the plugin:

/plugin marketplace add croct-tech/agent-skills
/plugin install croct@croct-agent-skills

Run /reload-plugins to activate it without restarting. The plugin also adds a /croct command that lists the available skills.

Codex

Add the marketplace:

codex plugin marketplace add croct-tech/agent-skills

Then open the plugin directory, select the Croct Agent Skills marketplace, install Croct, and restart Codex.

Cursor, GitHub Copilot, and other agents

Install with the skills CLI, which detects your agent:

npx skills add croct-tech/agent-skills

Manual installation

Copy the folders under skills/ into your agent's skills directory, for example .claude/skills/ for a single project or ~/.claude/skills/ for every project. You need to update them yourself.

Skills

Skill	Use it to
`croct-use-croct`	Get oriented: concepts, which skill to load, how to read the live docs
`croct-use-cli`	Run `croct init`, add slots and components, generate types and fallback content, configure `croct.json`, write templates
`croct-integrate-sdk`	Render slots, evaluate queries, and identify users with the JavaScript, React, Next.js, Vue, Nuxt, Hydrogen, PHP, Laravel, Symfony, and Drupal SDKs
`croct-model-content`	Design components and slots, write schema and content definition JSON, handle versioning
`croct-cql`	Write and debug Contextual Query Language (CQL) for audiences and evaluation
`croct-track-events`	Track events and goals, manage user and session attributes, identity, and first-party routing
`croct-personalize-and-test`	Plan experiences and experiments, feature flags, redirect tests, playbooks, and read analytics
`croct-use-api`	Call the content, evaluation, event tracking, and data export HTTP APIs
`croct-integrate-platforms`	Connect Storyblok, Sanity, Strapi, Shopify, VTEX, GTM, Clarity, HubSpot, and firmographics providers, or migrate from Mutiny and Ninetailed

How the skills stay accurate

Each reference file lists the documentation pages it came from. When a skill does not cover something, it tells the agent to read the live docs, which are available as markdown:

Index: https://docs.croct.com/llms.txt
Any page: append .md to its URL
Search: https://docs.croct.com/api/search.md?term=<terms>

Documentation

Visit our official documentation.

Support

Join our official Slack channel to get help from the Croct team and other developers.

Contribution

Contributions are always welcome!

Report any bugs or issues on the issue tracker.
For major changes, please open an issue first to discuss what you would like to change.
Read AGENTS.md for the authoring rules, then run npm install && npm run validate before opening a pull request.

License

These skills are licensed under the MIT license.