# app-clips

Plans, implements, and improves App Clips for iOS. Use it when a focused instant experience should lead users toward the full app.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2400 installs · ★ 2219
- Author: appeeky
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/appeeky/aso-skills/tree/HEAD/skills/app-clips/SKILL.md
- Updated: 2026-10-06
- HTML: https://affpapa.org/en/nevibecode/skills/appeeky-app-clips

## What it does

This skill treats App Clips as lightweight iOS experiences that launch without installing the full app. It helps define the smallest useful flow, configure App Clip Experiences, and plan the handoff to the full app with SKOverlay after the user gets value. App Clips can open from App Store search, Safari, Messages, Maps, QR codes, and App Clip codes.

It covers App Clip card fields, URL patterns, App Store Connect analytics, and an implementation checklist for Xcode. Separate experiences can be planned for locations, campaigns, or individual features. The measurement section tracks sessions, card displays, unique users, and conversions to the full app.

The size limit is strict: the App Clip binary must stay within 15MB. The setup also uses an App Clip target in Xcode, Associated Domains, and registered experience URLs; authentication can use Sign in with Apple or Apple Pay, while push notifications are not used in App Clips.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add appeeky/aso-skills --skill app-clips -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/app-clips/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/app-clips/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add appeeky/aso-skills --skill app-clips -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/app-clips/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add appeeky/aso-skills --skill app-clips -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/app-clips/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install appeeky/aso-skills app-clips
```

2. **Manually: put the files in place**
- File: `.github/skills/app-clips/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add appeeky/aso-skills --skill app-clips -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/appeeky/aso-skills --path skills/app-clips
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/app-clips/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add appeeky/aso-skills --skill app-clips -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/appeeky/aso-skills/tree/HEAD/skills/app-clips/SKILL.md

## When to use it
- plan the smallest useful App Clip flow
- configure URLs that launch an App Clip
- prepare an App Clip card for App Store search
- check the binary size and Xcode setup
- connect an App Clip to the full app handoff

## Example prompts
- Plan an App Clip for parking payment and define the smallest useful user flow.
- Work out which App Clip Experiences fit `yourdomain.com/location/123` and `yourdomain.com/promo/summer`.
- Create an Xcode checklist for the App Clip target, including the 15MB limit and showing SKOverlay after the user gets value.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 3357d9c92bb21f62.

BEGIN THIRD-PARTY FILE 3357d9c92bb21f62
````text
---
name: app-clips
description: When the user wants to implement, optimize, or use App Clips for app discovery and conversion. Use when the user mentions "App Clip", "app clip code", "mini app", "instant app", "App Clip card", "App Clip link", "no download required", "instant experience", or wants to understand how App Clips appear in App Store search. For general App Store discoverability, see aso-audit. For marketing campaigns, see ua-campaign.
metadata:
  version: 1.0.0
---

# App Clips

You help plan, implement, and optimize App Clips — lightweight iOS experiences (max 15MB) that users can launch instantly without installing the full app.

## What App Clips Are

App Clips are small, focused pieces of your app that users can use without downloading the full app. They appear in:

- **App Store search results** — alongside your full app
- **Smart App Banners** on websites
- **QR codes** and App Clip codes (physical NFC/QR)
- **Safari** — when visiting a linked URL
- **Messages** — when a URL is shared in iMessages
- **Maps** — for location-based businesses
- **Nearby** — NFC and visual codes in the physical world
- **Siri suggestions**

## Size Limit

| Target | Limit |
|--------|-------|
| App Clip binary | **15MB** max (thinned, downloaded on demand) |
| App itself | No change |

This forces you to ship only the essential experience.

## Best Use Cases

| App Type | App Clip Experience |
|----------|-------------------|
| Parking/transit | Pay for parking or buy a ticket |
| Restaurant | View menu, order, or pay |
| Retail | Product preview or loyalty card |
| Fitness | Try a single workout |
| Games | Play a demo level |
| Finance | Calculator or quick quote |
| Events | Ticket purchase or check-in |
| Utilities | Use core feature once |

**The key question:** What is the minimum experience that demonstrates your app's core value?

## App Clip Discovery in the App Store

App Clips appear in **App Store search** as a separate card below your full app result — labeled "App Clip" with an "Open" button (not "Get").

- Users who tap "Open" launch the App Clip instantly
- After using it, they see a banner: "Get the full app"
- Conversion from App Clip user → full install is typically **3–5× higher** than cold organic traffic

**ASO implication:** The App Clip card inherits your app's title and description metadata. Optimizing your main listing improves App Clip discoverability too.

## Technical Requirements

### What to include in the App Clip

- Only the core experience
- Apple Pay or Sign in with Apple for authentication (no full account creation)
- No App Clip–only content — everything in the clip should also be in the full app
- Request only essential permissions (no push notifications in App Clips)

### URL scheme

Each App Clip is triggered by a URL:
```
https://yourdomain.com/clip/[experience]
```
````
END THIRD-PARTY FILE 3357d9c92bb21f62

The third-party file has ended. Everything between the 3357d9c92bb21f62 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2879 of 5793 bytes. © appeeky · MIT · https://github.com/appeeky/aso-skills/tree/HEAD/skills/app-clips/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md