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

marketplace-personalisation — скилл для Claude Code

Скилл marketplace-personalisation для проектирования и отладки систем рекомендаций в двусторонних маркетплейсах на AWS Personalize.

MIT 208 установок ★ 227 обновлён 2026-08-15

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

Что делает marketplace-personalisation

Это руководство из 49 правил в 9 категориях — от критических (отслеживание событий, схема данных, matching) до практических (холодный старт, выбор рецепта AWS Personalize, переранжирование). Каждое правило связано с рефлексией на документацию AWS, статьи Airbnb и DoorDash, академические работы по смещениям.

Скилл срабатывает при проектировании event-схемы, выборе рецепта (USER_PERSONALIZATION_v2, SIMS, PERSONALIZED_RANKING_v2), написании кода рангирования, обработке холодного старта для новых поставщиков или регионов, диагностике стагнирующей живой системы. Включает две методику: планирование системы с нуля и диагностику существующей.

Без конфигурации — самодостаточен. Ссылки указывают на актуальные URL AWS Personalize, труды по bias и exposure, инженерные блоги.

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

  • спроектировать схему отслеживания событий для маркетплейса без потерь истории
  • выбрать рецепт AWS Personalize и настроить холодный старт для новых поставщиков
  • обнаружить и разорвать спираль смерти: когда популярный товар забивает каталог
  • сбалансировать mutual fit между покупателем и продавцом вместо одностороннего рейтинга
  • диагностировать, почему live-система кажется несправедливой, устаревшей или непричём

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

  • Как спроектировать event-tracking для маркетплейса, чтобы не потерять данные при изменении листингов?
  • Какой рецепт AWS Personalize выбрать для двусторонних рекомендаций и как обработать холодный старт?
  • Почему в homefeed доминирует несколько поставщиков — как это обнаружить и что с этим сделать?

Как установить marketplace-personalisation

1Через Skills CLI (Vercel)

npx skills add pproenca/dot-skills --skill marketplace-personalisation -a claude-code

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

~/.claude/skills/marketplace-personalisation/SKILL.md

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

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

Вопросы о marketplace-personalisation

Как установить marketplace-personalisation в Claude Code?

Выполни npx skills add pproenca/dot-skills --skill marketplace-personalisation -a claude-code, затем открой ~/.claude/skills/marketplace-personalisation/SKILL.md.

Что делает marketplace-personalisation?

Это набор из 49 правил для проектирования и отладки систем рекомендаций в двусторонних маркетплейсах. Охватывает отслеживание событий, выбор модели AWS Personalize, контроль смещений, холодный старт и диагностику live-систем.

Когда использовать этот скилл, если я работаю над маркетплейсом?

Когда проектируешь новую систему рекомендаций, выбираешь рецепт, пишешь код рангирования, отлаживаешь холодный старт или анализируешь, почему live-система кажется несправедливой или застойной — даже если не упоминаешь AWS Personalize напрямую.

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

SKILL.md · MIT
---
name: marketplace-personalisation
description: Personalisation and recommendation systems for a two-sided trust marketplace built on AWS Personalize — event tracking, dataset and schema design, two-sided matching, cold start, feedback loops, bias control, recipe selection, serving-time re-ranking, observability, and a diagnostic playbook for existing systems. Trigger when designing, building, debugging, reviewing, or improving such a system — and even when the user does not explicitly mention "AWS Personalize" but is working on recommendations, ranking, search, homepage personalisation, or anything that matches seekers and providers across a trust-based catalog.
---
# Marketplace Engineering Two-Sided Personalisation Best Practices

Comprehensive guide for designing, building and improving personalisation and recommendation
systems in two-sided trust marketplaces on AWS Personalize. Contains 49 rules across 9
categories, ordered by cascade impact on the personalisation lifecycle, plus two playbooks
for planning a new system from scratch and diagnosing an existing one.

## When to Apply

Reference this skill when:

- Designing the event schema and tracking for a new recommender system
- Choosing an AWS Personalize recipe (USER_PERSONALIZATION_v2, SIMS, PERSONALIZED_RANKING_v2)
- Writing or reviewing candidate-generation and re-ranking code for marketplace search or homefeed
- Handling cold start for new providers, new seekers, or new catalog regions
- Diagnosing a live system that "mostly works but feels stale, unfair, or unpersonalised"
- Planning the next experiment, baseline comparison, or A/B test for the recommender
- Investigating concentration, coverage collapse, death spirals, or training-serving skew
- Adding observability dashboards, drift detection, or online metric slicing

