In App Events
Plan, write, and schedule App Store In-App Event cards for Today tab, search, and product-page visibility without extra paid media.
Overview
In-App Events is an agent skill most often used in Launch (also Grow lifecycle) that plans and optimizes App Store In-App Event cards for Today tab, search, and product-page discovery.
Install
npx skills add https://github.com/eronred/aso-skills --skill in-app-eventsWhat is this skill?
- Covers four event types: Challenge, Competition, Live Event, and Major Update with positioning examples
- Maps placement across Today tab, search results, product page, and personalized re-engagement for lapsed users
- Event copy and planning workflow for time-limited cards that drive installs and win-back opens
- Cross-links to aso-audit for full-store review and seasonal-aso for keyword timing
- Supports seasonal and live campaigns as discovery beyond keyword-only ASO
- 4 event types: Challenge, Competition, Live Event, Major Update
Adoption & trust: 1k installs on skills.sh; 1.5k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You rely on organic search alone and miss App Store surfaces that promote time-limited content to new users and dormant installs.
Who is it for?
Indie iOS apps shipping features, challenges, or live moments and wanting store-native visibility beyond keywords.
Skip if: Android-only or web-only products with no App Store listing, or teams that only need a full-store ASO pass without event planning.
When should I use this skill?
User mentions in-app event, App Store event, event card, Today tab, live event, challenge, game event, or seasonal event card—or wants visibility beyond organic search.
What do I get? / Deliverables
You leave with typed event concepts, copy direction, and placement strategy aligned to Apple’s event formats—then validate the wider listing with aso-audit if needed.
- Event type and positioning recommendation
- Event title and description copy direction
- Timing and placement checklist for App Store Connect
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
In-App Events are a native App Store launch and discovery surface—canonical shelf is launch/aso where store listing tactics live. ASO subphase covers app-store surfaces including event cards, metadata, and editorial placement alongside organic search.
Where it fits
Draft a Major Update event card when shipping a flagship feature to boost search and Today tab impressions.
Plan a challenge event to notify users who have not opened the app recently.
Shape a timed live-event narrative before committing engineering to a launch-week spectacle.
Align event timing with a broader release beat when organic reach needs a store-native boost.
How it compares
Use for timed App Store event cards; pair with aso-audit for holistic listing review instead of treating events as your only ASO work.
Common Questions / FAQ
Who is in-app-events for?
Solo and indie iOS builders, small teams, and marketers who manage their own App Store presence and want structured help for In-App Event cards.
When should I use in-app-events?
At launch when planning first visibility pushes; before major updates as Major Update events; during Grow when re-engaging lapsed users with challenges or live events; and alongside seasonal campaigns when you want Today tab and search placement.
Is in-app-events safe to install?
Review the Security Audits panel on this Prism page for the ingested package assessment before installing in your agent environment.
Workflow Chain
Then invoke: aso audit, seasonal aso
SKILL.md
READMESKILL.md - In App Events
# In-App Events You help the user plan, write, and optimize **App Store In-App Events** — event cards that surface in search, the Today tab, and the product page, driving installs and re-engagement without paid media. ## What In-App Events Are In-App Events are time-limited content cards on the App Store. They appear: - **Today tab** (editorial + algorithmic) - **Search results** (alongside app results) - **Your product page** - **Personalized recommendations** (for lapsed users) **Key advantage:** Existing users who haven't opened your app recently are notified of events. Non-users see them as discovery. ## Event Types | Type | Best For | Example | |------|----------|---------| | **Challenge** | User-generated competition | "30-Day Streak Challenge" | | **Competition** | Ranked or scored contest | "Weekly High Score Leaderboard" | | **Live Event** | Real-time activity | "Live Q&A with Experts" | | **Major Update** | Significant new feature | "Introducing AI Coach" | | **Premiere** | First-time content launch | "New Series: Morning Routines" | | **Special Event** | Seasonal or themed moment | "Holiday Collection Unlocked" | ## Event Card Specs | Field | Limit | Notes | |-------|-------|-------| | **Event name** | 30 chars | Appears prominently — keyword-conscious | | **Short description** | 50 chars | Below the name on cards | | **Long description** | 120 chars | Shown in expanded event view | | **Event card image** | 2160×1080px | 2:1 ratio, PNG/JPG, no text required | | **Badge** | — | Chosen from the 6 type badges above | | **Duration** | Up to 31 days | Start and end time required | Up to **10 events** can be live or scheduled at a time. ## Planning Workflow ### Step 1 — Event Idea Selection 1. Check for `app-marketing-context.md` 2. Evaluate event type based on app category: | App Type | Best Event Types | |----------|----------------| | Games | Challenge, Competition, Major Update | | Fitness | Challenge, Live Event, Major Update | | Productivity | Major Update, Premiere | | Social / Community | Live Event, Challenge | | Streaming / Content | Premiere, Special Event | | Utility | Major Update, Special Event | 3. Identify the primary goal: - **Re-engagement** → Use notification-triggering events (any type) - **New user acquisition** → Focus on Today tab visibility (Challenge or Competition) - **Feature launch** → Major Update type ### Step 2 — Write Event Copy **Event name (30 chars) — rules:** - Lead with the user benefit or action, not your app name - Include relevant keywords where natural - ✅ "30-Day Habit Challenge" | ❌ "AppName Challenge 2026" **Short description (50 chars):** - Answer "what's in it for me?" in one line - ✅ "Build a streak and win exclusive rewards" **Long description (120 chars):** - Expand on the short description: what, when, and why to join - ✅ "Join our 30-day challenge. Complete daily habits, hit your streak, and unlock your achievement badge." ### Step 3 — Event Card Image Spec: 2160×1080px, 2:1 ratio **Best practices:** - No text needed (name/description appear as overlay) — but a short tagline is allowed - High contrast, bold visual that works at small thumbnail size - Show the outcome or reward, not just the app UI - Test thumbnail at 390×195px to verify legibility ### Step 4 — Submit in App Store Connect 1. App Store Connect → Your App → In-App Events → `+` 2. Fill all required fields + upload image 3. Submit for review (typically 24–48 hours) 4. Schedule start