usage-insights
Generates user-facing usage statistics, activity summaries, and personalized insights dashboards (weekly recaps, year-in-review, Spotify Wrapped-style). Use when user wants to show usage stats, activity insights, or shareable recap screens. Different from analytics-setup which sends data to a backend — this shows insights to the USER on-device.
npx skills add rshankras/claude-code-apple-skills --skill usage-insights --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Usage Insights Generator Generate a production usage insights system that records user activity events with SwiftData, computes personalized insights (streaks, most active day, top categories), and displays them in a dashboard with insight cards, period pickers, trend indicators, and optional shareable recap screens. ## When This Skill Activates Use this skill when the user: - Asks to "show usage statistics" or "add usage stats" - Wants "user insights" or "activity insights" - Mentions "activity summary" or "weekly summary" - Asks about a "usage dashboard" or "insights dashboard" - Wants a "weekly recap" or "monthly recap" - Mentions "year in review" or "year-in-review" - Asks for "Spotify Wrapped style" or "Wrapped-style recap" - Wants to "show the user their activity" or "personalized stats" ## Pre-Generation Checks ### 1. Project Context Detection - [ ] Check Swift version (requires Swift 5.9+) - [ ] Check deployment target (iOS 17+ / macOS 14+ for @Observable and SwiftData) - [ ] Identify source file locations - [ ] Check for Swift Charts availability (iOS 16+ / macOS 13+, but recommend iOS 17+) ### 2. Conflict Detection Search for existing usage tracking or insights code: ``
- When This Skill Activates
- Pre-Generation Checks
- 1. Project Context Detection
- 2. Conflict Detection
- 3. Data Layer Detection
- Configuration Questions
- Generation Process
- Step 1: Read Templates
- Step 2: Create Core Data Files
- Step 3: Create Calculation Engine
- Step 4: Create UI Files
- Step 5: Create Optional Files
- Step 6: Determine File Location
- Output Format
What does the usage-insights skill do?
Generates user-facing usage statistics, activity summaries, and personalized insights dashboards (weekly recaps, year-in-review, Spotify Wrapped-style). Use when user wants to show usage stats, activity insights, or shareable recap screens. Different from analytics-setup which sends data to a backend — this shows insights to the USER on-device.
How do I install it?
Run `npx skills add rshankras/claude-code-apple-skills --skill usage-insights --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From rshankras/claude-code-apple-skills, a repository with 589 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.