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

revenuecat-testing — скилл для Claude Code

Скилл revenuecat-testing помогает составить план тестирования встроенных покупок и подписок в RevenueCat, проверить события в песочнице и разобрать сбои.

MIT ★ 674 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add evanca/flutter-ai-rules
/plugin install flutter-ai-skills@flutter-ai-rules
Открыть на GitHub

Что делает revenuecat-testing

Скилл выстраивает сквозное тестирование RevenueCat вокруг проверяемых сигналов: событий панели управления (INITIAL_PURCHASE, TRANSFER, PRODUCT_CHANGE), значений period_type и логов отладки. Вместо проверки «приложение не падает» агент проверяет конкретные состояния в истории пользователя.

Инструкция покрывает шесть направлений: жизненный цикл подписок (триалы, апгрейды, отмены), идентификацию аккаунтов, матрицу восстановления и переноса покупок, пейволлы, веб-биллинг и проверку динамических предложений перед запуском экспериментов.

В iOS песочнице оформить возврат нельзя из-за ограничений App Store, поэтому событие отмены там приходится ждать до суток или проверять сценарии через Google Play.

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

  • составить пошаговый план QA для встроенных покупок и подписок
  • проверить корректность переноса покупок между учётными записями
  • найти причину ошибки Invalid Product Identifiers в логах
  • подготовить пейволлы к проведению экспериментов

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

  • Составь план тестирования подписок и триалов в RevenueCat для Flutter-приложения
  • Пользователь восстановил покупку под новым ID, но подписка не перенеслась: разбери логи
  • Проверь, готова ли конфигурация пейволла к запуску эксперимента в RevenueCat

Как установить revenuecat-testing

1Через маркетплейс плагинов

/plugin marketplace add evanca/flutter-ai-rules
/plugin install flutter-ai-skills@flutter-ai-rules

Команда ставит плагин flutter-ai-skills целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add evanca/flutter-ai-rules --skill revenuecat-testing -a claude-code

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

~/.claude/skills/revenuecat-testing/SKILL.md

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

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

Вопросы о revenuecat-testing

Как установить revenuecat-testing в Claude Code?

Для установки через маркетплейс выполните /plugin marketplace add evanca/flutter-ai-rules, а затем /plugin install flutter-ai-skills@flutter-ai-rules.

Что делает скилл revenuecat-testing?

Он формирует матрицу сценариев для проверки подписок, помогает настроить песочницу и разобрать ошибки при восстановлении покупок по событиям RevenueCat.

Можно ли протестировать возвраты подписок в песочнице iOS?

В sandbox iOS нельзя оформить возврат средств напрямую: App Store отправляет запросы через поддержку Apple, а событие отмены может приходить с задержкой до 24 часов.

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

SKILL.md · MIT
---
name: revenuecat-testing
description: "Use when testing RevenueCat purchases/subscriptions, setting up sandbox testing, debugging a purchase/restore/trial, verifying entitlements or events, checking an app is ready for a RevenueCat experiment, or writing an IAP QA plan."
license: MIT
---

# RevenueCat Testing

Help a developer systematically verify their RevenueCat integration works before shipping — turning "I added RevenueCat, does it actually work?" into a concrete, checkable QA plan. The full use-case matrix, methods, platform differences, and the verifiable signal for each case live in `references/use_cases.md`. Read it for exact event names and preconditions; this file is the operating guide.

**The organizing principle:** every RevenueCat behavior has a **verifiable signal** — a specific dashboard event (`INITIAL_PURCHASE`, `TRANSFER`, `EXPIRATION`, `PRODUCT_CHANGE`, `CANCELLATION`), a `period_type` value, or a CustomerInfo/debug-log state. A test isn't "did the app not crash"; it's "did the expected event appear in the customer's history with the right fields." Always tie a test to its signal, or it isn't really testing anything.

## How to use this skill

