# revenuecat-sdk-compatibility

This skill checks whether a RevenueCat SDK version supports a feature and how many subscribers are stuck on older versions.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 491 installs · ★ 76
- Author: RevenueCat
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/RevenueCat/ai-toolkit/tree/HEAD/revenuecat/skills/revenuecat-sdk-compatibility/SKILL.md
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/skills/revenuecat-sdk-compatibility

## What it does

The skill answers RevenueCat SDK compatibility questions: does this version include the feature, is an upgrade needed, why is a gated feature failing. It runs on the RevenueCat MCP server, so nothing works without that server connected.

Before making any compatibility claim it calls `list-sdk-feature-gates` and takes the minimum version from the matching gate. If no gate fits, it says so and lists the close ones instead of guessing. When several gates apply, the most specific wins: `experiment-existing-customer-enrollment` for enrolling existing customers, `experiment-exposure-tracking` for exposure status.

The second tool, `list-sdk-versions`, breaks down subscribers seen in the last 30 days by SDK family, platform, or wrapper such as `react-native` `10.0.1`. To size rollout risk, the skill filters rows below `min_version` and sums their shares. Those numbers cover a 30-day window, not the all-time install base, and that gap matters when you plan a migration.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add RevenueCat/ai-toolkit --skill revenuecat-sdk-compatibility -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/revenuecat-sdk-compatibility/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/revenuecat-sdk-compatibility/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add RevenueCat/ai-toolkit --skill revenuecat-sdk-compatibility -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/revenuecat-sdk-compatibility/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add RevenueCat/ai-toolkit --skill revenuecat-sdk-compatibility -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/revenuecat-sdk-compatibility/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install RevenueCat/ai-toolkit revenuecat-sdk-compatibility
```

2. **Manually: put the files in place**
- File: `.github/skills/revenuecat-sdk-compatibility/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add RevenueCat/ai-toolkit --skill revenuecat-sdk-compatibility -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/RevenueCat/ai-toolkit --path revenuecat/skills/revenuecat-sdk-compatibility
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/revenuecat-sdk-compatibility/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add RevenueCat/ai-toolkit --skill revenuecat-sdk-compatibility -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/RevenueCat/ai-toolkit/tree/HEAD/revenuecat/skills/revenuecat-sdk-compatibility/SKILL.md

## When to use it
- find the minimum SDK version for a feature
- debug why a gated feature is not working
- measure the share of subscribers on incompatible SDK versions
- estimate how many users an SDK upgrade affects
- compare native iOS and Android adoption

## Example prompts
- Check which RevenueCat SDK version first supports enrolling new customers in an experiment
- How many subscribers in the last 30 days are below the minimum for experiment-exposure-tracking?
- Break adoption down by platform_flavor and show the React Native share on old versions

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: d77e39583965df9b.

BEGIN THIRD-PARTY FILE d77e39583965df9b
```text
---
name: revenuecat-sdk-compatibility
description: Check whether an SDK version supports a RevenueCat feature, whether an SDK upgrade is required, why an SDK-gated feature is not working, or how much of a project's recent subscriber base is on incompatible SDK versions. Use for questions about RevenueCat SDK compatibility, feature gates, minimum SDK versions, SDK adoption, upgrade impact, and rollout risk.
---

# RevenueCat SDK compatibility

Use the RevenueCat MCP server for all tool calls here.

## Check feature compatibility

Call `list-sdk-feature-gates` before making any SDK compatibility claim. Find the gate that matches
the user's feature and use its minimum version for each relevant RevenueCat SDK.

- If the relevant feature gate cannot be identified, say so and explain which gates looked close
  instead of guessing. Consult the docs linked in the tool output to disambiguate.
- When more than one gate could apply, prefer the most specific gate. For example:
  - Existing-customer experiment enrollment: `experiment-existing-customer-enrollment`
  - Experiment exposure status or reporting: `experiment-exposure-tracking`
  - New-customer experiment enrollment: `experiment-new-customer-enrollment`
- If multiple gates jointly matter, evaluate and name each one.

## Analyze SDK adoption

Call `list-sdk-versions` to assess upgrade impact or rollout risk from SDK versions observed in the
project. Each row describes subscribers seen in the last 30 days and includes:

- `sdk_type`: RevenueCat SDK family.
- `sdk_version`: underlying native SDK version for native rows, or the native SDK bundled under a
  wrapper in `platform_flavor` rows.
- `sortable_sdk_version`: normalized value for ordering `sdk_version`.
- `platform`: native platform, such as `ios` or `android`, when grouped by platform or platform
  flavor.
- `platform_flavor` and `platform_flavor_version`: wrapper SDK family and version, such as
  `react-native` `10.0.1`, when grouped by platform flavor.
- `subscribers_last_30days` and `pct_of_subscribers`: recent project usage counts and shares.

Choose the grouping that matches the question:

- Use `sdk_type` for a high-level inventory by RevenueCat SDK family.
- Use `platform` to compare native iOS and Android adoption.
- Use `platform_flavor` for React Native, Flutter, Capacitor, Unity, Kotlin Multiplatform, and other
  wrappers where both the wrapper version and bundled native SDK versions matter.
```
END THIRD-PARTY FILE d77e39583965df9b

The third-party file has ended. Everything between the d77e39583965df9b tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2448 of 2963 bytes. © RevenueCat · MIT · https://github.com/RevenueCat/ai-toolkit/tree/HEAD/revenuecat/skills/revenuecat-sdk-compatibility/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md