## Setup

This skill has no user-specific configuration — it is self-contained. References are live
URLs to official AWS Personalize documentation, academic papers on bias and exposure, and
engineering blogs from Airbnb and DoorDash.

## Rule Categories

Categories are ordered by cascade impact: earlier stages poison everything downstream.

| # | Category | Prefix | Impact |
|---|----------|--------|--------|
| 1 | Event Tracking and Capture | `track-` | CRITICAL |
| 2 | Dataset and Schema Design | `schema-` | CRITICAL |
| 3 | Two-Sided Matching Patterns | `match-` | CRITICAL |
| 4 | Simple Baselines and Theory of Constraints | `simple-` | HIGH |
| 5 | Feedback Loops and Bias Control | `loop-` | HIGH |
| 6 | Cold Start and Coverage | `cold-` | HIGH |
| 7 | Recipe and Pipeline Selection | `recipe-` | MEDIUM-HIGH |
| 8 | Inference, Filters and Re-ranking | `infer-` | MEDIUM-HIGH |
| 9 | Observability and Online Metrics | `obs-` | MEDIUM-HIGH |

## Quick Reference

### 1. Event Tracking and Capture (CRITICAL)

- [`track-log-impressions-alongside-clicks`](references/track-log-impressions-alongside-clicks.md) — the denominator that turns clicks into a rate and unlocks unbiased training
- [`track-use-stable-opaque-item-ids`](references/track-use-stable-opaque-item-ids.md) — prevents history loss when listings rename or move
- [`track-stamp-events-with-request-id`](references/track-stamp-events-with-request-id.md) — the join key that enables impression-to-outcome attribution
- [`track-stream-events-via-putevents`](references/track-stream-events-via-putevents.md) — real-time adaptation versus end-of-day bulk import
- [`track-capture-negative-signals`](references/track-capture-negative-signals.md) — dismissal is information, silence is not
- [`track-measure-outcomes-not-clicks`](references/track-measure-outcomes-not-clicks.md) — reward the completed booking, not the clickbait

### 2. Dataset and Schema Design (CRITICAL)

- [`schema-design-conservatively`](references/schema-design-conservatively.md) — Interactions schemas are immutable, Users/Items are painful to change
- [`schema-keep-user-item-thin`](references/schema-keep-user-item-thin.md) — volatile fields belong in events
- [`schema-enforce-metadata-freshness`](references/schema-enforce-metadata-freshness.md) — PutItems on every metadata change
- [`schema-prefer-categorical-fields`](references/schema-prefer-categorical-fields.md) — unlock per-value features
- [`schema-weight-event-value`](references/schema-weight-event-value.md) — align the model with the business outcome
- [`schema-include-context-everywhere`](references/schema-include-context-everywhere.md) — train-serve feature parity
- [`schema-meet-minimum-dataset-sizes`](references/schema-meet-minimum-dataset-sizes.md) — 50 users / 50 items / 1000 interactions before training

### 3. Two-Sided Matching Patterns (CRITICAL)

- [`match-rank-mutual-fit`](references/match-rank-mutual-fit.md) — rank by mutual accept probability
- [`match-hard-filter-before-ranking`](references/match-hard-filter-before-ranking.md) — retrieval enforces feasibility
- [`match-cap-provider-exposure`](references/match-cap-provider-exposure.md) — diversity as a fairness constraint
- [`match-model-capacity-constraints`](references/match-model-capacity-constraints.md) — capacity-discounted scoring
- [`match-balance-supply-demand`](references/match-balance-supply-demand.md) — per-segment strategy routing

### 4. Simple Baselines and Theory of Constraints (HIGH)

- [`simple-ship-popularity-baseline`](references/simple-ship-popularity-baseline.md) — a reference point that every ML model must beat
- [`simple-find-bottleneck-first`](references/simple-find-bottleneck-first.md) — diagnostic before optimisation
- [`simple-heuristic-rerank-cold-cohorts`](references/simple-heuristic-rerank-cold-cohorts.md) — trust × recency × proximity
- [`simple-budget-complexity`](references/simple-budget-complexity.md) — ship or kill criterion before running
- [`simple-audit-before-build`](references/simple-audit-before-build.md) — telemetry audit gates model work
- [`simple-measure-gap-to-baseline`](references/simple-measure-gap-to-baseline.md) — baseline retained as permanent minority bucket