1. **Get the setup facts**: platform(s) (iOS / Android / cross-platform / web billing), SDK (native, RN, Flutter, etc.), whether they've enabled debug logs and sandbox accounts yet, and what specifically they're trying to verify or why they think something is broken.
2. **Establish prerequisites first** — most "purchases don't work" reports are config problems visible before any purchase:
   - Debug logs on *before* `configure()` (iOS `Purchases.logLevel = .debug`; Android `setLogLevel(LogLevel.DEBUG)`), and check for **"Invalid Product Identifiers"** and error-level logs. Fix those before touching purchase flows.
   - Sandbox environment set up; multiple sandbox test IDs ready if any account-switching is in scope.
   - Point them at the debug overlay (`debugRevenueCatOverlay()` / `DebugRevenueCatBottomSheet`) to preview offerings and run test purchases quickly.
3. **Map their goal to use cases** from the reference and produce the plan (below).

**Reference implementation (especially for Flutter):** RevenueCat ships an official **Purchase Tester** sample app at `github.com/RevenueCat/purchases-flutter/tree/main/revenuecat_examples/purchase_tester`. It's a runnable app exercising the flows this skill tests — dedicated screens for product change (`product_change_testing_screen.dart`), paywalls and paywall-footer, customer center, virtual currency, winback offers, and custom paywall-impression testing — plus an end-to-end integration test at `integration_test/app_test.dart`. Point Flutter users there to (a) run a known-good build to isolate whether a bug is in their code vs. their store/RevenueCat config, and (b) model their own `integration_test` widget tests on `app_test.dart`. For non-Flutter SDKs, RevenueCat has equivalent Purchase Tester apps in each SDK repo.

## The six testing domains

Pull the specific rows from `references/use_cases.md`; here's the shape so you know what to cover:

1. **Subscription lifecycle** — purchase, free trial/intro offer (`period_type` = `TRIAL`/`INTRO`), renewal, upgrade/downgrade (`PRODUCT_CHANGE`), cancellation, expiration, refund. **Platform gotcha to always flag:** iOS sandbox refunds are not possible — the App Store routes users to Apple support and the `CANCELLATION`/`CUSTOMER_SUPPORT` event can take ~24h; Google Play refunds are dashboard-driven.
2. **Configuration** — anonymous vs identified App User IDs (verify via debug log + CustomerInfo), offering display, and login/logout — where the key risk is **unintended data merging** between accounts.
3. **Restoring flow** — the account-switching/transfer matrix. This is the highest-value, most-bug-prone area: `syncPurchases()`, restore-to-new-ID, the three-ID conflict case (transfer succeeds for the empty ID, errors for the one that already owns the sub), and transfer-disabled behavior. The signal throughout is whether a `TRANSFER` event fires (or correctly does *not*).
4. **Paywalls** — display & purchase, localization (device/store-account country → language + localized price), and intro-offer eligibility display for fresh users.
5. **RevenueCat Billing (web)** — purchase, trial auto-conversion, expiration.
6. **Before an experiment** — the app must render the SDK's *current* offering (or the placement's current offering), never a hard-coded one, or customers don't split evenly between variants; and the installed SDK must meet the feature-gate minimum for anything the experiment relies on. Setting up and running the experiment itself is the RevenueCat AI Toolkit's `revenuecat-experiments` skill.

## Deliverables

