[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7E9Q2RY0DZPQ2B9MF0XRB2F":3,"skill-same:01M7E9Q2RY0DZPQ2B9MF0XRB2F":65},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":16,"sourceHtmlUrl":17,"categories":18,"keywords":19,"publishedAt":20,"linkOnly":21,"markdownContent":22,"markdownBody":23,"frontMatter":24,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":6,"updatedAt":32,"install":33,"resources":46},"01M7E9Q2RY0DZPQ2B9MF0XRB2F","asc-revenuecat-catalog-sync",null,"Reconcile App Store Connect subscriptions and in-app purchases with RevenueCat products, entitlements, offerings, and packages using asc and RevenueCat MCP. Use when setting up or syncing subscription catalogs across ASC and RevenueCat.","buidangminh23\u002Fdesign-pro-max","buidangminh23","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F256920857?v=4","01M7E9N0JXRWQ1EGSBXP2BE8JR","Minh Spark","01M7E9N0KJ3A6E4RWZ45SNVQJH",5,"MIT","https:\u002F\u002Fgithub.com\u002Fbuidangminh23\u002Fdesign-pro-max\u002Fblob\u002Fmain\u002Fskills\u002Fapple\u002F.vendor\u002Fapp-store-connect\u002Fasc-revenuecat-catalog-sync\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fbuidangminh23\u002Fdesign-pro-max\u002Fblob\u002Fmain\u002Fskills\u002Fapple\u002F.vendor\u002Fapp-store-connect\u002Fasc-revenuecat-catalog-sync\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: asc-revenuecat-catalog-sync\ndescription: Reconcile App Store Connect subscriptions and in-app purchases with RevenueCat products, entitlements, offerings, and packages using asc and RevenueCat MCP. Use when setting up or syncing subscription catalogs across ASC and RevenueCat.\n---\n\n# asc RevenueCat catalog sync\n\nUse this skill to keep App Store Connect (ASC) and RevenueCat aligned, including creating missing ASC items and mapping them to RevenueCat resources.\n\n## When to use\n- You want to bootstrap RevenueCat from an existing ASC catalog.\n- You want to create missing ASC subscriptions\u002FIAPs, then map them into RevenueCat.\n- You need a drift audit before release.\n- You want deterministic product mapping based on identifiers.\n\n## Preconditions\n- `asc` authentication is configured (`asc auth login` or `ASC_*` env vars).\n- RevenueCat MCP server is configured and authenticated.\n- In Cursor and VS Code, OAuth auth is available for RevenueCat MCP. API key auth is also supported.\n- You know:\n  - ASC app ID (`APP_ID`)\n  - RevenueCat `project_id`\n  - target RevenueCat app type (`app_store` or `mac_app_store`) and bundle ID for create flows\n- Use a write-enabled RevenueCat API v2 key when applying changes.\n\n## Safety defaults\n- Start in **audit mode** (read-only).\n- Require explicit confirmation before writes.\n- Never delete resources in this workflow.\n- Continue on per-item failures and report all failures at the end.\n\n## Canonical identifiers\n- Primary cross-system key: ASC `productId` == RevenueCat `store_identifier`.\n- Keep `productId` stable once products are live.\n- Do not use display names as unique identifiers.\n\n## Scope boundary\n- RevenueCat MCP configures RevenueCat resources; it does not create App Store Connect products directly.\n- Use `asc` commands to create missing ASC subscription groups, subscriptions, and IAPs before RevenueCat mapping.\n\n## Modes\n\n### 1) Audit mode (default)\n1. Read ASC source catalog.\n2. Read RevenueCat target catalog.\n3. Build a diff with actions:\n   - missing in ASC\n   - missing in RevenueCat\n   - mapping conflicts (identifier\u002Ftype\u002Fapp mismatch)\n4. Present the plan. Audit-only requests finish with findings; apply requests require approval covering the complete current diff. Reuse prior approval if the refreshed diff is unchanged.\n\n### 2) Apply mode (explicit)\nExecute approved actions in this order:\n1. Ensure ASC groups\u002Fsubscriptions\u002FIAP exist.\n2. Ensure RevenueCat app\u002Fproducts exist.\n3. Ensure entitlements and product attachments.\n4. Ensure offerings\u002Fpackages and package attachments.\n5. Verify and print a final reconciliation summary.\n\n## Step-by-step workflow\n\n### Step A - Read current ASC catalog\n\n```bash\nasc subscriptions groups list --app \"APP_ID\" --paginate --output json\nasc iap list --app \"APP_ID\" --paginate --output json\n# for each subscription group:\nasc subscriptions list --group-id \"GROUP_ID\" --paginate --output json\n```\n\n### Step B - Read current RevenueCat catalog (MCP)\n\nUse these MCP tools (with `project_id` and pagination where applicable):\n- `mcp_RC_get_project`\n- `mcp_RC_list_apps`\n- `mcp_RC_list_products`\n- `mcp_RC_list_entitlements`\n- `mcp_RC_list_offerings`\n- `mcp_RC_list_packages`\n\n### Step C - Build mapping plan\n\nMap ASC product types to RevenueCat product types:\n- ASC subscription -> RevenueCat `subscription`\n- ASC IAP `CONSUMABLE` -> RevenueCat `consumable`\n- ASC IAP `NON_CONSUMABLE` -> RevenueCat `non_consumable`\n- ASC IAP `NON_RENEWING_SUBSCRIPTION` -> RevenueCat `non_renewing_subscription`\n\nSuggested entitlement policy:\n- subscriptions: one entitlement per subscription group (or explicit map provided by user)\n- non-consumable IAP: one entitlement per product\n- consumable IAP: no entitlement by default unless user asks\n\n### Step D - Ensure missing ASC items (if requested)\n\nResolve every parent and version before writing. Match groups by exact reference\nname and products by `productId`; never treat a display name as identity. Reuse\nthe canonical ID when the resource already exists, and run a create command\nonly when the fully paginated read proves it is missing. A RevenueCat product\nmapping is not proof that the corresponding ASC subscription is review-ready.\n\n```bash\n# Resolve GROUP_ID by exact referenceName.\nasc subscriptions groups list --app \"APP_ID\" --paginate --output json\n# If and only if the fully paginated list has zero exact matches:\nasc subscriptions groups create --app \"APP_ID\" --reference-name \"Premium\" --output json\n# For one match, reuse its ID. For more than one, stop and require an explicit GROUP_ID.\n\n# Resolve SUB_ID by exact productId within GROUP_ID. Run setup only for a missing\n# parent or an explicitly approved reconciliation of that same product ID.\nasc subscriptions list --group-id \"GROUP_ID\" --paginate --output json\n# If and only if the fully paginated list has zero exact matches, run setup:\nasc subscriptions setup \\\n  --app \"APP_ID\" \\\n  --group-id \"GROUP_ID\" \\\n  --reference-name \"Monthly\" \\\n  --product-id \"com.example.premium.monthly\" \\\n  --subscription-period ONE_MONTH \\\n  --review-screenshot \".\u002Freview.png\" \\\n  --price \"3.99\" \\\n  --price-territory \"USA\" \\\n  --territories \"USA\" \\\n  --no-verify \\\n  --output json\n# For one match, reuse its ID. For more than one, stop and require an explicit SUB_ID.\n# Re-run setup for an existing SUB_ID only for an explicitly approved reconciliation.\n\n# Resolve the unique mutable group version for this review lifecycle.\nasc subscriptions groups versions list --group-id \"GROUP_ID\" --state PREPARE_FOR_SUBMISSION --paginate --output json\n# If and only if the list has zero matches:\nasc subscriptions groups versions create --group-id \"GROUP_ID\" --output json\n# For one match, reuse .data[0].id. For more than one, stop and require an explicit GROUP_VERSION_ID.\n\n# Resolve the en-US localization on GROUP_VERSION_ID. Create it only when\n# missing; update the resolved localization ID when its values differ.\nasc subscriptions groups versions localizations list --version-id \"GROUP_VERSION_ID\" --paginate --output json\nasc subscriptions groups versions localizations create --version-id \"GROUP_VERSION_ID\" --locale \"en-US\" --name \"Premium\" --output json\nasc subscriptions groups versions localizations update --id \"GROUP_LOC_ID\" --name \"Premium\"\n\n# Resolve the unique mutable subscription version for this review lifecycle.\nasc subscriptions versions list --subscription-id \"SUB_ID\" --state PREPARE_FOR_SUBMISSION --paginate --output json\n# If and only if the list has zero matches:\nasc subscriptions versions create --subscription-id \"SUB_ID\" --output json\n# For one match, reuse .data[0].id. For more than one, stop and require an explicit SUBSCRIPTION_VERSION_ID.\nasc subscriptions versions localizations list --version-id \"SUBSCRIPTION_VERSION_ID\" --paginate --output json\nasc subscriptions versions localizations create --version-id \"SUBSCRIPTION_VERSION_ID\" --locale \"en-US\" --name \"Premium Monthly\" --description \"Unlock all premium features.\" --output json\nasc subscriptions versions localizations update --id \"SUBSCRIPTION_LOC_ID\" --name \"Premium Monthly\" --description \"Unlock all premium features.\"\n\n# Read back the exact versions selected above, then run the final strict validator.\nasc subscriptions groups versions localizations list --version-id \"GROUP_VERSION_ID\" --paginate --output table\nasc subscriptions versions localizations list --version-id \"SUBSCRIPTION_VERSION_ID\" --paginate --output table\nasc validate subscriptions --app \"APP_ID\" --strict --output table\n\n# Resolve IAP_ID by exact productId.\nasc iap list --app \"APP_ID\" --paginate --output json\n# If and only if the fully paginated list has zero exact matches:\nasc iap create \\\n  --app \"APP_ID\" \\\n  --type NON_CONSUMABLE \\\n  --ref-name \"Lifetime\" \\\n  --product-id \"com.example.lifetime\" \\\n  --output json\n# For one match, reuse its ID. For more than one, stop and require an explicit IAP_ID.\n\n# Resolve the unique mutable IAP version for this review lifecycle.\nasc iap versions list --iap-id \"IAP_ID\" --state PREPARE_FOR_SUBMISSION --paginate --output json\n# If and only if the list has zero matches:\nasc iap versions create --iap-id \"IAP_ID\" --output json\n# For one match, reuse .data[0].id. For more than one, stop and require an explicit IAP_VERSION_ID.\nasc iap versions localizations list --version-id \"IAP_VERSION_ID\" --paginate --output json\nasc iap versions localizations create --version-id \"IAP_VERSION_ID\" --locale \"en-US\" --name \"Lifetime\" --description \"Unlock all premium features.\" --output json\nasc iap versions localizations update --localization-id \"IAP_LOC_ID\" --name \"Lifetime\" --description \"Unlock all premium features.\"\nasc iap versions localizations list --version-id \"IAP_VERSION_ID\" --paginate --output table\n```\n\nEach adjacent create\u002Fupdate pair above is conditional, not a sequence to run\nblindly: create when the list has no match, update when the resolved match has\ndifferent values, and do nothing when it already matches. Capture `.data.id`\nfrom a create response or `.data[].id` from the preceding list as the canonical\nID used by later commands. For each version list, zero\n`PREPARE_FOR_SUBMISSION` matches means create, one means reuse that ID, and more\nthan one means stop and require the user to choose an explicit version ID. Do\nnot create a version to resolve ambiguity: parent deletion did not reliably\ncascade IAP or subscription versions in live testing.\n\n`subscriptions setup` finishes the parent, App Review screenshot delivery,\ncomplete App Store price matrix, and sale availability. The version-scoped\ncommands finish the group and subscription localizations that RevenueCat\ncannot. Keep sale availability scoped to the requested territories; pricing\nstill needs Apple's complete equalized territory matrix. `--no-verify` is\nintentional in this split workflow because final verification must wait until\nthe version metadata exists; the explicit readbacks and validator are the final\ngate.\n\nIf an existing API-created subscription remains `MISSING_METADATA` even though\nthe selected base price is unchanged, re-run the same setup inputs with\n`--repair`. Repair atomically rebuilds and re-saves the complete equalized price\nmatrix; it is not a duplicate single-price POST.\n\nFor every resolved ASC subscription, require this final gate before creating or\nattaching its RevenueCat product. Run it after the final ASC reconciliation even\nwhen the subscription and its selected version were reused without any ASC\nwrite:\n\n```bash\nmkdir -p \".\u002Faudit\"\nasc validate subscriptions --app \"APP_ID\" --strict --output json --pretty \\\n  > \".\u002Faudit\u002Fsubscriptions-validation.json\"\n```\n\nFor every resolved ASC IAP, require the IAP gate before creating or attaching\nits RevenueCat product. Run it after the final ASC reconciliation even when the\nIAP and its selected version were reused without any ASC write:\n\n```bash\nmkdir -p \".\u002Faudit\"\nasc validate iap --app \"APP_ID\" --strict --output json --pretty \\\n  > \".\u002Faudit\u002Fiap-validation.json\"\n```\n\nBoth commands are strict mapping gates, not post-write smoke tests. Do not map\nany resolved or reused subscription while validation reports warnings, errors,\n`MISSING_METADATA`, a review screenshot that is not `COMPLETE`, or incomplete\nor unverified pricing coverage. Do not map any resolved or reused IAP while its\nvalidator reports warnings or errors. A zero-write audit or apply run must still\nexecute the applicable gate and require a zero exit status before RevenueCat\nproduct creation or attachment. Direct redirection preserves each validator's\nexit status. Retain `.\u002Faudit\u002Fsubscriptions-validation.json` and\n`.\u002Faudit\u002Fiap-validation.json` as final audit evidence.\n\n### Step E - Ensure RevenueCat app and products\n\nUse MCP:\n- create app if missing: `mcp_RC_create_app`\n- create products: `mcp_RC_create_product`\n  - `store_identifier` = ASC `productId`\n  - `app_id` = RevenueCat app ID\n  - `type` from mapping above\n\n### Step F - Ensure entitlements and attachments\n\nUse MCP:\n- list\u002Fcreate entitlements: `mcp_RC_list_entitlements`, `mcp_RC_create_entitlement`\n- attach products: `mcp_RC_attach_products_to_entitlement`\n- verify attachments: `mcp_RC_get_products_from_entitlement`\n\n### Step G - Ensure offerings and packages (optional)\n\nUse MCP:\n- list\u002Fcreate\u002Fupdate offerings:\n  - `mcp_RC_list_offerings`\n  - `mcp_RC_create_offering`\n  - `mcp_RC_update_offering` (`is_current=true` only if requested)\n- list\u002Fcreate packages:\n  - `mcp_RC_list_packages`\n  - `mcp_RC_create_package`\n- attach products to packages:\n  - `mcp_RC_attach_products_to_package` with `eligibility_criteria: \"all\"`\n\nRecommended package keys:\n- `ONE_WEEK` -> `$rc_weekly`\n- `ONE_MONTH` -> `$rc_monthly`\n- `TWO_MONTHS` -> `$rc_two_month`\n- `THREE_MONTHS` -> `$rc_three_month`\n- `SIX_MONTHS` -> `$rc_six_month`\n- `ONE_YEAR` -> `$rc_annual`\n- lifetime IAP -> `$rc_lifetime`\n- custom -> `$rc_custom_\u003Cname>`\n\n## Expected output format\n\nReturn a final summary with:\n- ASC created counts (groups\u002Fsubscriptions\u002FIAP)\n- RevenueCat created counts (apps\u002Fproducts\u002Fentitlements\u002Fofferings\u002Fpackages)\n- attachment counts (entitlement-products, package-products)\n- skipped existing items\n- failed items with actionable errors\n\nExample:\n\n```text\nASC: created groups=1 subscriptions=2 iap=1, skipped=14, failed=0\nRC: created apps=0 products=3 entitlements=2 offerings=1 packages=2, skipped=27, failed=1\nAttachments: entitlement_products=3 package_products=2\nFailures:\n- com.example.premium.annual: duplicate store_identifier exists on another RC app\n```\n\n## Agent behavior\n- Always run audit first, even in apply mode.\n- Reuse approval covering the complete current diff for its create\u002Fupdate operations. Ask again only when approval is absent or additional or materially changed actions fall outside it.\n- Match by `store_identifier` first.\n- Use full pagination (`--paginate` for ASC, `starting_after` for RevenueCat tools).\n- Continue processing after per-item failures and report all failures together.\n- Never auto-delete ASC or RevenueCat resources in this skill.\n- For every resolved subscription, including a reused no-write match, run `asc validate subscriptions --app \"APP_ID\" --strict --output json --pretty`, save its JSON, and block RevenueCat creation or attachment unless the gate exits zero with no missing metadata or incomplete pricing.\n- For every resolved IAP, including a reused no-write match, run `asc validate iap --app \"APP_ID\" --strict --output json --pretty`, save its JSON, and block RevenueCat creation or attachment unless the gate exits zero.\n\n## Common pitfalls\n- Wrong RevenueCat `project_id` or app ID.\n- Creating RC products under the wrong platform app.\n- Accidentally assigning consumables to entitlements.\n- Skipping the post-create ASC re-read step.\n- Mapping a RevenueCat product before ASC setup finishes localization, review screenshot delivery, the complete price matrix, and availability.\n- Missing offering\u002Fpackage verification after product creation.\n\n## Additional resources\n- Workflow examples: [examples.md](examples.md)\n- Source references: [references.md](references.md)\n","# asc RevenueCat catalog sync\n\nUse this skill to keep App Store Connect (ASC) and RevenueCat aligned, including creating missing ASC items and mapping them to RevenueCat resources.\n\n## When to use\n- You want to bootstrap RevenueCat from an existing ASC catalog.\n- You want to create missing ASC subscriptions\u002FIAPs, then map them into RevenueCat.\n- You need a drift audit before release.\n- You want deterministic product mapping based on identifiers.\n\n## Preconditions\n- `asc` authentication is configured (`asc auth login` or `ASC_*` env vars).\n- RevenueCat MCP server is configured and authenticated.\n- In Cursor and VS Code, OAuth auth is available for RevenueCat MCP. API key auth is also supported.\n- You know:\n  - ASC app ID (`APP_ID`)\n  - RevenueCat `project_id`\n  - target RevenueCat app type (`app_store` or `mac_app_store`) and bundle ID for create flows\n- Use a write-enabled RevenueCat API v2 key when applying changes.\n\n## Safety defaults\n- Start in **audit mode** (read-only).\n- Require explicit confirmation before writes.\n- Never delete resources in this workflow.\n- Continue on per-item failures and report all failures at the end.\n\n## Canonical identifiers\n- Primary cross-system key: ASC `productId` == RevenueCat `store_identifier`.\n- Keep `productId` stable once products are live.\n- Do not use display names as unique identifiers.\n\n## Scope boundary\n- RevenueCat MCP configures RevenueCat resources; it does not create App Store Connect products directly.\n- Use `asc` commands to create missing ASC subscription groups, subscriptions, and IAPs before RevenueCat mapping.\n\n## Modes\n\n### 1) Audit mode (default)\n1. Read ASC source catalog.\n2. Read RevenueCat target catalog.\n3. Build a diff with actions:\n   - missing in ASC\n   - missing in RevenueCat\n   - mapping conflicts (identifier\u002Ftype\u002Fapp mismatch)\n4. Present the plan. Audit-only requests finish with findings; apply requests require approval covering the complete current diff. Reuse prior approval if the refreshed diff is unchanged.\n\n### 2) Apply mode (explicit)\nExecute approved actions in this order:\n1. Ensure ASC groups\u002Fsubscriptions\u002FIAP exist.\n2. Ensure RevenueCat app\u002Fproducts exist.\n3. Ensure entitlements and product attachments.\n4. Ensure offerings\u002Fpackages and package attachments.\n5. Verify and print a final reconciliation summary.\n\n## Step-by-step workflow\n\n### Step A - Read current ASC catalog\n\n```bash\nasc subscriptions groups list --app \"APP_ID\" --paginate --output json\nasc iap list --app \"APP_ID\" --paginate --output json\n# for each subscription group:\nasc subscriptions list --group-id \"GROUP_ID\" --paginate --output json\n```\n\n### Step B - Read current RevenueCat catalog (MCP)\n\nUse these MCP tools (with `project_id` and pagination where applicable):\n- `mcp_RC_get_project`\n- `mcp_RC_list_apps`\n- `mcp_RC_list_products`\n- `mcp_RC_list_entitlements`\n- `mcp_RC_list_offerings`\n- `mcp_RC_list_packages`\n\n### Step C - Build mapping plan\n\nMap ASC product types to RevenueCat product types:\n- ASC subscription -> RevenueCat `subscription`\n- ASC IAP `CONSUMABLE` -> RevenueCat `consumable`\n- ASC IAP `NON_CONSUMABLE` -> RevenueCat `non_consumable`\n- ASC IAP `NON_RENEWING_SUBSCRIPTION` -> RevenueCat `non_renewing_subscription`\n\nSuggested entitlement policy:\n- subscriptions: one entitlement per subscription group (or explicit map provided by user)\n- non-consumable IAP: one entitlement per product\n- consumable IAP: no entitlement by default unless user asks\n\n### Step D - Ensure missing ASC items (if requested)\n\nResolve every parent and version before writing. Match groups by exact reference\nname and products by `productId`; never treat a display name as identity. Reuse\nthe canonical ID when the resource already exists, and run a create command\nonly when the fully paginated read proves it is missing. A RevenueCat product\nmapping is not proof that the corresponding ASC subscription is review-ready.\n\n```bash\n# Resolve GROUP_ID by exact referenceName.\nasc subscriptions groups list --app \"APP_ID\" --paginate --output json\n# If and only if the fully paginated list has zero exact matches:\nasc subscriptions groups create --app \"APP_ID\" --reference-name \"Premium\" --output json\n# For one match, reuse its ID. For more than one, stop and require an explicit GROUP_ID.\n\n# Resolve SUB_ID by exact productId within GROUP_ID. Run setup only for a missing\n# parent or an explicitly approved reconciliation of that same product ID.\nasc subscriptions list --group-id \"GROUP_ID\" --paginate --output json\n# If and only if the fully paginated list has zero exact matches, run setup:\nasc subscriptions setup \\\n  --app \"APP_ID\" \\\n  --group-id \"GROUP_ID\" \\\n  --reference-name \"Monthly\" \\\n  --product-id \"com.example.premium.monthly\" \\\n  --subscription-period ONE_MONTH \\\n  --review-screenshot \".\u002Freview.png\" \\\n  --price \"3.99\" \\\n  --price-territory \"USA\" \\\n  --territories \"USA\" \\\n  --no-verify \\\n  --output json\n# For one match, reuse its ID. For more than one, stop and require an explicit SUB_ID.\n# Re-run setup for an existing SUB_ID only for an explicitly approved reconciliation.\n\n# Resolve the unique mutable group version for this review lifecycle.\nasc subscriptions groups versions list --group-id \"GROUP_ID\" --state PREPARE_FOR_SUBMISSION --paginate --output json\n# If and only if the list has zero matches:\nasc subscriptions groups versions create --group-id \"GROUP_ID\" --output json\n# For one match, reuse .data[0].id. For more than one, stop and require an explicit GROUP_VERSION_ID.\n\n# Resolve the en-US localization on GROUP_VERSION_ID. Create it only when\n# missing; update the resolved localization ID when its values differ.\nasc subscriptions groups versions localizations list --version-id \"GROUP_VERSION_ID\" --paginate --output json\nasc subscriptions groups versions localizations create --version-id \"GROUP_VERSION_ID\" --locale \"en-US\" --name \"Premium\" --output json\nasc subscriptions groups versions localizations update --id \"GROUP_LOC_ID\" --name \"Premium\"\n\n# Resolve the unique mutable subscription version for this review lifecycle.\nasc subscriptions versions list --subscription-id \"SUB_ID\" --state PREPARE_FOR_SUBMISSION --paginate --output json\n# If and only if the list has zero matches:\nasc subscriptions versions create --subscription-id \"SUB_ID\" --output json\n# For one match, reuse .data[0].id. For more than one, stop and require an explicit SUBSCRIPTION_VERSION_ID.\nasc subscriptions versions localizations list --version-id \"SUBSCRIPTION_VERSION_ID\" --paginate --output json\nasc subscriptions versions localizations create --version-id \"SUBSCRIPTION_VERSION_ID\" --locale \"en-US\" --name \"Premium Monthly\" --description \"Unlock all premium features.\" --output json\nasc subscriptions versions localizations update --id \"SUBSCRIPTION_LOC_ID\" --name \"Premium Monthly\" --description \"Unlock all premium features.\"\n\n# Read back the exact versions selected above, then run the final strict validator.\nasc subscriptions groups versions localizations list --version-id \"GROUP_VERSION_ID\" --paginate --output table\nasc subscriptions versions localizations list --version-id \"SUBSCRIPTION_VERSION_ID\" --paginate --output table\nasc validate subscriptions --app \"APP_ID\" --strict --output table\n\n# Resolve IAP_ID by exact productId.\nasc iap list --app \"APP_ID\" --paginate --output json\n# If and only if the fully paginated list has zero exact matches:\nasc iap create \\\n  --app \"APP_ID\" \\\n  --type NON_CONSUMABLE \\\n  --ref-name \"Lifetime\" \\\n  --product-id \"com.example.lifetime\" \\\n  --output json\n# For one match, reuse its ID. For more than one, stop and require an explicit IAP_ID.\n\n# Resolve the unique mutable IAP version for this review lifecycle.\nasc iap versions list --iap-id \"IAP_ID\" --state PREPARE_FOR_SUBMISSION --paginate --output json\n# If and only if the list has zero matches:\nasc iap versions create --iap-id \"IAP_ID\" --output json\n# For one match, reuse .data[0].id. For more than one, stop and require an explicit IAP_VERSION_ID.\nasc iap versions localizations list --version-id \"IAP_VERSION_ID\" --paginate --output json\nasc iap versions localizations create --version-id \"IAP_VERSION_ID\" --locale \"en-US\" --name \"Lifetime\" --description \"Unlock all premium features.\" --output json\nasc iap versions localizations update --localization-id \"IAP_LOC_ID\" --name \"Lifetime\" --description \"Unlock all premium features.\"\nasc iap versions localizations list --version-id \"IAP_VERSION_ID\" --paginate --output table\n```\n\nEach adjacent create\u002Fupdate pair above is conditional, not a sequence to run\nblindly: create when the list has no match, update when the resolved match has\ndifferent values, and do nothing when it already matches. Capture `.data.id`\nfrom a create response or `.data[].id` from the preceding list as the canonical\nID used by later commands. For each version list, zero\n`PREPARE_FOR_SUBMISSION` matches means create, one means reuse that ID, and more\nthan one means stop and require the user to choose an explicit version ID. Do\nnot create a version to resolve ambiguity: parent deletion did not reliably\ncascade IAP or subscription versions in live testing.\n\n`subscriptions setup` finishes the parent, App Review screenshot delivery,\ncomplete App Store price matrix, and sale availability. The version-scoped\ncommands finish the group and subscription localizations that RevenueCat\ncannot. Keep sale availability scoped to the requested territories; pricing\nstill needs Apple's complete equalized territory matrix. `--no-verify` is\nintentional in this split workflow because final verification must wait until\nthe version metadata exists; the explicit readbacks and validator are the final\ngate.\n\nIf an existing API-created subscription remains `MISSING_METADATA` even though\nthe selected base price is unchanged, re-run the same setup inputs with\n`--repair`. Repair atomically rebuilds and re-saves the complete equalized price\nmatrix; it is not a duplicate single-price POST.\n\nFor every resolved ASC subscription, require this final gate before creating or\nattaching its RevenueCat product. Run it after the final ASC reconciliation even\nwhen the subscription and its selected version were reused without any ASC\nwrite:\n\n```bash\nmkdir -p \".\u002Faudit\"\nasc validate subscriptions --app \"APP_ID\" --strict --output json --pretty \\\n  > \".\u002Faudit\u002Fsubscriptions-validation.json\"\n```\n\nFor every resolved ASC IAP, require the IAP gate before creating or attaching\nits RevenueCat product. Run it after the final ASC reconciliation even when the\nIAP and its selected version were reused without any ASC write:\n\n```bash\nmkdir -p \".\u002Faudit\"\nasc validate iap --app \"APP_ID\" --strict --output json --pretty \\\n  > \".\u002Faudit\u002Fiap-validation.json\"\n```\n\nBoth commands are strict mapping gates, not post-write smoke tests. Do not map\nany resolved or reused subscription while validation reports warnings, errors,\n`MISSING_METADATA`, a review screenshot that is not `COMPLETE`, or incomplete\nor unverified pricing coverage. Do not map any resolved or reused IAP while its\nvalidator reports warnings or errors. A zero-write audit or apply run must still\nexecute the applicable gate and require a zero exit status before RevenueCat\nproduct creation or attachment. Direct redirection preserves each validator's\nexit status. Retain `.\u002Faudit\u002Fsubscriptions-validation.json` and\n`.\u002Faudit\u002Fiap-validation.json` as final audit evidence.\n\n### Step E - Ensure RevenueCat app and products\n\nUse MCP:\n- create app if missing: `mcp_RC_create_app`\n- create products: `mcp_RC_create_product`\n  - `store_identifier` = ASC `productId`\n  - `app_id` = RevenueCat app ID\n  - `type` from mapping above\n\n### Step F - Ensure entitlements and attachments\n\nUse MCP:\n- list\u002Fcreate entitlements: `mcp_RC_list_entitlements`, `mcp_RC_create_entitlement`\n- attach products: `mcp_RC_attach_products_to_entitlement`\n- verify attachments: `mcp_RC_get_products_from_entitlement`\n\n### Step G - Ensure offerings and packages (optional)\n\nUse MCP:\n- list\u002Fcreate\u002Fupdate offerings:\n  - `mcp_RC_list_offerings`\n  - `mcp_RC_create_offering`\n  - `mcp_RC_update_offering` (`is_current=true` only if requested)\n- list\u002Fcreate packages:\n  - `mcp_RC_list_packages`\n  - `mcp_RC_create_package`\n- attach products to packages:\n  - `mcp_RC_attach_products_to_package` with `eligibility_criteria: \"all\"`\n\nRecommended package keys:\n- `ONE_WEEK` -> `$rc_weekly`\n- `ONE_MONTH` -> `$rc_monthly`\n- `TWO_MONTHS` -> `$rc_two_month`\n- `THREE_MONTHS` -> `$rc_three_month`\n- `SIX_MONTHS` -> `$rc_six_month`\n- `ONE_YEAR` -> `$rc_annual`\n- lifetime IAP -> `$rc_lifetime`\n- custom -> `$rc_custom_\u003Cname>`\n\n## Expected output format\n\nReturn a final summary with:\n- ASC created counts (groups\u002Fsubscriptions\u002FIAP)\n- RevenueCat created counts (apps\u002Fproducts\u002Fentitlements\u002Fofferings\u002Fpackages)\n- attachment counts (entitlement-products, package-products)\n- skipped existing items\n- failed items with actionable errors\n\nExample:\n\n```text\nASC: created groups=1 subscriptions=2 iap=1, skipped=14, failed=0\nRC: created apps=0 products=3 entitlements=2 offerings=1 packages=2, skipped=27, failed=1\nAttachments: entitlement_products=3 package_products=2\nFailures:\n- com.example.premium.annual: duplicate store_identifier exists on another RC app\n```\n\n## Agent behavior\n- Always run audit first, even in apply mode.\n- Reuse approval covering the complete current diff for its create\u002Fupdate operations. Ask again only when approval is absent or additional or materially changed actions fall outside it.\n- Match by `store_identifier` first.\n- Use full pagination (`--paginate` for ASC, `starting_after` for RevenueCat tools).\n- Continue processing after per-item failures and report all failures together.\n- Never auto-delete ASC or RevenueCat resources in this skill.\n- For every resolved subscription, including a reused no-write match, run `asc validate subscriptions --app \"APP_ID\" --strict --output json --pretty`, save its JSON, and block RevenueCat creation or attachment unless the gate exits zero with no missing metadata or incomplete pricing.\n- For every resolved IAP, including a reused no-write match, run `asc validate iap --app \"APP_ID\" --strict --output json --pretty`, save its JSON, and block RevenueCat creation or attachment unless the gate exits zero.\n\n## Common pitfalls\n- Wrong RevenueCat `project_id` or app ID.\n- Creating RC products under the wrong platform app.\n- Accidentally assigning consumables to entitlements.\n- Skipping the post-create ASC re-read step.\n- Mapping a RevenueCat product before ASC setup finishes localization, review screenshot delivery, the complete price matrix, and availability.\n- Missing offering\u002Fpackage verification after product creation.\n\n## Additional resources\n- Workflow examples: [examples.md](examples.md)\n- Source references: [references.md](references.md)\n",{"name":5,"description":7},"main","c24f526343de0e3daddc559ae8c8061c7bee9168","skills\u002Fapple\u002F.vendor\u002Fapp-store-connect\u002Fasc-revenuecat-catalog-sync",0,"https:\u002F\u002Fgithub.com\u002Fbuidangminh23\u002Fdesign-pro-max","https:\u002F\u002Fgithub.com\u002Fbuidangminh23","https:\u002F\u002Fminhspark.com","2026-11-13 18:28:36",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add buidangminh23\u002Fdesign-pro-max --skill asc-revenuecat-catalog-sync",{"tool":39,"command":40},"bunx","bunx skills add buidangminh23\u002Fdesign-pro-max --skill asc-revenuecat-catalog-sync",{"tool":42,"command":43},"pnpm","pnpm dlx skills add buidangminh23\u002Fdesign-pro-max --skill asc-revenuecat-catalog-sync","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fbuidangminh23\u002Fdesign-pro-max\u002Fblob\u002Fmain\u002Fskills\u002Fapple\u002F.vendor\u002Fapp-store-connect\u002Fasc-revenuecat-catalog-sync\u002FSKILL.md",true,[47,53,57,61],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"examples.md","REFERENCE","参考文档",13786,"https:\u002F\u002Fgithub.com\u002Fbuidangminh23\u002Fdesign-pro-max\u002Fblob\u002Fmain\u002Fskills\u002Fapple\u002F.vendor\u002Fapp-store-connect\u002Fasc-revenuecat-catalog-sync\u002Fexamples.md",{"path":54,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":56,"sourceHtmlUrl":16},"LICENSE","许可证",1070,{"path":58,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":59,"sourceHtmlUrl":60},"references.md",1134,"https:\u002F\u002Fgithub.com\u002Fbuidangminh23\u002Fdesign-pro-max\u002Fblob\u002Fmain\u002Fskills\u002Fapple\u002F.vendor\u002Fapp-store-connect\u002Fasc-revenuecat-catalog-sync\u002Freferences.md",{"path":62,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":63,"sourceHtmlUrl":64},"UPSTREAM.json",1809,"https:\u002F\u002Fgithub.com\u002Fbuidangminh23\u002Fdesign-pro-max\u002Fblob\u002Fmain\u002Fskills\u002Fapple\u002F.vendor\u002Fapp-store-connect\u002Fasc-revenuecat-catalog-sync\u002FUPSTREAM.json",[66,74,82,89,97,105],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":70,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":20},"01M7E9TYRPZ0JSFX8S1PS0M33C","icons-pro-max","A portable icon catalog and rendering guide for the current project: payment methods, QR codes, social\u002Fapp brand marks, download badges, the lucide-react UI icon set, 145 tech-stack logos, 86 full-color AI provider marks, 516 Claude connector icons, and 25 Microsoft app logos. Gives the exact asset path, React component, canonical size, brand color, render recipe, and accessibility rule for each icon — plus an anti-slop checklist so an agent never redraws a logo, recolors a brand mark, distorts an aspect ratio, or re-inlines a duplicated icon. Use whenever adding, rendering, swapping, or auditing an icon anywhere in a website, app, or document.","https:\u002F\u002Fgithub.com\u002Fbuidangminh23\u002Fdesign-pro-max\u002Fblob\u002Fmain\u002Fskills\u002Ficons-pro-max\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fbuidangminh23\u002Fdesign-pro-max\u002Fblob\u002Fmain\u002Fskills\u002Ficons-pro-max\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":78,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":20},"01M7E9TN6D8X0EMC5JK28WDKMY","design-spacing-rhythm","The most complete spacing & alignment skill for AI-generated UI and written documents. Reads the layout, sets three dials (SPACING_STEP \u002F DENSITY \u002F ALIGNMENT_RIGOR), derives ONE scale, and lets proximity carry meaning — establishing a spacing scale, vertical rhythm, optical alignment, whitespace hierarchy, responsive\u002Ffluid density, accessibility floors, component recipes, document & long-form (Word \u002F Docs \u002F PDF \u002F Markdown) spacing, and an anti-slop checklist. Every rule is CONTEXTUAL: read the situation, then pull only what fits. Not a blanket \"add more padding\" pass.","https:\u002F\u002Fgithub.com\u002Fbuidangminh23\u002Fdesign-pro-max\u002Fblob\u002Fmain\u002Fskills\u002Fdesign-spacing-rhythm\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fbuidangminh23\u002Fdesign-pro-max\u002Fblob\u002Fmain\u002Fskills\u002Fdesign-spacing-rhythm\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":20},"01M7E9TFK8SVDBE8B91XG8WW8A","apple","For Apple app UI and code (SwiftUI, Xcode, HIG) and scroll scenes. Use when a question or task needs HIG reviews, App Store Connect (app records, TestFlight, signing, notarizing, ad hoc, What's New, ASO, Apple Ads, Wall of Apps, screenshots), SwiftData, Swift 6, Swift Testing, Core Data, Xcode builds, disk space, Tuist apps or pinned or scrubbed web sections. Not for launch\u002Fpreview videos, captioned screenshots, Play Store art, GSAP, web springs (apple-design) or Swift questions (write-swift).","https:\u002F\u002Fgithub.com\u002Fbuidangminh23\u002Fdesign-pro-max\u002Fblob\u002Fmain\u002Fskills\u002Fapple\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":93,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":20},"01M7E9T9G0A9FS85F09P6CQBG2","xcode-disk-cleanup","Audit and safely clean Xcode-related developer storage on macOS. Use whenever a developer mentions low disk space, Xcode storage, DerivedData, simulator devices or runtimes, stale beta platforms in Xcode Settings, DeviceSupport, archives, dSYMs, CocoaPods caches, simulator dyld caches, project .build folders, downloaded Xcode DMGs\u002FXIPs, duplicate Xcode installers, or old Xcode applications. Also use this skill proactively when you hit low storage during other work, such as a build, download, or install failing with an out-of-disk-space error. Always measure first, report recoverable GiB with evidence, and obtain explicit itemized approval before any mutation.","https:\u002F\u002Fgithub.com\u002Fbuidangminh23\u002Fdesign-pro-max\u002Fblob\u002Fmain\u002Fskills\u002Fapple\u002F.vendor\u002Fxcode-disk-cleanup\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fbuidangminh23\u002Fdesign-pro-max\u002Fblob\u002Fmain\u002Fskills\u002Fapple\u002F.vendor\u002Fxcode-disk-cleanup\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":101,"sourceHtmlUrl":102,"categories":103,"keywords":104,"publishedAt":20},"01M7E9T5BN7V6BZE4QKVCCJXKK","xcode-project-analyzer","Audit Xcode project configuration, build settings, scheme behavior, and script phases to find build-time improvements with explicit approval gates. Use when a developer wants project-level build analysis, slow incremental builds, guidance on target dependencies, build settings review, run script phase analysis, parallelization improvements, or module-map and DEFINES_MODULE configuration.","https:\u002F\u002Fgithub.com\u002Fbuidangminh23\u002Fdesign-pro-max\u002Fblob\u002Fmain\u002Fskills\u002Fapple\u002F.vendor\u002Fxcode-build\u002Fxcode-project-analyzer\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fbuidangminh23\u002Fdesign-pro-max\u002Fblob\u002Fmain\u002Fskills\u002Fapple\u002F.vendor\u002Fxcode-build\u002Fxcode-project-analyzer\u002FSKILL.md",[],[],{"skillNo":106,"name":107,"nameZh":6,"description":108,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":109,"sourceHtmlUrl":110,"categories":111,"keywords":112,"publishedAt":20},"01M7E9T17K73CZFF5ZJ3B8VT79","xcode-compilation-analyzer","Analyze Swift and mixed-language compile hotspots using build timing summaries and Swift frontend diagnostics, then produce a recommend-first source-level optimization plan. Use when a developer reports slow compilation, type-checking warnings, expensive clean-build compile phases, long CompileSwiftSources tasks, warn-long-function-bodies output, or wants to speed up Swift type checking.","https:\u002F\u002Fgithub.com\u002Fbuidangminh23\u002Fdesign-pro-max\u002Fblob\u002Fmain\u002Fskills\u002Fapple\u002F.vendor\u002Fxcode-build\u002Fxcode-compilation-analyzer\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fbuidangminh23\u002Fdesign-pro-max\u002Fblob\u002Fmain\u002Fskills\u002Fapple\u002F.vendor\u002Fxcode-build\u002Fxcode-compilation-analyzer\u002FSKILL.md",[],[]]