Generators Agent Skill

Code Generators

Production-ready code generators for iOS and macOS apps. Unlike advisory skills (review, audit), these skills generate working code tailored to your project.

When This Skill Activates

Use this skill when the user:

• Wants to add a common app component (logging, analytics, onboarding, etc.)
• Asks to "set up" or "add" infrastructure code
• Mentions replacing print() with proper logging
• Wants to add App Store review prompts
• Needs analytics or crash reporting setup

Key Principles

1. Context-Aware Generation

Before generating code, skills will:

• Read existing project structure and patterns
• Detect deployment targets and Swift version
• Identify architecture patterns (MVVM, TCA, etc.)
• Check for existing implementations to avoid conflicts

2. Protocol-Based Architecture

Provider-dependent code uses protocols for easy swapping:

protocol AnalyticsService { ... }
class TelemetryDeckAnalytics: AnalyticsService { ... }
class FirebaseAnalytics: AnalyticsService { ... }
// Change provider by swapping ONE line

3. Platform Detection

Skills detect iOS vs macOS and App Store vs direct distribution to generate appropriate code.

Available Generators

Read relevant module files based on the user's needs:

logging-setup/

Replace print() statements with structured os.log/Logger.

• Audit existing print() usage
• Generate AppLogger infrastructure
• Migrate print → Logger with proper privacy levels

analytics-setup/

Protocol-based analytics with swappable providers.

• TelemetryDeck, Firebase, Mixpanel support
• NoOp implementation for testing/privacy
• Easy provider switching

onboarding-generator/

Value-moment-first onboarding — races a new user to the first felt experience of the app's promised outcome.

• Branches on ready-now vs. later, one decision per screen
• Root-swap presentation, phase-first gating, resume-safe hand-offs into existing features
• Local-notification implementation intentions for the "later" branch
• Value-moment reach-rate instrumentation (local-only, no analytics SDK required)
• Classic paged/stepped welcome carousel kept as an explicit fallback for explain-first apps

review-prompt/

Smart App Store review prompts.

• Platform detection (skips for non-App Store macOS)
• Configurable trigger conditions
• Smart timing logic
• Debug override for testing

networking-layer/

Protocol-based API client with async/await.

• Clean APIClient protocol for mocking/swapping
• Type-safe endpoint definitions
• Comprehensive error handling
• Environment-based configuration

auth-flow/

Complete authentication flow.

• Sign in with Apple integration
• Biometric authentication (Face ID/Touch ID)
• Secure Keychain storage
• Credential state monitoring

paywall-generator/

StoreKit 2 subscription paywall.

• Full StoreKit 2 implementation
• Product loading, purchasing, restoring
• Subscription status with Environment
• Beautiful paywall UI

settings-screen/

Complete settings screen with modular sections.

• Centralized AppSettings with @AppStorage
• Appearance, Notifications, Account, About, Legal sections
• Cross-platform (iOS/macOS)
• Reusable row components

persistence-setup/

SwiftData persistence with optional iCloud sync.

• SwiftData container configuration
• Repository pattern for testability
• Optional CloudKit/iCloud sync
• Sync status monitoring
• Migration support

error-monitoring/

Protocol-based crash/error reporting.

• Sentry and Firebase Crashlytics support
• NoOp implementation for testing/privacy
• Breadcrumbs for debugging context
• User context (anonymized)
• Easy provider swapping

ci-cd-setup/

CI/CD configuration for automated builds and deployment.

• GitHub Actions workflows (build, test, TestFlight, App Store)
• Xcode Cloud scripts and setup guide
• fastlane lanes for advanced automation
• Code signing and secrets management
• macOS notarization support

localization-setup/

Internationalization (i18n) infrastructure for multi-language apps.

• String Catalogs (iOS 16+, recommended)
• Type-safe L10n enum for compile-time safety
• Pluralization and interpolation patterns
• RTL layout support
• SwiftUI preview helpers for testing locales

push-notifications/

Push notification infrastructure with APNs setup.

• Registration and authorization flow
• UNUserNotificationCenterDelegate implementation
• Notification categories with action buttons
• Type-safe payload parsing
• Rich notifications and silent notifications

deep-linking/

Deep linking with URL schemes, Universal Links, and App Intents.

• Custom URL scheme handling
• Universal Links with AASA file
• App Intents for Siri and Shortcuts
• Type-safe route definitions and navigation
• Spotlight indexing support

test-generator/

Test templates for unit, integration, and UI tests.

• Swift Testing (modern, iOS 16+) and XCTest patterns
• Mock object generation
• ViewModel and service testing patterns
• UI testing with page object pattern

preview-data-generator/

Sample data and a multi-variant #Preview matrix for SwiftUI views.

