# Subscription Lifecycle

Generates StoreKit 2 subscription lifecycle management, grace periods, billing retry...

- Repository: https://github.com/rshankras/claude-code-apple-skills (846 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-07-24
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add rshankras/claude-code-apple-skills --skill subscription-lifecycle -g -a claude-code -y`
Codex: `npx skills add rshankras/claude-code-apple-skills --skill subscription-lifecycle -g -a codex -y`
Cursor: `npx skills add rshankras/claude-code-apple-skills --skill subscription-lifecycle -g -a cursor -y`
Gemini CLI: `npx skills add rshankras/claude-code-apple-skills --skill subscription-lifecycle -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add rshankras/claude-code-apple-skills`

## Description

Generates StoreKit 2 subscription lifecycle management, grace periods, billing retry, offer codes, win-back offers, upgrade/downgrade paths, and subscription status monitoring. Use when user needs post-purchase subscription state handling beyond the initial paywall.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Subscription Lifecycle Generator

Generate production StoreKit 2 subscription lifecycle management with real-time status monitoring, grace period handling, billing retry detection, offer code redemption, win-back offers, and upgrade/downgrade path support.

**Different from paywall-generator:** The paywall generator handles the purchase UI and initial transaction. This skill handles everything that happens *after* purchase, monitoring subscription state changes, handling payment failures, retaining churning users, and managing tier transitions.

**Why retention math dominates acquisition (per Apple's Tech Talk):**
- Commission compounds: 70% net in year one → 85% once a subscriber passes 1 year. Retained subscribers are literally worth more per renewal.
- The base compounds harder: from 10,000 subscribers, 12 months later 85% monthly retention leaves 1,673; 90% leaves 3,487; 95% leaves 5,688. A 5-point retention gain more than doubles the surviving base.

## When This Skill Activates

Use this skill when the user:
- Asks about "subscription management" or "subscription lifecycle"
- Mentions "grace period handling" or "grace period UI"
- Wants "billing retry" detection or payment failure handling
- Asks about "win-back offers" or "re-engagement offers"
- Mentions "subscription status" monitoring or dashboard
- Wants "upgrade/downgrade" path management
- Asks about "offer codes" or "promotional offers"
- Mentions "subscription churn" or "retention"
- Wants to "track subscription state changes"

## Pre-Generation Checks

### 1. Project Context Detection
- [ ] Check deployment target (StoreKit 2 requires iOS 15+)
- [ ] Check for @Observable support (iOS 17+ / macOS 14+)
- [ ] Check Swift version (requires Swift 5.9+)
- [ ] Identify source file locations

The rest: https://github.com/rshankras/claude-code-apple-skills/blob/HEAD/skills/generators/subscription-lifecycle/SKILL.md