К основному содержанию
скилл CX Codex

contentful-personalization — скилл для Claude Code

Скилл contentful-personalization помогает настроить, расширить и отладить персонализацию в Contentful. Он пригодится при запуске экспериментов или поиске причины, почему персонализация не работает.

MIT 311 установок ★ 41 обновлён 2026-11-13

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add contentful/skills --skill contentful-personalization -a claude-code
Открыть на GitHub

Что делает contentful-personalization

Скилл ведёт агента по структурированному процессу: для новой, общей или непонятной настройки он использует сценарий onboarding, а для ограниченной задачи — extend-existing, если интеграция уже работает. С его помощью можно разбирать персонализацию Contentful, аудитории, сегменты и варианты контента, а также проверять страницу и запросы в браузере.

Рабочий процесс выдаёт шаги и инструкции в JSON. Предпочтительный способ запуска — MCP-инструменты; если они недоступны, используется CLI scripts/run. Для CLI нужно передать сведения о среде агента и доступных инструментах, иначе взаимодействие пойдёт через общие механизмы. Это важно: без подходящих инструментов проверка браузера может опираться лишь на доступные общие сценарии.

Скилл заявлен для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. В Claude Code установите его командой npx skills add contentful/skills --skill contentful-personalization -a claude-code; файл скилла находится по пути ~/.claude/skills/contentful-personalization/SKILL.md.

Какие задачи решает

  • настроить персонализацию в новом проекте Contentful
  • расширить работающую интеграцию для отдельной задачи
  • разобраться, почему персонализация не срабатывает
  • проверить страницу и сетевые запросы при отладке
  • подготовить и запустить эксперимент с вариантами контента

Примеры запросов агенту

  • Настрой персонализацию Contentful для нового проекта и выясни, что нужно подготовить.
  • Проверь, почему персонализация на этой странице не работает, и изучи сетевые запросы.
  • Расширь работающую интеграцию Contentful, чтобы персонализировать этот компонент.

Как установить contentful-personalization

1Через Skills CLI (Vercel)

npx skills add contentful/skills --skill contentful-personalization -a claude-code

2Вручную: положить файлы

~/.claude/skills/contentful-personalization/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/contentful-personalization/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о contentful-personalization

Как установить contentful-personalization в Claude Code?

Выполните npx skills add contentful/skills --skill contentful-personalization -a claude-code. Файл скилла расположен в ~/.claude/skills/contentful-personalization/SKILL.md.

Что делает contentful-personalization?

Скилл проводит агента через настройку, расширение или отладку персонализации Contentful. Он различает запуск нового или общего внедрения и точечную работу с уже действующей интеграцией.

Как скилл выполняет проверку и отладку?

Он проходит структурированные шаги через MCP-инструменты, если они доступны. В качестве запасного варианта использует CLI scripts/run, которому передают сведения о хосте и доступных инструментах.

Исходный текст

SKILL.md · MIT
---
name: contentful-personalization
description: "Implement, extend, and debug Contentful personalization. Use onboarding for new, project-wide, or unknown setups; use extend-existing only for scoped work on an explicitly working integration. Trigger keywords: personalization, optimization, ninetailed, A/B test, experiment, multivariate test, targeting, audience targeting, segments, variants, content variants, set up personalization, implement personalization, enable personalization, personalization not working, personalization broken, personalize this component, am I ready for personalization, experience API, Contentful Experiences, Experiences SDK, Studio Experiences, personalization in Next.js, @contentful/optimization, @ninetailed/experience.js, run an experiment, check this URL, debug this live page, inspect network requests, check console errors, experience.ninetailed.co"
metadata:
  version: "2.8.9"
argument-hint: "[question or topic]"
allowed-tools: "Bash(scripts/run *) Read mcp__contentful-personalization__start mcp__contentful-personalization__advance mcp__contentful-personalization__topic mcp__contentful-personalization__topics mcp__contentful-mcp__* mcp__chrome-devtools__* mcp__plugin_*chrome-devtools*__* mcp__plugin_contentful_contentful-mcp__* mcp__plugin_contentful_contentful-personalization__*"
license: "MIT"
---

# contentful-personalization

