Merge pull request #19 from RevenueCat/skills/play-billing-plugin

Add revenuecat-play-billing plugin + play billing library skill sets

Author: skydoves

.agents/plugins/marketplace.json

@@ -6,6 +6,12 @@
       "source": { "source": "local", "path": "./revenuecat" },
       "policy": { "installation": "AVAILABLE", "authentication": "ON_INSTALL" },
       "category": "Productivity"
+    },
+    {
+      "name": "revenuecat-play-billing",
+      "source": { "source": "local", "path": "./revenuecat-play-billing" },
+      "policy": { "installation": "AVAILABLE" },
+      "category": "Productivity"
     }
   ]
 }

.claude-plugin/marketplace.json

@@ -18,6 +18,18 @@
       "repository": "https://github.com/RevenueCat/ai-toolkit",
       "license": "MIT",
       "keywords": ["revenuecat", "subscriptions", "iap", "in-app-purchases", "mobile"]
+    },
+    {
+      "name": "revenuecat-play-billing",
+      "source": "./revenuecat-play-billing",
+      "description": "Deep Google Play subscription lifecycle skills for the RevenueCat Android SDK — purchases, plan and price changes, payment recovery, webhooks, security.",
+      "version": "1.0.0",
+      "category": "developer-tools",
+      "author": { "name": "RevenueCat" },
+      "homepage": "https://www.revenuecat.com/guides/revenuecat-android-sdk",
+      "repository": "https://github.com/RevenueCat/ai-toolkit",
+      "license": "Apache-2.0",
+      "keywords": ["revenuecat", "android", "google-play", "play-billing", "subscriptions", "iap"]
     }
   ]
 }

.cursor-plugin/marketplace.json

@@ -12,6 +12,10 @@
     {
       "name": "revenuecat",
       "source": "./revenuecat"
+    },
+    {
+      "name": "revenuecat-play-billing",
+      "source": "./revenuecat-play-billing"
     }
   ]
 }

.github/workflows/sync-play-billing.yml

