shareplay-activities — Claude Code skill: what it does, how to install
Get guidance for building GroupActivities sessions, from shared media playback to syncing app state. Useful when adding collaborative features to Apple-platform apps.
npx skills add dpearson2699/swift-ios-skills --skill shareplay-activities -a claude-codeWhat shareplay-activities does
The skill covers Group Activities setup, defining a GroupActivity, and managing a session as participants join or leave. It explains how to pass small app-state messages with GroupSessionMessenger. Choose reliable delivery for state changes; fast-changing data such as cursor positions can use unreliable delivery.
For shared audio or video, it points to AVPlaybackCoordinator alongside AVPlayer. Activity data and messages must conform to Codable, and each message must stay below 256 KB. Group Activities must be enabled on the app target in Xcode; widgets, extensions, and App Clips cannot use them. That target restriction shapes where the feature can live.
What it helps with
- sync app state across session participants
- handle SharePlay session changes and participant joins
- send small messages to other participants
- coordinate shared audio or video playback
- check group-session eligibility before showing a control
Example prompts for the agent
- Help me add shared video playback with SharePlay and
AVPlayer. - Design game-state updates between participants using
GroupSessionMessenger. - Review the SharePlay session lifecycle and participant connection handling.
How to install shareplay-activities
1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill shareplay-activities -a claude-code2Manually: put the files in place
~/.claude/skills/shareplay-activities/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/shareplay-activities/
1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill shareplay-activities -a codex2Manually: put the files in place
.agents/skills/shareplay-activities/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill shareplay-activities -a cursor2Manually: put the files in place
.cursor/skills/shareplay-activities/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dpearson2699/swift-ios-skills shareplay-activities2Manually: put the files in place
.github/skills/shareplay-activities/SKILL.md1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill shareplay-activities -a gemini-cli2Platform CLI
gemini skills install https://github.com/dpearson2699/swift-ios-skills --path skills/shareplay-activitiesManually: put the files in place
.devin/skills/shareplay-activities/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill shareplay-activities -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 shareplay-activities
How do I install shareplay-activities in Claude Code?
Run npx skills add dpearson2699/swift-ios-skills --skill shareplay-activities -a claude-code. The skill file is installed at ~/.claude/skills/shareplay-activities/SKILL.md.
What does shareplay-activities do?
It guides implementation of SharePlay features with GroupActivities, including session management, participant messaging, and coordinated media playback.
What are the message requirements?
Messages must conform to Codable and remain under 256 KB. Use reliable delivery for state-changing actions and unreliable delivery for transient, frequently updated data.