- **QA test plan** — a checklist of the use cases relevant to their app (skip web billing if they're mobile-only, skip trials if they have none, add the pre-experiment checks when an experiment is planned), each row as: *action → expected event/signal → where to see it*. This is the primary output; make it copy-pasteable into a QA doc or issue tracker.
- **Debugging a specific failure** — diagnose against the reference: is it a prereq problem (invalid product IDs, logs off, wrong sandbox account)? a wrong-signal expectation (e.g. expecting `TRANSFER` when transfer is disabled)? a platform difference (iOS refund can't be sandbox-tested)? Name the expected event and where it should appear, then work backward from what they actually see.
- **Restore/transfer walkthrough** — when the user is confused about account switching, walk the specific ID configuration and the expected `TRANSFER`-or-error outcome for each ID, since this is the area the docs spend the most care on.
- **Sandbox setup guidance** — the prerequisites section, adapted to their platform and SDK.

Tie every recommendation to the verifiable signal in `references/use_cases.md` — the event cheat-sheet at the bottom of that file maps each event to what it proves.

© Ivanna Kaceviča · MIT · evanca/flutter-ai-rules

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

Все скиллы по теме «Мобильная разработка» →
revenuecat-troubleshoot RevenueCat Скилл revenuecat-troubleshoot находит причины ошибок в интеграции RevenueCat на iOS, Android, Flutter и React Native. Проверяет ключи, конфигурацию в панели управления и логи SDK. CX Codex +1 1 000установок revenuecat-paywall RevenueCat Скилл revenuecat-paywall внедряет нативный экран оплаты из панели RevenueCat через RevenueCatUI в приложения на iOS, Android, KMP, Flutter и React Native. CX Codex +1 1 300установок capacitor-in-app-purchases capawesome-team Скилл capacitor-in-app-purchases ведёт агента по шагам: настройка товаров в App Store Connect и Google Play Console, выбор плагина, покупки, валидация чеков и тесты в песочнице. CX Codex +1 1 300установок asc-revenuecat-catalog-sync rorkai Скилл asc-revenuecat-catalog-sync для Claude Code сверяет каталог App Store Connect с продуктами RevenueCat. Запускается при настройке подписок, синхронизации каталогов или проверке расхождений перед релизом. CX Codex +1 6 400установок subscription-lifecycle appeeky Скилл subscription-lifecycle для Claude Code помогает разбирать путь подписчика от пробного периода до продления, отмены и возврата. Включается при вопросах о конверсии пробных подписок, оттоке и повторных оплатах. CX Codex +1 2 700установок mobile-app-testing aj-geddes Скилл mobile-app-testing задаёт правила тестирования приложений для iOS и Android. Помогает писать юнит-, UI- и интеграционные тесты с Jest, Detox, Espresso и XCTest. CX Codex +1 834установок

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

Весь набор →
firebase-crashlytics Скилл учит агента настраивать Firebase Crashlytics во Flutter-проектах: ловить фатальные и нефатальные ошибки, логировать асинхронные исключения, добавлять кастомные ключи и загружать символы обфусцированных сборок. CX Codex +1 ★ 674звёзд репо firebase-in-app-messaging Помогает настроить Firebase In-App Messaging во Flutter: подавлять показы на критичных экранах, настраивать сбор согласий для GDPR и тестировать кампании на тестовых устройствах. CX Codex +1 ★ 674звёзд репо firebase-analytics Скилл firebase-analytics для Claude Code помогает настраивать Firebase Analytics в приложениях Flutter. Подключается при добавлении событий, свойств пользователей, воронок и отслеживания экранов. CX Codex +1 ★ 674звёзд репо patrol-e2e-testing Скилл patrol-e2e-testing пишет и запускает E2E-тесты на Patrol 4.x для Flutter: пользовательские сценарии, системные диалоги разрешений, деплинки. CX Codex +1 ★ 674звёзд репо firebase-app-check Скилл помогает внедрить Firebase App Check во Flutter: выбрать провайдеров, настроить debug-токены и включить проверку запросов. CX Codex +1 ★ 674звёзд репо flutter-best-practices Скилл flutter-best-practices для Claude Code задаёт правила Flutter и Dart: слои, структура фич, виджеты и тесты. Агент читает нужный файл-справочник под задачу. CX Codex +1 ★ 674звёзд репо flutter-app-architecture Скилл flutter-app-architecture задаёт правила многослойной архитектуры Flutter-проекта: MVVM, репозитории, сервисы и однонаправленный поток данных. CX Codex +1 ★ 674звёзд репо riverpod Скилл помогает писать Flutter- и Dart-код с Riverpod: настраивать провайдеры, управлять их жизненным циклом и проверять их тестами. Пригодится при работе с состоянием приложения. CX Codex +1 ★ 674звёзд репо

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

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