@@ -0,0 +1,54 @@
+name: Sync Play Billing skills
+
+# Pull-based sync for the revenuecat-play-billing plugin. The source of truth
+# is the revenuecat/ collection in RevenueCat/play-billing-skills; this
+# workflow regenerates the vendored copy and opens a PR when it changed.
+#
+# Requires the repo setting "Allow GitHub Actions to create and approve pull
+# requests" (Settings → Actions → General → Workflow permissions).
+
+on:
+  schedule:
+    - cron: '0 9 * * 1' # Mondays 09:00 UTC
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  sync:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check out play-billing-skills
+        uses: actions/checkout@v4
+        with:
+          repository: RevenueCat/play-billing-skills
+          path: .play-billing-skills
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Sync skills
+        run: |
+          node scripts/sync-play-billing.mjs .play-billing-skills
+          rm -rf .play-billing-skills
+
+      - name: Create pull request
+        uses: peter-evans/create-pull-request@v7
+        with:
+          branch: sync/play-billing-skills
+          delete-branch: true
+          commit-message: Sync Play Billing skills from play-billing-skills
+          title: Sync Play Billing skills from play-billing-skills
+          body: |
+            Automated sync of the `revenuecat/` collection from
+            [RevenueCat/play-billing-skills](https://github.com/RevenueCat/play-billing-skills)
+            into the `revenuecat-play-billing` plugin.
+
+            Generated by `.github/workflows/sync-play-billing.yml` via
+            `scripts/sync-play-billing.mjs`.

.github/workflows/validate.yml

@@ -26,7 +26,10 @@ jobs:
             revenuecat/.claude-plugin/plugin.json \
             revenuecat/.cursor-plugin/plugin.json \
             revenuecat/.codex-plugin/plugin.json \
-            revenuecat/gemini-extension.json; do
+            revenuecat/gemini-extension.json \
+            revenuecat-play-billing/.claude-plugin/plugin.json \
+            revenuecat-play-billing/.cursor-plugin/plugin.json \
+            revenuecat-play-billing/.codex-plugin/plugin.json; do
             echo "Validating $f..."
             node -e "JSON.parse(require('fs').readFileSync('$f','utf8'))" \
               && echo "  OK" \

CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to the RevenueCat AI Toolkit will be documented in this file
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.1.0] - 2026-06-04
+
+### Added
+
+#### Plugins
+
+- **revenuecat-play-billing** — New skills-only plugin with 20 deep Google Play subscription lifecycle skills for the RevenueCat Android SDK (purchase flow, plan and price changes, payment recovery, subscription states, webhooks, security, and more). Vendored from [RevenueCat/play-billing-skills](https://github.com/RevenueCat/play-billing-skills) (the source of truth) with an `rc-` skill prefix; licensed Apache-2.0
+- Sync automation: `scripts/sync-play-billing.mjs` (`npm run sync:play-billing`) and a weekly `sync-play-billing.yml` workflow that opens a PR when the source collection changes
+
+---
+
 ## [2.0.0] - 2026-05-06
 
 ### Added
@@ -103,5 +114,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Store-specific setup instructions (App Store Connect, Google Play Console)
 - Configuration validation and issue highlighting
 
+[2.1.0]: https://github.com/RevenueCat/ai-toolkit/compare/v2.0.0...v2.1.0
 [2.0.0]: https://github.com/RevenueCat/ai-toolkit/compare/v1.0.0...v2.0.0
 [1.0.0]: https://github.com/RevenueCat/ai-toolkit/releases/tag/v1.0.0

README.md

@@ -4,22 +4,34 @@ Configure RevenueCat projects, products, entitlements, and offerings directly fr
 
 The AI toolkit is distributed as a marketplace (containing a single plugin) for Claude Code, Cursor, Codex, and Visual Studio, and as an extension for Gemini.
 
+## Plugins
+
+This marketplace ships two plugins:
+
+| Plugin | What it does |
+|---|---|
+| `RevenueCat` | The RevenueCat MCP server (project configuration and data access) plus cross-platform integration skills for iOS, Android, Kotlin Multiplatform, Flutter, and React Native. |
+| `revenuecat-play-billing` | Deep Google Play subscription lifecycle skills for the RevenueCat Android SDK — purchases, plan and price changes, payment recovery, webhooks, security. Synced from [RevenueCat/play-billing-skills](https://github.com/RevenueCat/play-billing-skills), which is the source of truth. |
+
+Most users want the `RevenueCat` plugin. Add `revenuecat-play-billing` on top if you ship Android and want handbook-level depth on Google Play billing behavior.
+
 ## Installation
 
 ### Claude Code CLI
 
 From within Claude Code
 
 ```
-/plugin 
+/plugin
 ```
-Then select `Marketplace`, `+ Add Marketplace`, enter `RevenueCat/ai-toolkit`. Then, select the `RevenueCat` plugin.
+Then select `Marketplace`, `+ Add Marketplace`, enter `RevenueCat/ai-toolkit`. Then, select the `RevenueCat` plugin. If you ship Android and want handbook-level Google Play depth, also select `revenuecat-play-billing`.
 
 Or from the command line:
 
 ```
 claude plugins marketplace add RevenueCat/ai-toolkit
 claude plugins install RevenueCat
+claude plugins install revenuecat-play-billing
 ```
 
 
@@ -53,6 +65,8 @@ Then, in the Codex app, click on "Plugins". From the "Built by OpenAI" dropdown,
 gemini extensions install https://github.com/RevenueCat/ai-toolkit
 ```
 
+Gemini has no marketplace and supports a single extension per repository, so it installs the `RevenueCat` plugin only. The `revenuecat-play-billing` plugin is available on Claude Code, Cursor, Codex, and VS Code.
+
 
 ### Visual Studio Code
 
@@ -128,4 +142,4 @@ The plugins contain the RevenueCat MCP server setup and uses it to access your R
 
 ## License
 
-MIT License — see [LICENSE](LICENSE) for details.
+MIT License — see [LICENSE](LICENSE) for details. The `revenuecat-play-billing` plugin is synced from [RevenueCat/play-billing-skills](https://github.com/RevenueCat/play-billing-skills) and is licensed under Apache 2.0 — see [revenuecat-play-billing/LICENSE](revenuecat-play-billing/LICENSE).

package.json

@@ -1,9 +1,10 @@
 {
   "name": "ai-toolkit",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "RevenueCat plugin marketplace for AI coding assistants",
   "type": "module",
   "scripts": {
+    "sync:play-billing": "node scripts/sync-play-billing.mjs"
   },
   "license": "MIT",
   "author": {

revenuecat-play-billing/.claude-plugin/plugin.json

@@ -0,0 +1,14 @@
+{
+	"name": "revenuecat-play-billing",
+	"description": "Deep Google Play subscription lifecycle skills for the RevenueCat Android SDK — purchases, plan and price changes, payment recovery, webhooks, security. From the RevenueCat Android SDK handbook.",
+	"version": "1.0.0",
+	"license": "Apache-2.0",
+	"keywords": ["revenuecat", "android", "google-play", "play-billing", "subscriptions", "iap"],
+	"author": {
+		"name": "RevenueCat",
+		"url": "https://www.revenuecat.com",
+		"email": "support@revenuecat.com"
+	},
+	"homepage": "https://www.revenuecat.com/guides/revenuecat-android-sdk",
+	"repository": "https://github.com/RevenueCat/ai-toolkit"
+}

revenuecat-play-billing/.codex-plugin/plugin.json

@@ -0,0 +1,34 @@
+{
+  "name": "revenuecat-play-billing",
+  "version": "1.0.0",
+  "description": "Deep Google Play subscription lifecycle skills for the RevenueCat Android SDK — purchases, plan and price changes, payment recovery, webhooks, security.",
+  "homepage": "https://www.revenuecat.com/guides/revenuecat-android-sdk",
+  "repository": "https://github.com/RevenueCat/ai-toolkit",
+  "license": "Apache-2.0",
+  "keywords": ["revenuecat", "android", "google-play", "play-billing", "subscriptions", "iap"],
+  "skills": "./skills/",
+  "author": {
+    "name": "RevenueCat",
+    "url": "https://github.com/RevenueCat",
+    "email": "support@revenuecat.com"
+  },
+  "interface": {
+    "displayName": "RevenueCat Play Billing",
+    "shortDescription": "Google Play billing depth for the RevenueCat Android SDK.",
+    "longDescription": "Deep Google Play subscription lifecycle skills for the RevenueCat Android SDK — purchases, plan and price changes, payment recovery, webhooks, security. From the RevenueCat Android SDK handbook.",
+    "developerName": "RevenueCat",
+    "category": "Productivity",
+    "capabilities": ["read"],
+    "websiteURL": "https://www.revenuecat.com",
+    "privacyPolicyURL": "https://www.revenuecat.com/privacy",
+    "termsOfServiceURL": "https://www.revenuecat.com/terms",
+    "brandColor": "#F2545B",
+    "logo": "./assets/logo.png",
+    "composerIcon": "./assets/logo.png",
+    "defaultPrompt": [
+      "Implement the RevenueCat purchase flow in my Android app.",
+      "Handle a failed renewal with a grace period on Android.",
+      "Consume RevenueCat webhooks on my backend."
+    ]
+  }
+}