activitykit — Claude Code skill for iOS Live Activities
Build and review iOS Live Activities and Dynamic Island interfaces with ActivityKit. Useful for app states that need to stay visible and change over time.
npx skills add dpearson2699/swift-ios-skills --skill activitykit -a claude-codeWhat activitykit does
This skill covers the Live Activity lifecycle: defining fixed attributes and a changing ContentState, requesting an activity, sending updates, and ending it when the tracked event is over. It also guides the Lock Screen presentation and Dynamic Island layouts. The full state is serialized on every update, so keeping it small matters.
For remote updates, the skill explains how to validate APNs state against the ContentState model. Check the host app capability and set NSSupportsLiveActivities = YES before starting. The ActivityContent lifecycle examples require iOS 16.2 or later.
What it helps with
- define fixed attributes and changing activity state
- implement Live Activity creation, updates, and termination
- review Lock Screen and Dynamic Island presentations
- check that APNs payload state matches
ContentState
Example prompts for the agent
- Build a delivery Live Activity with an updateable step and arrival time.
- Review the ActivityKit lifecycle and end the activity when the event is cancelled.
- Check that the APNs state matches
ContentState.
How to install activitykit
1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill activitykit -a claude-code2Manually: put the files in place
~/.claude/skills/activitykit/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/activitykit/
1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill activitykit -a codex2Manually: put the files in place
.agents/skills/activitykit/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill activitykit -a cursor2Manually: put the files in place
.cursor/skills/activitykit/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dpearson2699/swift-ios-skills activitykit2Manually: put the files in place
.github/skills/activitykit/SKILL.md1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill activitykit -a gemini-cli2Platform CLI
gemini skills install https://github.com/dpearson2699/swift-ios-skills --path skills/activitykitManually: put the files in place
.devin/skills/activitykit/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill activitykit -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 activitykit
How do I install activitykit in Claude Code?
Run npx skills add dpearson2699/swift-ios-skills --skill activitykit -a claude-code. The skill file is at ~/.claude/skills/activitykit/SKILL.md.
What does activitykit do?
It helps implement and review ActivityKit Live Activities and Dynamic Island layouts, including state modeling, updates, and ending an activity.
Which iOS version do the ActivityContent examples require?
The lifecycle examples using ActivityContent require iOS 16.2 or later.