• Canvas sample data with visual edge cases (empty, long strings, missing, list)
• Data-state previews (loaded/empty/loading/error) for UI prototyping
• Appearance, Dynamic Type, locale/RTL, and device variant matrix
• SwiftData in-memory seeded containers; iOS 18 PreviewModifier + @Previewable
• Reuses test-data-factory fixtures instead of duplicating them

accessibility-generator/

Accessibility infrastructure for inclusive apps.

• VoiceOver labels, hints, and traits
• Dynamic Type support with scaling
• Reduce Motion handling
• Accessibility audit checklist

widget-generator/

WidgetKit widgets for home screen and lock screen.

• Static and interactive widgets (iOS 17+)
• Timeline providers
• Lock screen complications
• Widget intents for configuration

app-icon-generator/

Programmatic app icon generation using CoreGraphics.

• Apple HIG compliant icon design
• Category-aware design recipes (productivity, media, dev tools, etc.)
• 3 variant generation for user selection
• Automatic resizing to all required sizes (macOS + iOS)
• Asset catalog installation with correct Contents.json
• No external dependencies — pure CoreGraphics

feature-flags/

Feature flag infrastructure with local and remote support.

• Protocol-based service with swappable providers
• Local defaults with remote override (composite provider)
• @Observable manager for SwiftUI integration
• Debug menu for toggling flags

live-activity-generator/

ActivityKit Live Activity with Dynamic Island and Lock Screen.

• ActivityAttributes and ContentState definitions
• Dynamic Island layouts (compact and expanded)
• Lock Screen presentation
• Push-to-update support via APNs
• Activity lifecycle management (start, update, end)

tipkit-generator/

TipKit inline and popover tips with rules and testing.

• Inline and popover tip definitions
• Rule-based display logic (parameter and event rules)
• Display frequency and invalidation
• Testing and preview support

cloudkit-sync/

CKSyncEngine-based CloudKit sync (iOS 17+).

• CKSyncEngine setup and delegate
• Record zone management
• Conflict resolution strategies
• Sharing and collaboration support

http-cache/

HTTP caching layer with Cache-Control, ETag, and offline fallback.

• Cache-Control header parsing
• ETag/Last-Modified conditional requests (304)
• Stale-while-revalidate pattern
• Decorator pattern wrapping existing APIClient
• Network reachability for offline fallback

pagination/

Pagination infrastructure with offset and cursor patterns.

• Offset-based and cursor-based response models
• State machine (idle, loading, loaded, error, exhausted)
• @Observable PaginationManager with prefetch threshold
• Searchable pagination with debounced query
• Infinite scroll, load-more button, and state views

image-loading/

Image loading pipeline with caching and CachedAsyncImage view.

• NSCache memory cache with auto-eviction
• LRU disk cache with expiration
• Actor-based downloader with request deduplication
• ImageIO thumbnail generation
• Drop-in CachedAsyncImage SwiftUI replacement
• Collection prefetching

share-card/

Shareable image cards for social media sharing.

• ShareCardContent protocol with achievement, statistics, and quote types
• ImageRenderer-based card generation
• Configurable styles (minimal, branded, statistics)
• ShareLink integration and QR code overlay

social-export/

Export content to social platforms with correct formats.

• Platform-specific formatting (Instagram, TikTok, X)
• Aspect ratio and resolution handling per platform
• Branding overlay and caption support
• URL scheme-based and share sheet export

subscription-lifecycle/

StoreKit 2 subscription lifecycle management.

• Grace period and billing retry handling
• Win-back and promotional offer management
• Subscription status monitoring with Transaction.updates
• Upgrade/downgrade path handling
• Dashboard UI for subscription management

referral-system/

Referral and invite system with viral growth mechanics.

• Unique code generation with fraud prevention
• Deep link-based sharing and redemption
• Reward tracking for referrer and invitee
• Dashboard with referral statistics

watermark-engine/

Watermark overlays for images with paywall integration.

• Text, image, and tiled watermark styles
• CoreGraphics-based rendering with Retina support
• Subscription-gated watermark removal
• SwiftUI overlay and ViewModifier

streak-tracker/

Daily/weekly streak tracking with engagement mechanics.

• SwiftData-based activity recording
• Timezone-aware day boundary calculations
• Streak freeze/protection passes
• Calendar heat map and badge views
• Streak-at-risk notifications

milestone-celebration/

Achievement celebrations with confetti and badges.

• CAEmitterLayer confetti with Reduce Motion support
• Milestone tracking with threshold detection
• Badge collection grid with progress rings
• Haptic feedback integration

whats-new/

What's New screen shown after app updates.

• Version tracking with UserDefaults persistence
• Paged TabView feature highlights
• Local and remote content providers
• Auto-present as sheet on version change

lapsed-user/

Lapsed user detection and re-engagement.

