TipKit Generator

Generate a complete TipKit setup for contextual tips and feature discovery, including tip definitions, rules, display frequency, inline and popover presentation, and testing utilities.

When This Skill Activates

Use this skill when the user:

• Asks to "add tips" or "add TipKit"
• Mentions "contextual tips" or "feature discovery"
• Wants "popover tips" or "inline tips"
• Asks about "coach marks" or "user education"
• Mentions "onboarding hints" or "tip prompts"
• Wants to "highlight new features" or "guide users"

Pre-Generation Checks

1. Project Context Detection

• Check deployment target (TipKit requires iOS 17+ / macOS 14+)
• Identify if SwiftUI or UIKit project
• Find App entry point location for Tips.configure()
• Check for existing TipKit implementations

2. Conflict Detection

Search for existing TipKit usage:

Glob: **/*Tip*.swift
Grep: "import TipKit" or "Tips.configure"

If found, ask user:

• Extend existing tip infrastructure?
• Replace existing tips?

Configuration Questions

Ask user via AskUserQuestion:

1. What features need tips?

   • List the features or UI elements that should have tips
   • Example: "search bar, filter button, swipe-to-delete gesture"

2. Tip presentation style? (per tip or general preference)

   • Inline (TipView embedded in layout)
   • Popover (attached to a control)
   • Both

3. Rule types needed?

   • Parameter-based (show after user meets condition, e.g., has viewed a screen 3 times)
   • Event-based (show after user performs an action N times)
   • Both

4. Display frequency?

   • Immediate (tips show as soon as eligible)
   • Hourly
   • Daily
   • Weekly
   • Monthly

5. Tip ordering?

   • Independent (tips show whenever eligible)
   • Ordered (use TipGroup to show tips in sequence)

Generation Process

Step 1: Read Templates

Read the templates file for code patterns:

Read("skills/generators/tipkit-generator/templates.md")