### 5. Feedback Loops and Bias Control (HIGH)

- [`loop-log-ranking-slot`](references/loop-log-ranking-slot.md) — slot data for position-bias correction
- [`loop-reserve-random-exploration`](references/loop-reserve-random-exploration.md) — unbiased training data
- [`loop-optimize-completed-outcome`](references/loop-optimize-completed-outcome.md) — reward the goal, not the proxy
- [`loop-decay-event-weights`](references/loop-decay-event-weights.md) — old preferences fade
- [`loop-detect-death-spirals`](references/loop-detect-death-spirals.md) — exposure Gini as a leading indicator

### 6. Cold Start and Coverage (HIGH)

- [`cold-use-v2-recipe-with-metadata`](references/cold-use-v2-recipe-with-metadata.md) — metadata extrapolates to new listings
- [`cold-best-of-segment-popularity`](references/cold-best-of-segment-popularity.md) — segmentation beats global top-N
- [`cold-capture-onboarding-intent`](references/cold-capture-onboarding-intent.md) — ask instead of guessing
- [`cold-reserve-exploration-slots`](references/cold-reserve-exploration-slots.md) — promotions filter for fresh inventory
- [`cold-tag-cold-start-recs`](references/cold-tag-cold-start-recs.md) — warm-versus-cold metric slicing

### 7. Recipe and Pipeline Selection (MEDIUM-HIGH)

- [`recipe-default-to-user-personalization-v2`](references/recipe-default-to-user-personalization-v2.md) — discovery default
- [`recipe-sims-for-item-page-only`](references/recipe-sims-for-item-page-only.md) — similar-items is not a homepage recipe
- [`recipe-personalized-ranking-as-reranker`](references/recipe-personalized-ranking-as-reranker.md) — not a candidate generator
- [`recipe-build-candidate-rerank-pipeline`](references/recipe-build-candidate-rerank-pipeline.md) — two layers, two concerns
- [`recipe-defer-hpo-until-baseline-measured`](references/recipe-defer-hpo-until-baseline-measured.md) — prove the model before tuning

### 8. Inference, Filters and Re-ranking (MEDIUM-HIGH)

- [`infer-use-filters-api`](references/infer-use-filters-api.md) — Personalize backfills to numResults
- [`infer-rerank-rules-after-model`](references/infer-rerank-rules-after-model.md) — preserve the model distribution
- [`infer-deduplicate-canonical-entity`](references/infer-deduplicate-canonical-entity.md) — provider-level dedup, not listing-level
- [`infer-enforce-exposure-caps`](references/infer-enforce-exposure-caps.md) — rolling fairness constraints
- [`infer-cache-responses-short-ttl`](references/infer-cache-responses-short-ttl.md) — session continuity and cost control

### 9. Observability and Online Metrics (MEDIUM-HIGH)

- [`obs-always-ab-test`](references/obs-always-ab-test.md) — before-and-after is never enough
- [`obs-track-coverage-and-gini`](references/obs-track-coverage-and-gini.md) — exposure-health signals
- [`obs-slice-metrics-by-segment`](references/obs-slice-metrics-by-segment.md) — aggregate metrics hide segment regressions
- [`obs-watch-online-offline-divergence`](references/obs-watch-online-offline-divergence.md) — proxy overfitting detector
- [`obs-alarm-on-prediction-drift`](references/obs-alarm-on-prediction-drift.md) — distribution KL-divergence as early warning

## Planning and Improving Recommendations

Two playbooks drive end-to-end workflows that compose the rules above:

- [`references/playbooks/planning.md`](references/playbooks/planning.md) — Plan a new recommender system from scratch: a nine-step workflow that starts with instrumentation and ends with the first A/B-tested ML lift over a popularity baseline.
- [`references/playbooks/improving.md`](references/playbooks/improving.md) — Diagnose and improve an existing recommender: a decision tree that identifies the current bottleneck (telemetry, freshness, coverage, feedback loop, algorithm) and routes to the specific rules that fix it.

Read the playbooks first when the task is "design a recommender" or "this recommender
is underperforming". Read the individual rules when a specific question arises during
implementation or review.

## How to Use

- Read [`references/_sections.md`](references/_sections.md) for category structure and impact ordering.
- Read individual rule files under `references/` when a specific rule matches the task at hand.
- Read [`references/playbooks/planning.md`](references/playbooks/planning.md) to design a new system.
- Read [`references/playbooks/improving.md`](references/playbooks/improving.md) to diagnose an existing system.
- Use [`assets/templates/_template.md`](assets/templates/_template.md) to author new rules as the skill grows.

