Apple Targets — скилл

---
name: apple-targets
description: Build, configure, and debug native Apple extension and target types (widgets, App Clips, share extensions, watchOS apps, Safari extensions, notification extensions, VPN/network extensions, and 40+ more) in an Expo app using the @bacons/apple-targets config plugin. Use when a user wants to add home screen presence, share sheets, custom keyboards, Siri/App Intents, push notification handling, AutoFill/passkeys, Screen Time controls, or any other Apple app extension to a React Native / Expo project.
---

# Apple Extension Target Skills Reference

This directory contains comprehensive skill documents for all supported Apple extension and target types. Each skill document provides everything an AI agent needs to understand, implement, and troubleshoot a specific Apple extension type, including:

- Apple documentation links and WWDC session references
- Runtime behavior and lifecycle explanation
- Real-world use cases and implementation patterns
- Production-ready Swift code examples
- Platform availability and version requirements
- Common gotchas and debugging tips

## Installing This Skill

Install this skill into your coding agent (Claude Code, Cursor, Codex, etc.) with [`npx skills`](https://github.com/vercel-labs/skills):

```sh
npx skills add EvanBacon/expo-apple-targets/tree/main/skills/apple-targets
```

The CLI auto-detects which agents you have installed and copies `SKILL.md` (plus the supporting reference docs in this directory) into the agent's skills directory (e.g. `.claude/skills/` or `.agents/skills/`). Once installed, the agent loads this guidance automatically whenever you ask it to build an Apple extension or target.

## How to Use These Skills

**For AI Agents:**

1. **When a user asks about a specific extension type** (e.g., "How do I build a widget?" or "I need to add a share extension"), read the corresponding skill document to get complete implementation guidance.

2. **When planning a feature** that might require an extension (e.g., "Add home screen presence" → read `widget.md`), consult the skill document to understand requirements and constraints.

3. **When debugging extension issues**, refer to the "Gotchas" section of the relevant skill document — these capture common pitfalls from Apple Developer Forums and real-world experience.

4. **When uncertain which extension type fits a use case**, scan the "Use Cases" sections across related skills to find the best match.

**Structure of Each Skill Document:**

Every skill document follows the template defined in `_template.md`:
- **Frontmatter**: Title, one-line description, minimum OS version
- **Apple Documentation**: Official reference links
- **WWDC History**: Session links showing evolution of the feature
- **What It Does**: Step-by-step runtime behavior