Index of every page on this site: llms.txt
All skills
rshankras avatar

/paywall-generator

@f958982
Run it yourself

Generates StoreKit 2 subscription paywall with modern SwiftUI views. Use when user wants to add subscriptions, paywall, or in-app purchases.

Use this Skill: https://skilld.dev/gh/rshankras/claude-code-apple-skills/paywall-generator

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈40 tokens for metadata: the name and description. ≈1.5k when used: this file. ≈2.3k more on demand in 1 file.

Description uses 2.0% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈160 characters, or 2.0%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Paywall Generator

Generate a complete StoreKit 2 subscription paywall with modern SwiftUI views, subscription status tracking, and proper purchase handling.

When This Skill Activates

Use this skill when the user:

  • Asks to "add subscriptions" or "add paywall"
  • Mentions "in-app purchases" or "IAP"
  • Wants "StoreKit 2" implementation
  • Asks about "subscription management"
  • Mentions "premium features" or "pro version"

Paywall Design Principles (Apple's Data)

  • Keep sign-up to 3-4 taps. Per Apple's Tech Talk: 61% conversion at 3 taps, 48% at 4 — collapsing to 7% at 9 taps.
  • Make the paywall glanceable — value proposition, price, and renewal/trial terms in one view, no scrolling to find the price.
  • Show clear renewal and trial terms everywhere you pitch the subscription, not just on the paywall.
  • Persistent entry point over pop-ups — a tasteful, always-available subscribe button (plus subscribe/manage in Settings). Pop-ups train users to dismiss.
  • Trigger the offer at moments of interest — when the user taps locked content, not on a timer.
  • Offer 3-4 duration tiers so users self-select their commitment level.
  • Let users experience value first — free trial (works best for known brands), freemium, or content sampling (e.g., N free articles per month).

Pre-Generation Checks

1. Project Context Detection

  • Check for existing StoreKit implementations
  • Check deployment target (StoreKit 2 requires iOS 15+)
  • Look for existing product IDs in codebase
  • Identify source file locations

2. Conflict Detection

Search for existing StoreKit:

Glob: **/*Store*.swift, **/*Purchase*.swift, **/*Subscription*.swift
Grep: "import StoreKit" or "Product.products"

If found, ask user:

  • Replace existing implementation?
  • Extend with additional features?

Apple Docs Reference

StoreKit subscription APIs (iOS 18.4+):

  • SubscriptionOfferView - New SwiftUI view for merchandising subscriptions
  • subscriptionStatusTask modifier for tracking subscription state
  • Transaction.currentEntitlements(for:) - per-product entitlement check (iOS 18.4+)
  • RenewalInfo enhancements for expiration reasons

Configuration Questions

Ask user via AskUserQuestion:

  1. Subscription tiers? (multi-select)

    • Monthly
    • Yearly (with discount)
    • Lifetime
    • Weekly
  2. Features needed?

    • Free trial
    • Family sharing
    • Promotional offers
  3. UI style?

    • Full paywall screen
    • Inline subscription view
    • Both

Generation Process

Step 1: Create Core Files

Generate these files:

  1. StoreKitManager.swift - Product loading and purchasing
  2. SubscriptionStatus.swift - Status tracking
  3. PaywallView.swift - Full paywall UI
  4. SubscriptionButton.swift - Individual plan button

Step 2: Create Configuration

  • Products.swift - Product ID constants

Step 3: Determine File Location

Check project structure:

  • If Sources/ exists → Sources/Store/
  • If App/ exists → App/Store/
  • Otherwise → Store/

Product ID Setup

App Store Connect

  1. Go to App Store Connect > Your App > Subscriptions
  2. Create subscription group
  3. Add subscription products with IDs like:
    • com.yourapp.subscription.monthly
    • com.yourapp.subscription.yearly
    • com.yourapp.subscription.lifetime

StoreKit Configuration (Testing)

Create Products.storekit for local testing:

  1. File > New > File > StoreKit Configuration
  2. Add products matching your IDs
  3. Edit scheme > Options > StoreKit Configuration

Output Format

After generation, provide:

Files Created

Sources/Store/
├── StoreKitManager.swift        # Product loading & purchasing
├── SubscriptionStatus.swift     # Status enum & tracking
├── Products.swift               # Product ID constants
└── Views/
    ├── PaywallView.swift        # Full paywall screen
    ├── SubscriptionButton.swift # Plan selection button
    └── SubscriptionOfferCard.swift # iOS 18.4+ view

Integration Steps

App Entry Point:

@main
struct MyApp: App {
    @State private var subscriptionStatus: SubscriptionStatus = .unknown

    var body: some Scene {
        WindowGroup {
            ContentView()
                .environment(\.subscriptionStatus, subscriptionStatus)
                .subscriptionStatusTask(for: "your.group.id") { statuses in
                    subscriptionStatus = SubscriptionStatus.from(statuses)
                }
        }
    }
}

Show Paywall:

struct ContentView: View {
    @State private var showPaywall = false
    @Environment(\.subscriptionStatus) var status

    var body: some View {
        VStack {
            if status != .subscribed {
                Button("Upgrade to Pro") {
                    showPaywall = true
                }
            }
        }
        .sheet(isPresented: $showPaywall) {
            PaywallView()
        }
    }
}

SubscriptionOfferView (iOS 18.4+):

// Simple merchandising view
SubscriptionOfferView(productID: "com.app.subscription.monthly")
    .prefersPromotionalIcon(true)
    .subscriptionOfferViewDetailAction {
        showPaywall = true
    }

Testing Instructions

  1. Create StoreKit Configuration:

    • File > New > StoreKit Configuration
    • Add your products
  2. Edit Scheme:

    • Product > Scheme > Edit Scheme
    • Options > StoreKit Configuration > Select your file
  3. Test Purchases:

    • Run in Simulator
    • Use Transaction Manager (Debug > StoreKit > Transaction Manager)
  4. Test Scenarios:

    • Purchase flow
    • Restore purchases
    • Subscription expiration
    • Renewal

References

  • storekit-patterns.md - Best practices and patterns
  • templates/ - All template files
  • Apple Docs: StoreKit Updates (iOS 18.4+)

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning3mo3 checks · Risk SAFE
  • Gen Agent Trust Hub3mo

    The paywall-generator skill is a development utility for creating StoreKit 2 subscription views. It includes standard SwiftUI templates and management logic. The analysis identified a potential surface for indirect prompt injection as the skill analyzes existing project source files to determine integration points. No malicious code, exfiltration, or unauthorized remote execution was detected.

  • Socket3mo

    No alerts

  • Snyk3mo

    Risk: MEDIUM · 1 issue

Signed by skilld at f958982. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last week.

Activeupdated 4 months ago
What it can do
Reads files Edits files Runs commands
last_verified
2026-07-16
review_by
2027-06-22
os_version
iOS 27 / macOS 27
All 7 allowed tools
ReadWriteEditGlobGrepBashAskUserQuestion

README badge

README badge for rshankras/claude-code-apple-skills/paywall-generator