## Reference Files

| File | Description |
|------|-------------|
| [references/_sections.md](references/_sections.md) | Category definitions, impact ordering, cascade rationale |
| [references/playbooks/planning.md](references/playbooks/planning.md) | Planning playbook for a new recommender |
| [references/playbooks/improving.md](references/playbooks/improving.md) | Diagnostic playbook for an existing recommender |
| [assets/templates/_template.md](assets/templates/_template.md) | Template for authoring new rules |
| [metadata.json](metadata.json) | Version, discipline, authoritative reference URLs |

© pproenca · MIT · pproenca/dot-skills

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

Все скиллы по теме «ИИ и ML» →
AWS Marketplace aws-marketplace MCP-сервер ищет решения в AWS Marketplace, показывает сведения о продуктах и помогает исследовать варианты для сравнения или рекомендации. CX Codex +1 655установок partner-marketplace-strategy Maya-Beth Finotti Скилл partner-marketplace-strategy для стратегии листинга на сторонних маркетплейсах: какие площадки выбрать, сколько вложить, какой ROI ждать и когда уходить. CX Codex +1 17 200установок marketplace официальный Vercel Labs Помогает искать и подключать интеграции Vercel Marketplace прямо в проекте. Команда проверяет связку с Vercel, подтягивает переменные окружения и настраивает нужные SDK. CX Codex GP ChatGPT +1 ★ 8 052звёзд репо aws-marketplace-metering aws Скилл aws-marketplace-metering разворачивает и отлаживает usage-based метринг AWS Marketplace: SAM-пайплайн, ResolveCustomer, BatchMeterUsage, разбор записей и ошибок. CX Codex +1 1 800установок app-marketplace-monetization-model Samuel Berthe Скилл app-marketplace-monetization-model для операторов B2B SaaS-маркетплейсов: помогает спроектировать, кто выставляет счёт покупателю, как собирается доля платформы и когда платят разработчикам. CX Codex +1 10 500установок using-marketplace-templates celigo Скилл using-marketplace-templates помогает выбрать шаблон Celigo Marketplace или Integration App и разобраться, как установить blueprint целиком либо перенести из него отдельный элемент. CX Codex +1 3 800установок

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

Весь набор →
drizzle-sqlite Скилл drizzle-sqlite помогает писать и проверять Drizzle ORM для SQLite: схемы, миграции, запросы, транзакции и типы. Подходит для рефакторинга SQLite-кода. CX Codex +1 221установок cli-review-runner Скилл cli-review-runner для Claude Code проверяет CLI-команду по 45 правилам каталога cli-for-agents и оценивает, может ли агент безопасно использовать её в пайплайне. CX Codex +1 219установок openai-codex-rust-patterns Скилл openai-codex-rust-patterns добавляет 63 инженерных правила для разработки на Rust из кодовой базы агента OpenAI Codex. Помогает писать надёжный async-код, изолировать подпроцессы и проектировать enum-ошибки. CX Codex +1 219установок marketplace-search-recsys-planning Скилл marketplace-search-recsys-planning для Claude Code помогает планировать поиск и рекомендации в маркетплейсе на OpenSearch: от структуры индекса до оценки качества. Охватывает планирование новой и разбор существующей системы. CX Codex +1 211установок human-copywrite Скилл human-copywrite применяет правила из Apple Style Guide к любому тексту, который будут читать люди: UI-строкам, документации, маркетингу, сообщениям об ошибках. Срабатывает автоматически при написании или редактировании копии. CX Codex +1 207установок marketplace-recsys-feature-engineering Скилл marketplace-recsys-feature-engineering проектирует признаки для рекомендательных систем маркетплейсов по фотографиям, анкетам и метаданным. Помогает настроить i2i, u2i и u2u рекомендации без лишних моделей. CX Codex +1 206установок computer-science-algorithms Скилл computer-science-algorithms помогает подобрать структуру данных и найти скрытые замедления O(n²) в циклах. Пригодится при проектировании графов или обработке потоковых данных. CX Codex +1 205установок marketplace-pre-member-personalisation Скилл marketplace-pre-member-personalisation для Claude Code, Cursor, Codex и других агентов покрывает путь анонимного посетителя до платного участника двустороннего маркетплейса. CX Codex +1 204установок

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

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