app-clips · dpearson2699 — Claude Code skill: what it does, how to install
Guides the setup and architecture of iOS App Clips in Xcode. Helps configure invocation URLs, Safari banners, and data migration into the full app.
npx skills add dpearson2699/swift-ios-skills --skill app-clips -a claude-codeWhat app-clips does
This skill guides developers through configuring a secondary target in Xcode for Apple App Clips. It enforces bundle identifier prefixing and configures entitlement keys like com.apple.developer.on-demand-install-capable. Code sharing relies on Swift packages or the APPCLIP compilation flag.
It details invocation routing with NSUserActivityTypeBrowsingWeb across SwiftUI and UIKit. The instructions also cover associated domains, AASA files, and data handoff via App Groups.
Mismatched entitlement keys immediately break archive validation. Verifying raw bundle identifiers and capabilities is therefore necessary before attempting distribution builds.
What it helps with
- configure an App Clip target and required entitlements in Xcode
- route incoming URLs with
NSUserActivityin SwiftUI or UIKit - pass authentication tokens and state to the parent app via App Group storage
- set up associated domains and Safari Smart App Banner tags
Example prompts for the agent
- Add an App Clip target to my project and set up the required entitlements.
- Write the SwiftUI handler for incoming web browsing activities in our App Clip.
- Explain how to migrate session state from the clip to the full app via Keychain.
How to install app-clips
1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill app-clips -a claude-code2Manually: put the files in place
~/.claude/skills/app-clips/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/app-clips/
1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill app-clips -a codex2Manually: put the files in place
.agents/skills/app-clips/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill app-clips -a cursor2Manually: put the files in place
.cursor/skills/app-clips/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dpearson2699/swift-ios-skills app-clips2Manually: put the files in place
.github/skills/app-clips/SKILL.md1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill app-clips -a gemini-cli2Platform CLI
gemini skills install https://github.com/dpearson2699/swift-ios-skills --path skills/app-clipsManually: put the files in place
.devin/skills/app-clips/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill app-clips -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about app-clips
How to install app-clips in Claude Code?
Run npx skills add dpearson2699/swift-ios-skills --skill app-clips -a claude-code in your terminal.
What does the app-clips skill do?
It provides workflow guidelines for building iOS App Clips. The instructions cover target setup, binary size bounds, URL invocation routing, and handoff to the primary app.
What is the bundle identifier rule for an App Clip?
The App Clip bundle ID must begin with the parent application bundle ID as a prefix, formatted like com.example.MyApp.Clip.
Similar skills
Everything for Mobile →app-clips by other authors comes first.