app-clips

Implement iOS App Clip invocation, App Store Connect experiences, and data migration.

Updated May 6, 2026
One-click install
npx skills add https://github.com/Roy-wonji/claude-config --skill app-clips-roy-wonji
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: app-clips
Source: https://github.com/Roy-wonji/claude-config/tree/main/skills/swift-ios-skills/skills/app-clips
Command: npx skills add https://github.com/Roy-wonji/claude-config --skill app-clips-roy-wonji

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you implement iOS App Clips correctly so users can open lightweight entry experiences via invocation URLs, QR/NFC codes, or Smart Banners, and then transition to the full app without losing context.

Core Features & Use Cases

  • Invocation URL handling: Routes NSUserActivityTypeBrowsingWeb to the correct in-clip context and ensures the full app handles the same invocations.
  • Experience and capability setup: Guides App Store Connect setup for default/demo/advanced experiences, associated domains, and required entitlements.
  • Data handoff to the full app: Uses shared App Groups (and keychain/Sign in with Apple patterns) to migrate ephemeral App Clip data to the full app.
  • Safety guardrails for App Clip constraints: Covers binary size limits, ephemeral lifecycle, and what capabilities are/aren’t available.

Quick Start

Ask for an App Clip plan: “Design an App Clip for our SwiftUI TCA iOS app (iOS 17+ with advanced location support) including invocation URL routing, App Store Connect experience setup, shared App Group data migration, and a final review checklist.”

Frequently Asked Questions about app-clips

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate App Clip data to the full iOS app using shared App Groups?

App Clip data migration uses shared App Groups alongside keychain and Sign in with Apple patterns to transfer ephemeral user data to the full app. This ensures context is preserved during the transition without losing user state.

How do I configure App Store Connect experiences for an iOS App Clip?

Configuring App Store Connect experiences involves setting up default, demo, and advanced experiences for the App Clip target. You must also configure associated domains, AASA hosting, and required target entitlements to enable invocation.

How do I handle App Clip invocation URLs from NFC or QR codes?

App Clip invocation URLs from NFC or QR codes are routed by handling NSUserActivityTypeBrowsingWeb. You wire NSUserActivity or scene continuation to route users to the correct in-clip context based on the invocation URL.

What are the binary size limits and constraints for iOS App Clips?

iOS App Clips have strict binary size limits and an ephemeral lifecycle restricting available capabilities. You must perform size-limit verification and understand what capabilities are available versus unavailable before deployment.

Do I need associated domains and AASA hosting to launch an App Clip?

Associated domains and AASA hosting are required for App Clips when using advanced invocation URLs. You need to host the Apple App Site Association file to properly route users from web links to the App Clip experience.

How do I promote the full app from within an App Clip using SKOverlay?

Promoting the full app within an App Clip uses SKOverlay to display an installation banner. This guides users to download the full app while maintaining their current context for seamless data handoff.