croct プラグイン
Agent skills for building with Croct: SDK integration, CLI, content modeling, CQL audiences, event tracking, personalization, and A/B testing.
croct プラグインのインストール方法
両方のコマンドを Claude Code 内で実行してください。最初のコマンドで marketplace を一度追加し、2 番目のコマンドでプラグインをインストールします。
/plugin marketplace add croct-tech/agent-skills
/plugin install croct@croct-agent-skillscroct の内容
プラグイン自身のファイルから読み込まれた 11 個のパーツ です。
コマンド 1
/croct:name として実行- /croct:croct
Lists the available Croct skills and what they help with.
SKILL 10
タスクが一致したときに Claude が読み込みます- croct-audit-website
Use when the user wants a personalization opportunity audit of a website: find conversion gaps, compare ads with the pages they land on, detect the tech stack and A/B or personalization tools, suggest audiences (segments), dynamic blocks (slots), a first strategy, and an estimated lift, then deliver a Markdown report. Afterwards, offer to turn the plan into Croct resources by generating a CLI template (`template.json5` with `create-resource` audiences, components, slots, draft experiences and experiments) and running it with `croct use`. Phrasings: "audit my website", "personalization opportunities for example.com", "where should I personalize my site?", "what should I A/B test first?", "analyze my landing pages and ads", "find conversion blockers", "set up the experience in Croct", "create the audiences and experiences from the audit".
- croct-cql
Use when writing, reading, reviewing, or debugging Croct's Contextual Query Language (CQL): audience criteria, `croct.evaluate()` / `useEvaluation` / the `Personalization` component / Next.js `cql` tag queries, Evaluation API `query` bodies (`/client/web/evaluate`, `/external/web/evaluate`), and dynamic content values (`"type": "dynamic"`, `"expression"`). Covers context variables (user, session, page, location, campaign, cart, device, browser, context, now/today), data types and conversions, accessors and selectors (`'s`, `property X of`, `[1st]`, `[*]`, `[...]`), tests (`is`, `matches`, `is like`, `contains either`, `is between`, `is defined`, `is returning`), quantifiers (`some ... satisfies`), macros, modifiers, event expressions (`user has viewed a page`, `user has abandoned a cart`, `user has completed goal`), audience estimation, and recipes. Triggers: "write an audience", "target mobile users in New York", "CQL syntax error", "audience never matches", "unavailable estimate".
- croct-integrate-platforms
Use when connecting Croct to a third-party platform or migrating to Croct from another personalization or experimentation tool. Covers Storyblok (Optimize by Croct app, @croct/plug-storyblok, Storyblok withCroct, resolveContent, croct/plug-storyblok, CroctStoriesApi), Sanity and Strapi (slot fallback, dynamic zones, metadata.contentSource), Shopify Hydrogen storefront events, Shopify custom pixel (croctPixel, PUBLIC_CROCT_SHOPIFY_PIXEL, checkout and order tracking), VTEX, Google Tag Manager data layer, Microsoft Clarity tags, HubSpot forms (hbspt.forms.create, hs-form-event), firmographic providers 6sense, Demandbase, Clearbit Reveal, and ZoomInfo WebSights (firmographics attributes, account-based audiences in CQL), and migrations from Mutiny and Ninetailed (Experience component, Contentful sunset). Triggers include cdn.croct.io/plug-integration scripts, "personalize Storyblok blocks", "track Shopify checkout", "send VTEX events", "ABM personalization", "replace Mutiny".
- croct-integrate-sdk
Use when installing or using a Croct SDK in application code: rendering slot content, evaluating CQL queries, server or client fetching, prerendering, identifying users, app ID / API key env vars, testing, or debugging. Covers JavaScript (`@croct/plug`, `croct.fetch`, `croct.evaluate`), React (`@croct/plug-react`, the `CroctProvider` component, `useContent`, the `Slot` component, `useEvaluation`, `useCroct`), Next.js (`@croct/plug-next`, `fetchContent`, `cql`, middleware/proxy, `NEXT_PUBLIC_CROCT_APP_ID`, `CROCT_API_KEY`), Vue (`@croct/plug-vue`), Nuxt (`@croct/plug-nuxt`), Shopify Hydrogen (`@croct/plug-hydrogen`), PHP (`croct/plug-php`), Laravel, Symfony, and Drupal. Triggers: slot IDs like `home-hero@1`, `SlotContent`, "Croct is not plugged in", "initial content is required for server-side rendering", "Did you forget to configure Croct's middleware?", CORS errors.
- croct-model-content
Use when designing or changing Croct content models: regular vs union components, what becomes a component, slot, structure, or primitive attribute; writing component schema JSON (`structure`, `union`, `reference`, `text`, `number`, `boolean`, `list`, `@croct/file`, `@croct/richText` rich text, `format`, `choices`, `optional`, `private`, `position`); writing content definition JSON (`static`/`dynamic` values, `nullable`, `default`, `{{placeholder}}` paths); slot default, localized, experience, experiment, or content group content; schema limit errors (30 attributes, 6 nesting levels, 10 union members, complexity score 50); component versioning and breaking changes (`home-hero@2`); refactoring (duplicate and modify, duplicate and replace, flatten and merge); Markdown in text attributes with `@croct/md-lite`. Phrasings: "model content for a hero", "add an attribute to the banner component", "support variations", "component is too complex", "localize the hero", "translations", `preferredLocale`.
- croct-personalize-and-test
Use when planning or implementing personalization or A/B testing with Croct: creating an experience (audience, slots, content, priority, scheduling, drafts), adding an experiment (A/B/n, primary goal ID, traffic allocation, variants, cross-device consistency), wiring the code it needs (slots, `croct.track('goalCompleted', {goalId})`, `orderPlaced`, `leadGenerated`, `userSignedUp`), server-side feature-flag experiments, redirect experiments, personalization recipes (UTM campaigns, ABM, search terms, location, free shipping, interests, blog readers, leads, customers, organic intent, HubSpot forms), or reading the experience, experiment, application, or workspace dashboards (probability to be best, potential loss, "Experiment in progress", "Recommended winner", "No clear winner", "Track your goal"). Phrasings: "personalize the hero for LinkedIn visitors", "A/B test this CTA", "which variant won?", "why does my experiment show no conversions?".
- croct-track-events
Use when collecting data with Croct: tracking events with `croct.track`, `useCroct().track`, or the standalone `track` from `@croct/plug/api`; choosing built-in events (`goalCompleted`, `eventOccurred`, `orderPlaced`, `productViewed`, `cartModified`, `checkoutStarted`, `leadGenerated`, `interestShown`, `postViewed`, `userSignedUp`) and knowing which are auto-tracked; writing profile or session attributes with `user.edit()` / `session.edit()` patches (`set`, `combine`, `increment`, `custom.*`); identifying users with `identify`, `anonymize`, `setToken`, `userId`, `userIdResolver`; signed user tokens, anonymity scope, sessions, identity resolution; sharing identity across subdomains with cookies; proxying `api.croct.io` via `baseEndpointUrl` because ad blockers drop requests; bot exclusion. Phrasings: "track a conversion", "tracking plan", "send purchase events", "events not showing up", "experiment says track your goal", "two sessions on login".
- croct-use-api
Use when calling Croct's HTTP APIs directly instead of an SDK: from a backend, edge function, serverless handler, script, data pipeline, or custom client. Covers the Content API (`/client/web/content`, `/external/web/content`, `static-content`), Evaluation API (`/client/web/evaluate`, `/external/web/evaluate`), Event Tracking API (`/client/web/track`), and Data Export API (`/export/events`, `/export/session`, `/export/user`, `@croct/export`, `croct-export-client`). Triggers: `api.croct.io`; headers `X-App-Id`, `X-Api-Key`, `X-Client-Id`, `X-Token`, `X-Client-Ip`, `X-Suspension-Reason`; API key permissions; signed user tokens; trusted origins and CORS errors; `nextCursor` pagination; `202 Accepted` with no body; Problem Details errors under `croct.help/api/` like `missing-client-id`, `forbidden-origin`, `unsigned-token`, `invalid-query`, `invalid-payload`; "fetch Croct content with curl", "export Croct events to a warehouse", "evaluate CQL from my server".
- croct-use-cli
Use when driving the Croct CLI (`croct`, `npx croct@latest`): setting up Croct in a project with `croct init`, adding or removing slots and components (`croct add slot`, `croct add component`, `croct remove ...`), syncing generated types and fallback content (`croct install`, `croct update`, `croct upgrade`), editing `croct.json` or its version specifiers (`"home-hero": "1 - 3"`), authenticating (`croct login`, `croct logout`, `CROCT_API_KEY`, `CROCT_TOKEN`), running the CLI non-interactively in CI (`--no-interaction`, `--cwd`), creating API keys (`croct create api-key`), opening the admin (`croct admin`), deep links (`croct://...`, `croct open`, `enable deep-link`), or writing, testing, and publishing CLI templates (`template.json5`, `croct use`, `croct create template`, template actions such as `create-resource`, `add-slot`, `download`, expressions `${options.name}`). Also when the `SlotContent` type generated for the slot `home-hero@1` or `slots.d.ts` is stale, or default content is outdated.
- croct-use-croct
Use when a task involves Croct in any way and you need orientation: what Croct is, how its concepts fit together (organization, workspace, application, component, slot, experience, audience, experiment, default and fallback content), which Croct skill to load next, or how to look up the live Croct documentation. Triggers: "Croct", croct.com, app.croct.com, docs.croct.com, `croct.json`, `npx croct`, `@croct/*` packages, `croct/plug-*` PHP packages, slot IDs like `home-hero@1`, "personalization management system", adding personalization or A/B testing to a site with Croct, or replacing Optimizely, VWO, Mutiny, or Ninetailed with Croct.
Claude Code での croct の使用方法
Claude Code セッションでコマンドを入力してください:
/croct:croctSKILL にコマンドは不要です。リクエストが説明と一致したときに Claude が読み込みます。
更新、オフ、または削除
- プラグインを更新 (shell)
- claude plugin update croct@croct-agent-skills
- marketplace を更新
- /plugin marketplace update croct-agent-skills
- 一時的にオフにする
- /plugin disable croct@croct-agent-skills
- 削除する
- /plugin uninstall croct@croct-agent-skills
croct のスキル
- croct-audit-websitecroct-tech/agent-skills
Use when the user wants a personalization opportunity audit of a website: find conversion gaps, compare ads with the pages they land on, detect the tech stack and A/B or personalization tools, suggest audiences (segments), dynamic blocks (slots), a first strategy, and an estimated lift, then deliver a Markdown report. Afterwards, offer to turn the plan into Croct resources by generating a CLI template (`template.json5` with `create-resource` audiences, components, slots, draft experiences and experiments) and running it with `croct use`. Phrasings: "audit my website", "personalization opportunities for example.com", "where should I personalize my site?", "what should I A/B test first?", "analyze my landing pages and ads", "find conversion blockers", "set up the experience in Croct", "create the audiences and experiences from the audit".
5件のファイル6スター - croct-cqlcroct-tech/agent-skills
Use when writing, reading, reviewing, or debugging Croct's Contextual Query Language (CQL): audience criteria, `croct.evaluate()` / `useEvaluation` / the `Personalization` component / Next.js `cql` tag queries, Evaluation API `query` bodies (`/client/web/evaluate`, `/external/web/evaluate`), and dynamic content values (`"type": "dynamic"`, `"expression"`). Covers context variables (user, session, page, location, campaign, cart, device, browser, context, now/today), data types and conversions, accessors and selectors (`'s`, `property X of`, `[1st]`, `[*]`, `[...]`), tests (`is`, `matches`, `is like`, `contains either`, `is between`, `is defined`, `is returning`), quantifiers (`some ... satisfies`), macros, modifiers, event expressions (`user has viewed a page`, `user has abandoned a cart`, `user has completed goal`), audience estimation, and recipes. Triggers: "write an audience", "target mobile users in New York", "CQL syntax error", "audience never matches", "unavailable estimate".
7件のファイル6スター - croct-integrate-platformscroct-tech/agent-skills
Use when connecting Croct to a third-party platform or migrating to Croct from another personalization or experimentation tool. Covers Storyblok (Optimize by Croct app, @croct/plug-storyblok, Storyblok withCroct, resolveContent, croct/plug-storyblok, CroctStoriesApi), Sanity and Strapi (slot fallback, dynamic zones, metadata.contentSource), Shopify Hydrogen storefront events, Shopify custom pixel (croctPixel, PUBLIC_CROCT_SHOPIFY_PIXEL, checkout and order tracking), VTEX, Google Tag Manager data layer, Microsoft Clarity tags, HubSpot forms (hbspt.forms.create, hs-form-event), firmographic providers 6sense, Demandbase, Clearbit Reveal, and ZoomInfo WebSights (firmographics attributes, account-based audiences in CQL), and migrations from Mutiny and Ninetailed (Experience component, Contentful sunset). Triggers include cdn.croct.io/plug-integration scripts, "personalize Storyblok blocks", "track Shopify checkout", "send VTEX events", "ABM personalization", "replace Mutiny".
7件のファイル6スター - croct-integrate-sdkcroct-tech/agent-skills
Use when installing or using a Croct SDK in application code: rendering slot content, evaluating CQL queries, server or client fetching, prerendering, identifying users, app ID / API key env vars, testing, or debugging. Covers JavaScript (`@croct/plug`, `croct.fetch`, `croct.evaluate`), React (`@croct/plug-react`, the `CroctProvider` component, `useContent`, the `Slot` component, `useEvaluation`, `useCroct`), Next.js (`@croct/plug-next`, `fetchContent`, `cql`, middleware/proxy, `NEXT_PUBLIC_CROCT_APP_ID`, `CROCT_API_KEY`), Vue (`@croct/plug-vue`), Nuxt (`@croct/plug-nuxt`), Shopify Hydrogen (`@croct/plug-hydrogen`), PHP (`croct/plug-php`), Laravel, Symfony, and Drupal. Triggers: slot IDs like `home-hero@1`, `SlotContent`, "Croct is not plugged in", "initial content is required for server-side rendering", "Did you forget to configure Croct's middleware?", CORS errors.
11件のファイル6スター - croct-model-contentcroct-tech/agent-skills
Use when designing or changing Croct content models: regular vs union components, what becomes a component, slot, structure, or primitive attribute; writing component schema JSON (`structure`, `union`, `reference`, `text`, `number`, `boolean`, `list`, `@croct/file`, `@croct/richText` rich text, `format`, `choices`, `optional`, `private`, `position`); writing content definition JSON (`static`/`dynamic` values, `nullable`, `default`, `{{placeholder}}` paths); slot default, localized, experience, experiment, or content group content; schema limit errors (30 attributes, 6 nesting levels, 10 union members, complexity score 50); component versioning and breaking changes (`home-hero@2`); refactoring (duplicate and modify, duplicate and replace, flatten and merge); Markdown in text attributes with `@croct/md-lite`. Phrasings: "model content for a hero", "add an attribute to the banner component", "support variations", "component is too complex", "localize the hero", "translations", `preferredLocale`.
4件のファイル6スター - croct-personalize-and-testcroct-tech/agent-skills
Use when planning or implementing personalization or A/B testing with Croct: creating an experience (audience, slots, content, priority, scheduling, drafts), adding an experiment (A/B/n, primary goal ID, traffic allocation, variants, cross-device consistency), wiring the code it needs (slots, `croct.track('goalCompleted', {goalId})`, `orderPlaced`, `leadGenerated`, `userSignedUp`), server-side feature-flag experiments, redirect experiments, personalization recipes (UTM campaigns, ABM, search terms, location, free shipping, interests, blog readers, leads, customers, organic intent, HubSpot forms), or reading the experience, experiment, application, or workspace dashboards (probability to be best, potential loss, "Experiment in progress", "Recommended winner", "No clear winner", "Track your goal"). Phrasings: "personalize the hero for LinkedIn visitors", "A/B test this CTA", "which variant won?", "why does my experiment show no conversions?".
6件のファイル6スター - croct-track-eventscroct-tech/agent-skills
Use when collecting data with Croct: tracking events with `croct.track`, `useCroct().track`, or the standalone `track` from `@croct/plug/api`; choosing built-in events (`goalCompleted`, `eventOccurred`, `orderPlaced`, `productViewed`, `cartModified`, `checkoutStarted`, `leadGenerated`, `interestShown`, `postViewed`, `userSignedUp`) and knowing which are auto-tracked; writing profile or session attributes with `user.edit()` / `session.edit()` patches (`set`, `combine`, `increment`, `custom.*`); identifying users with `identify`, `anonymize`, `setToken`, `userId`, `userIdResolver`; signed user tokens, anonymity scope, sessions, identity resolution; sharing identity across subdomains with cookies; proxying `api.croct.io` via `baseEndpointUrl` because ad blockers drop requests; bot exclusion. Phrasings: "track a conversion", "tracking plan", "send purchase events", "events not showing up", "experiment says track your goal", "two sessions on login".
4件のファイル6スター - croct-use-apicroct-tech/agent-skills
Use when calling Croct's HTTP APIs directly instead of an SDK: from a backend, edge function, serverless handler, script, data pipeline, or custom client. Covers the Content API (`/client/web/content`, `/external/web/content`, `static-content`), Evaluation API (`/client/web/evaluate`, `/external/web/evaluate`), Event Tracking API (`/client/web/track`), and Data Export API (`/export/events`, `/export/session`, `/export/user`, `@croct/export`, `croct-export-client`). Triggers: `api.croct.io`; headers `X-App-Id`, `X-Api-Key`, `X-Client-Id`, `X-Token`, `X-Client-Ip`, `X-Suspension-Reason`; API key permissions; signed user tokens; trusted origins and CORS errors; `nextCursor` pagination; `202 Accepted` with no body; Problem Details errors under `croct.help/api/` like `missing-client-id`, `forbidden-origin`, `unsigned-token`, `invalid-query`, `invalid-payload`; "fetch Croct content with curl", "export Croct events to a warehouse", "evaluate CQL from my server".
7件のファイル6スター - croct-use-clicroct-tech/agent-skills
Use when driving the Croct CLI (`croct`, `npx croct@latest`): setting up Croct in a project with `croct init`, adding or removing slots and components (`croct add slot`, `croct add component`, `croct remove ...`), syncing generated types and fallback content (`croct install`, `croct update`, `croct upgrade`), editing `croct.json` or its version specifiers (`"home-hero": "1 - 3"`), authenticating (`croct login`, `croct logout`, `CROCT_API_KEY`, `CROCT_TOKEN`), running the CLI non-interactively in CI (`--no-interaction`, `--cwd`), creating API keys (`croct create api-key`), opening the admin (`croct admin`), deep links (`croct://...`, `croct open`, `enable deep-link`), or writing, testing, and publishing CLI templates (`template.json5`, `croct use`, `croct create template`, template actions such as `create-resource`, `add-slot`, `download`, expressions `${options.name}`). Also when the `SlotContent` type generated for the slot `home-hero@1` or `slots.d.ts` is stale, or default content is outdated.
4件のファイル6スター - croct-use-croctcroct-tech/agent-skills
Use when a task involves Croct in any way and you need orientation: what Croct is, how its concepts fit together (organization, workspace, application, component, slot, experience, audience, experiment, default and fallback content), which Croct skill to load next, or how to look up the live Croct documentation. Triggers: "Croct", croct.com, app.croct.com, docs.croct.com, `croct.json`, `npx croct`, `@croct/*` packages, `croct/plug-*` PHP packages, slot IDs like `home-hero@1`, "personalization management system", adding personalization or A/B testing to a site with Croct, or replacing Optimizely, VWO, Mutiny, or Ninetailed with Croct.
2件のファイル6スター
croct プラグインに関する質問
croct プラグインをインストールするにはどうすればよいですか。
Claude Code で /plugin marketplace add croct-tech/agent-skills を実行し、続いて /plugin install croct@croct-agent-skills を実行します。
croct プラグインには何が含まれていますか。
croct には 1 件のコマンド, 10 件のスキル が含まれています。
croct プラグインにはどのようなコマンドが追加されますか?
/croct:croct が追加されます。Claude Code でプラグインのプレフィックスを使用して、例えば /croct:croct のように実行してください。
croct プラグインを更新または削除するにはどうすればよいですか?
shell で claude plugin update croct@croct-agent-skills を使用して更新するか、/plugin の Installed タブから行ってください。削除するには /plugin uninstall croct@croct-agent-skills を使用してください。
croct プラグインのライセンスは何ですか?
プラグインのマニフェストに記載されている MIT です。