This skill is a structured workflow driven by a compiled CLI binary. You interact with it
by calling the binary, reading its JSON output, following the instructions in the `prompt`
field, and passing your response back. **Do not show the raw JSON or Bash commands to the user.**

## How this skill works

This skill was built with skill-kit, a structured workflow engine. Each step provides
a prompt containing XML-tagged sections:

  guidelines for how to behave, not as tasks to relay to the user.
- **`<prompt>`** — Task instructions: what to do, what context to consider, what to produce.
- **`<ask-user>`** — Ask the user a question. Contains `<option>` children for structured
  choices, or `type="open"` for free-form conversation.
- **`<confirm>`** — Binary yes/no confirmation. Attributes: `default`, `destructive`.
- **`<plan>`** — Present a plan for approval. Contains `<step>` children.
- **`<checklist>`** — Create tracked work items. Contains `<item>` children with status.
- **`<subagent>`** — Delegate work to an isolated sub-agent. If `no-recurse` is set,
  the subagent must not invoke the skill named in the attribute.
- **`<rendered>`** — Pre-rendered output. Emit verbatim — no edits, no added commentary.

A step may contain one or more of these sections in sequence. Follow them in order.

The skill author composed these sections to guide your behavior. The tags and tool
mappings are generated by the SDK based on the author's intent and your host's
capabilities. A skill-level system directive may appear in the preamble — it applies

The **preamble** (sent on the first step) contains a table mapping each tag to the
specific tool available in your environment. Refer to it throughout the workflow.

## How to run this skill

### MCP mode (preferred)

If you have MCP tools for this skill (e.g., `mcp__contentful-personalization__start` and
`mcp__contentful-personalization__advance`), use them instead of the CLI:

1. Call the `start` tool (with `params` if the skill requires them).
2. Read the `preamble` field (first call only). It maps XML tags to your available tools.
3. Follow the `prompt` instructions. Produce a JSON object matching the `schema`.
4. Call the `advance` tool with the `session`, `step`, and `output`.
5. Repeat steps 3-4 until `status` is `"done"`.

If you get `status: "error"` with `retry: true`, fix your output and resubmit.
**Do not show raw JSON, session IDs, or MCP tool calls to the user.**

Skip the rest of this section — the CLI instructions below are only needed when
MCP tools are not available.

### CLI mode (fallback)

This SKILL.md file is inside the skill directory. Resolve the **absolute path** to `scripts/run`
from this file's location (e.g., `/path/to/skill/scripts/run`). Use the absolute path in all
Bash commands — do not `cd` into the skill directory.

In the examples below, `<skill>/scripts/run` is a placeholder for this absolute path.

### Detect your host

Determine which agent host you are running in, and pass it as `--host`:
- Claude Code: `--host claude-code`
- Codex: `--host codex`
- OpenCode: `--host opencode`
- Gemini CLI: `--host gemini-cli`
- Cline: `--host cline`
- Roo Code: `--host roo-code`
- Kilo Code: `--host kilo-code`
- Cursor: `--host cursor`
- Amp: `--host amp`
- Unknown/other: omit the flag (defaults to generic)

### Report your tools

Pass the tools you have available as a comma-separated `--tools` flag on the **start**
command. The session remembers them — you don't need to pass `--tools` on advance.

When `--host` is provided, `--tools` is merged with the host's known tool registry.
This means partial reporting is handled gracefully — the registry fills in any tools
you omit. If `--tools` is omitted entirely, the skill infers tools from `--host`.
If both are omitted, all interactions use generic fallbacks.

### Subagent invocations

If you are a **subagent** (spawned by another agent, not the top-level agent the user
is talking to), add `--subagent` to the start command. This tells the skill that your
reported tools are a genuine subset — the skill will not merge them with the host registry.

Without `--subagent`, the skill assumes you are a top-level agent and merges your tools
with the registry (since top-level agents often under-report their tools).

## Parameters

This skill takes no parameters. Pass `--params '{}'`.

### Step 1: Start with a session

```bash
<skill>/scripts/run --params '{}' --host claude-code --tools <your-tools> --session new 2>/dev/null
```