• Configurable inactivity thresholds (7/14/30 days)
• Personalized return experience by lapse category
• Win-back offer screen for lapsed subscribers
• ViewModifier for auto-detection on app launch

usage-insights/

User-facing usage statistics and activity summaries.

• SwiftData event recording with batch writes
• Insight calculation (streaks, top categories, trends)
• Dashboard with Swift Charts integration
• Shareable recap cards (Spotify Wrapped-style)

variable-rewards/

Variable reward system with gamification mechanics.

• Weighted probability reward pools with rarity tiers
• Daily spin wheel and mystery box animations
• Daily/weekly caps for ethical engagement
• Reward history and notification views

consent-flow/

GDPR/CCPA/DPDP privacy consent management.

• Granular per-category consent (analytics, marketing, etc.)
• ATT (App Tracking Transparency) integration
• Consent audit logging for compliance
• Banner and preferences UI with equal prominence

account-deletion/

Apple-compliant account deletion flow.

• Multi-step confirmation with re-authentication
• Data export before deletion
• Grace period with cancellation option
• Keychain cleanup and Sign in with Apple revocation

permission-priming/

Pre-permission priming screens for higher grant rates.

• Unified permission manager (notifications, camera, location, etc.)
• Benefit-focused priming UI before system prompt
• Permission status tracking with Settings redirect
• Gated content ViewModifier

force-update/

Minimum version enforcement with update prompts.

• Remote JSON and App Store lookup version checking
• Hard block (required) and soft prompt (recommended)
• Configurable check frequency
• Skip tracking for soft updates

state-restoration/

State preservation and restoration across app launches.

• NavigationPath, tab selection, scroll position persistence
• Codable AppState with debounced auto-save
• Form draft manager with auto-save
• @SceneStorage and file-based storage options

debug-menu/

Developer debug menu (DEBUG builds only).

• Feature flag toggles and environment switcher
• Network request logger with circular buffer
• Cache clearing and diagnostic info export
• Shake gesture and hidden tap triggers

offline-queue/

Offline operation queue with automatic retry.

• Actor-based queue manager with FIFO + priority
• File-based persistence for queued operations
• Exponential backoff with jitter retry policy
• NWPathMonitor connectivity detection
• Offline status banner ViewModifier

feedback-form/

In-app feedback collection with smart routing.

• Category-based feedback (bug, feature, praise)
• Screenshot capture and annotation
• Sentiment routing (happy → App Store, unhappy → support)
• Email and webhook submission

announcement-banner/

In-app announcement banners with remote configuration.

• Priority-based banner display (info, warning, promotion)
• Local and remote announcement providers
• Deep link and URL action handling
• Scheduled display with date ranges

quick-win-session/

Guided first-action flows for fast time-to-value.

• Step-by-step task guidance
• Spotlight hint overlays with cutout circles
• Completion celebration with timing stats
• ViewModifier for new user detection

spotlight-indexing/

Core Spotlight indexing for system search integration.

• SpotlightIndexable protocol for any model
• Actor-based batch index manager
• Fluent attribute builder API
• Search continuation and Siri suggestions

app-clip/

App Clip target with invocation and upgrade flow.

• Invocation URL parsing and routing
• Experience protocol with concrete implementations
• Location confirmation for physical invocations
• SKOverlay full app upgrade prompt
• App Group data sharing

screenshot-automation/

Automated App Store screenshot generation.

• XCUITest-based screen capture with navigation
• Localized caption overlays with CoreText
• Device frame compositing
• Multi-locale, multi-device batch export

background-processing/

Background task infrastructure with BGTaskScheduler.

• BGAppRefreshTask and BGProcessingTask setup
• Background URLSession for downloads/uploads
• Silent push notification handling
• Energy-efficient scheduling strategies

app-extensions/

App extension targets for Share, Action, Keyboard, and Safari.

• Share Extension with content handling
• Action Extension for in-place content manipulation
• Keyboard Extension with UIInputViewController
• Safari Web Extension with message handler
• App Group data sharing between app and extension

data-export/

Data export/import infrastructure with JSON, CSV, and PDF support.

• Protocol-based multi-format export (DataExportable)
• CSV generation with RFC 4180 compliance
• PDF report generation with UIGraphicsPDFRenderer
• File import with UTType-based parsing
• GDPR Article 20 data portability compliance

How to Use

• User requests a component (e.g., "add logging to my app")
• Read the relevant skill's SKILL.md
• Run pre-generation checks (conflicts, deployment target, etc.)
• Ask configuration questions via AskUserQuestion
• Generate code from templates, adapting to project context
• Provide integration instructions

Output Format

After generation, always provide:

• Files created (with full paths)
• Integration steps (how to wire into existing code)
• Required capabilities (entitlements, dependencies)
• Testing instructions (how to verify it works)