This returns a JSON pointer with `sessionId`, `file`, and `line`. The `line` field tells you
which line to read — it will be `2`, not `1` (line 1 is an internal header, never read it).

Read **only** line `line` from `file`. It contains the step prompt, schema, and preamble.

**Read the `preamble` first.** It contains a table mapping XML tags to the tools
available in your environment. Refer to it throughout the workflow.

### Step 2: Follow the prompt

Read the `prompt` field. It contains XML-tagged sections (described in "How this skill
interaction tags (`<ask-user>`, `<confirm>`, `<plan>`, `<checklist>`, `<subagent>`)
to execute using the tools mapped in the preamble. If a `<rendered>` block appears,
emit its content verbatim.

Produce a JSON object matching the `schema`.

### Step 3: Advance

Pass your output back with the step name:

```bash
<skill>/scripts/run advance --step <step-name> --output '<your-json>' --session abc123 2>/dev/null
```

This returns a single line number (e.g., `4`). Read **exactly and only that line** from the session file — it contains the next prompt. Do not read any other lines.

### Step 4: Repeat until done

Keep advancing until the line you read contains `"type":"done"`. The `finalOutput` field
contains the skill's result. Present it to the user.

### Important

- **Never show raw JSON output or Bash commands to the user.** The user sees your natural
  language responses, not the protocol.
- **If you get a validation error** (the response has `"error": "validation"` or `"type":"error"`),
  read the `message` field, fix your output, and retry the same step.

## Steps in this skill

- **classify**: Classify the user's request into one of the categories below.
Read only the user's message — do N...
- **gather-context**: You were not confident enough to classify the user's request.
Silently explore the project to gat...
- **pick-topic**: (dynamic)


## Sub-skills

This skill contains sub-skills that the workflow routes to automatically.
Start the skill normally — the dispatcher will determine which sub-skill to use.
Only use direct sub-skill access if the user explicitly requests a specific sub-skill by name.

Sub-skill step names are prefixed: `<subskill>/<step>` (e.g., `doctor/diagnose`).

### Direct sub-skill access

```bash
<skill>/scripts/run <subskill> --params '<json>' --session new
<skill>/scripts/run <subskill> advance --session <id>
```

### Available sub-skills

- **onboard**: Default workflow for implementing, setting up, or enabling Contentful personalization project-wide, including when the existing setup state is unknown. Explores the codebase, checks readiness, chooses SDK and architecture, installs packages, implements, and validates. Use extend-existing only for a scoped change to an explicitly working integration. — params: `readinessOnly` (boolean), `userQuery` (string)
- **live-debug**: Inspect a live URL with Chrome DevTools MCP for runtime personalization issues. Checks console problems, observes ninetailed.co requests, and reports whether the next step should be static doctor diagnosis. — params: `requestedUrl` (string)
- **doctor**: Diagnose and fix Contentful personalization issues. Runs programmatic checks first (credentials, API connectivity, content state), fixes infrastructure problems, and only then explores the codebase. — params: `userQuery` (string)
- **extend-existing**: Extend an explicitly existing, working Contentful personalization integration. Use only for scoped changes such as personalizing another component, adding an experiment, or wiring analytics into the installed SDK. Not for first-time, project-wide, or unknown-state implementation requests; use onboard for those. — params: `userQuery` (string)

## Reference topics

Quick-reference topics accessible without running the full workflow:

```bash
<skill>/scripts/run topics              # list all topics
<skill>/scripts/run topic <name>         # load a specific topic
```

- **how-personalization-works**: Core concepts: content model, rendering flow, and how personalization works
- **sdk-selection**: SDK decision framework: Optimization default vs legacy deployment maintenance
- **provider-patterns**: Provider placement patterns for Pages Router, App Router, and both SDKs
- **middleware-patterns**: Middleware and SSR/edge patterns: preflight, cookies, matcher config
- **component-patterns**: Component architecture patterns: ContentTypeMap, BlockRenderer, isolation
- **rendering-pipeline**: Rendering pipeline: Contentful client setup, include depth, component mapper
- **environment-variables**: Environment variables: names, runtime matrix, framework prefixes
- **analytics-and-preview**: Analytics plugins (Insights, GTM, Segment) and preview configuration
- **common-errors**: Common failure modes with root causes and fixes
- **ssr-guide**: SSR and edge-side personalization: patterns, anti-patterns, troubleshooting
- **sdk-legacy-guide**: @ninetailed/experience.js reference for debugging or extending existing deployments
- **sdk-next-guide**: @contentful/optimization SDK runtime chooser
- **optimization-overview**: @contentful/optimization runtime and package chooser
- **optimization-react-web**: @contentful/optimization React Web provider, hooks, entries, and routing
- **optimization-nextjs-app-router**: @contentful/optimization Next.js App Router integration
- **optimization-nextjs-pages-router**: @contentful/optimization Next.js Pages Router integration
- **optimization-web**: @contentful/optimization imperative browser and Web Components integration
- **optimization-node**: @contentful/optimization stateless Node request integration
- **optimization-react-native**: @contentful/optimization React Native integration
- **contentful-integration-guide**: Contentful CMS integration: content types, ExperienceMapper, publishing workflow
- **implementation-examples**: Real code examples: providers, BlockRenderer, Experience component patterns

© contentful · MIT · contentful/skills

Похожие скиллы

Все скиллы по теме «Маркетинг и контент» →
monitor-personalization gtmagents Команда monitor-personalization аудирует результаты экспериментов персонализации, проверяет соблюдение правил согласия и строит план действий при аномалиях. CX Codex +1 ★ 450звёзд репо sales-outreach-personalization Maya-Beth Finotti Скилл sales-outreach-personalization для Claude Code превращает сведения о потенциальном клиенте в ранжированные поводы для персонализированного аутрича. Находит основание для контакта, не выдумывая сигналы. CX Codex +1 33 800установок ecommerce-personalization nexscope-ai Скилл ecommerce-personalization для ИИ-агента, который помогает продумать персонализацию интернет-магазина: сегменты покупателей, рекомендации товаров, динамический контент и письма. CX Codex +1 1 200установок personalization-at-scale OneWave-AI Скилл personalization-at-scale для Claude Code готовит персональные первые строки для массовых обращений к потенциальным клиентам. Он изучает данные о компаниях и людях, а затем предлагает варианты с оценкой уверенности. CX Codex +1 355установок personalization-engine gtmagents Плагин personalization-engine для Claude Code объединяет навыки для деревьев решений, вариантов контента и управления персонализацией. ★ 450звёзд репо ab-testing coreyhaines31 Скилл ab-testing для Claude Code, Codex, Cursor, Copilot и Gemini CLI, который берёт на себя планирование, запуск и разбор A/B-тестов. Помогает сформулировать гипотезу, рассчитать выборку и решить, можно ли уже остановить тест. CX Codex +1 89 300установок

Из того же набора7

contentful-custom-app-from-scratch contentful-custom-app-from-scratch — скилл для Claude Code, который помогает спроектировать и собрать приложение на Contentful App Framework. Он подключается к задачам создания новой интеграции под рабочий процесс организации. CX Codex +1 3 300установок contentful-api Скилл contentful-api для Claude Code — справочник по REST API Contentful для управления контентом, доставки, превью, изображений и GraphQL; примеры даны на curl. CX Codex +1 429установок contentful-guide Скилл contentful-guide разбирает понятия Contentful и подсказывает, какой API взять под задачу. Полезен, когда проект только знакомится с headless CMS. CX Codex +1 405установок contentful-nextjs Скилл contentful-nextjs подключает Contentful к существующему проекту Next.js: SDK, переменные окружения, клиенты для продакшена и превью, Draft Mode. CX Codex +1 374установок contentful-migration Скилл contentful-migration для Claude Code и других агентов: пишет и запускает миграции контентной модели Contentful — типы контента, поля, валидации, редакторский интерфейс — кодом вместо ручной правки в веб-приложении. CX Codex +1 352установок contentful-custom-app-enhancement Скилл contentful-custom-app-enhancement для Claude Code разбирает запросы на исправление или развитие существующего приложения Contentful и вносит небольшие проверяемые изменения. Разбирает баг-репорты, отзывы и запросы на новую функцию. CX Codex +1 251установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой