Agent skill

In App Events

by appeeky in appeeky/aso-skills

When the user wants to create, plan, or optimize App Store In-App Events — the event cards that appear on the Today tab, search results, and your product page.

MITAuto-check passedMobile

Install In App Events

skills CLI
$ npx skills add appeeky/aso-skills --skill in-app-events -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install appeeky/aso-skills in-app-events --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/appeeky/aso-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/in-app-events .claude/skills/in-app-events && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
in-app-events
GitHub stars
2.2k
Token cost
~1.6k tokens
SKILL.md length
708 words
Files
1
Skills in repo
39
Repo updated
First seen
Licence
MIT

At a glance

When the user wants to create, plan, or optimize App Store In-App Events — the event cards that appear on the Today tab, search results, and your product page.

  • Works in 4 steps: Event Idea Selection → Write Event Copy → Event Card Image → …
  • Wants to create
  • SKILL.md covers What In-App Events Are, Event Types, Event Card Specs and Planning Workflow, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

In App Events is an agent skill from appeeky/aso-skills. When the user wants to create, plan, or optimize App Store In-App Events — the event cards that appear on the Today tab, search results, and your product page. Use when the user mentions "in-app event", "App Store event", "event card", "Today tab", "live event", "challenge", "game event", "seasonal event card", or wants visibility beyond organic search. For general ASO, see aso-audit. For seasonal keyword strategy, see seasonal-aso.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Mobile, covering App store release. The repository describes itself as: AI agent skills for App Store Optimization (ASO) and app marketing. Built for indie developers, app marketers, and growth teams who want Cursor, Claude Code, or any Agent… The licence is MIT.

When your agent uses it

  • Wants to create
  • Optimize App Store In-App Events — the event cards that appear on the Today tab
  • Your product page
  • The user mentions in-app event

Example prompts

  • “in-app event”
  • “App Store event”
  • “event card”
  • “/in-app-events”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Event Idea Selection
  2. Write Event Copy
  3. Event Card Image
  4. Submit in App Store Connect

What it can do on your machine

Read from SKILL.md and the folder at commit 3919d7c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

In App Events loads about 1.6k tokens when it runs. Until then it costs about 113 tokens; SKILL.md has 708 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~113
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from appeeky/aso-skills at commit 3919d7c, republished under its MIT licence (© appeeky). 708 words, ~1,643 tokens.

Download SKILL.mdSave it as .claude/skills/in-app-events/SKILL.md (or your agent's skills folder).
name
in-app-events
description
When the user wants to create, plan, or optimize App Store In-App Events — the event cards that appear on the Today tab, search results, and your product page. Use when the user mentions "in-app event", "App Store event", "event card", "Today tab", "live event", "challenge", "game event", "seasonal event card", or wants visibility beyond organic search. For general ASO, see aso-audit. For seasonal keyword strategy, see seasonal-aso.
metadata.version
1.0.0

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

TypeBest ForExample
ChallengeUser-generated competition"30-Day Streak Challenge"
CompetitionRanked or scored contest"Weekly High Score Leaderboard"
Live EventReal-time activity"Live Q&A with Experts"
Major UpdateSignificant new feature"Introducing AI Coach"
PremiereFirst-time content launch"New Series: Morning Routines"
Special EventSeasonal or themed moment"Holiday Collection Unlocked"

Event Card Specs

FieldLimitNotes
Event name30 charsAppears prominently — keyword-conscious
Short description50 charsBelow the name on cards
Long description120 charsShown in expanded event view
Event card image2160×1080px2:1 ratio, PNG/JPG, no text required
Badge—Chosen from the 6 type badges above
DurationUp to 31 daysStart 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 TypeBest Event Types
GamesChallenge, Competition, Major Update
FitnessChallenge, Live Event, Major Update
ProductivityMajor Update, Premiere
Social / CommunityLive Event, Challenge
Streaming / ContentPremiere, Special Event
UtilityMajor Update, Special Event
  1. 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
Show full SKILL.md (283 more words)Show less
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/end times

Submit 3–5 days before the desired start date to account for review time.

Optimization Tips

Maximize Today Tab Placement

Apple's algorithm favors events that are:

  • Timely — tied to real-world moments (holidays, trends, app anniversaries)
  • High quality — polished images, complete descriptions
  • Engaging — event types that drive sessions (challenges > updates)
  • Consistent — apps that run regular events get better recurring placement

Run at least one event per month to maintain algorithmic eligibility.

Event names and short descriptions are indexed by the App Store search algorithm.

  • Include 1–2 target keywords in the event name naturally
  • The short description can reinforce secondary keywords
  • Use keyword-research skill to validate which terms to include
Re-engagement Notification

Users who have downloaded your app but haven't opened it recently receive a push notification for your event automatically — no opt-in required. This is the highest-value feature of In-App Events.

Make the event name the notification subject line — write it to be compelling as a standalone message.

Output Format

Event Brief
📅 Event: [Name — 30 chars]
   Type:  [Badge type]
   Dates: [Start] → [End]

Copy:
  Short:  [50 chars]
  Long:   [120 chars]

Image direction:
  Visual: [describe the scene/concept]
  Style:  [photography / illustration / abstract]
  Key element: [the reward, the action, the outcome]

Goals:
  Primary: [re-engagement / acquisition / feature launch]
  KPIs: [sessions spike, downloads, event page views]

Submit by: [date — 4 days before start]
Event Calendar (monthly)
Week 1:  [Event name] — [type] — [dates]
Week 2:  [No event / buffer]
Week 3:  [Event name] — [type] — [dates]
Week 4:  [Event name] — [type] — [dates]

Common Mistakes

MistakeFix
App name in event nameLead with the user benefit
Generic image (screenshot of UI)Show the reward/outcome visually
Events shorter than 7 daysMinimum 7 days for Today tab consideration
Submitting day-ofSubmit 4–5 days early for review
No recurring scheduleRun 1+ events/month for sustained placement
  • seasonal-aso — Align event timing with keyword seasonal peaks
  • screenshot-optimization — Apply same visual best practices to event images
  • app-store-featured — Events increase editorial feature eligibility
  • retention-optimization — Track re-engagement lift from events

© appeeky, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/in-app-events of appeeky/aso-skills.

Open the folder on GitHubat commit 3919d7c

Compare with similar skills

In App Events next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

In App Events compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
In App Events this skillappeeky/aso-skills2.2k—~1.6kAutomated safety check: PassMIT
Aso Appstore Screenshotsadamlyttleapps/claude-skill-aso-appstore-screenshots1.8k1 repos~9.6kAutomated safety check: PassMIT
Asc Ppp Pricingrorkai/app-store-connect-cli-skills1.1k3 repos~4.2kAutomated safety check: PassMIT
Maintain Docusaurus Manualmatthiasn/lotti1.2k—~930Automated safety check: PassGPL-3.0
Workbuddy Skin Studiocdredfox/workbuddy-skin-studio197—~1.5kAutomated safety check: PassMIT
App Store AsoTimBroddin/app-store-aso-skill100—~1.5kAutomated safety check: PassMIT

Similar skills

  • Aso Appstore Screenshots

    adamlyttleapps/claude-skill-aso-appstore-screenshots

    Generate high-converting App Store screenshots by analyzing your app's codebase, discovering core benefits, and creating ASO-optimized screenshot images using Nano Banana Pro.

    1.8k GitHub starsUsed in 1 repo~9.6k tokens
    MobileAuto-check passed
  • Asc Ppp Pricing

    rorkai/app-store-connect-cli-skills

    Set territory-specific pricing for subscriptions and in-app purchases using current asc setup, pricing summary, price import, and price schedule commands.

    1.1k GitHub starsUsed in 3 repos~4.2k tokens
    MobileAuto-check passed
  • Maintain a Docusaurus product manual whose prose, navigation, localized page trees, screenshots, coverage metadata, and release build must stay aligned with the application.

    1.2k GitHub stars~930 tokensUpdated today
    MobileAuto-check passed
  • Workbuddy Skin Studio

    cdredfox/workbuddy-skin-studio

    Apply a reversible theme/skin to the WorkBuddy desktop app (Tencent AI office agent) via local Chromium DevTools Protocol (CDP) injection.

    197 GitHub stars~1.5k tokensUpdated 2 mo ago
    MobileAuto-check passed
  • App Store Aso

    TimBroddin/app-store-aso-skill

    Generate optimized Apple App Store metadata recommendations with ASO best practices.

    100 GitHub stars~1.5k tokensUpdated 5 mo ago
    MobileAuto-check passed
  • Marionette Flutter Drive App

    leancodepl/marionette_mcp

    Set up and drive a running Flutter app (debug or profile) with Marionette — an AI agent's hands and eyes for the app.

    482 GitHub stars~11k tokensUpdated 5 days ago
    MobileAuto-check passed

More from appeeky/aso-skills

All 39 skills in this repo
  • Ab Test Store Listing

    appeeky/aso-skills

    When the user wants to A/B test App Store product page elements to improve conversion rate.

    2.2k GitHub stars~1.8k tokensUpdated 4 days ago
    Auto-check passed
  • Android Aso

    appeeky/aso-skills

    When the user wants to optimize their Google Play Store listing — title, short description, full description, keywords, ratings, or Play Store-specific features.

    2.2k GitHub stars~1.7k tokensUpdated 4 days ago
    Auto-check passed
  • App Analytics

    appeeky/aso-skills

    When the user wants to set up, interpret, or improve their app analytics and tracking.

    2.2k GitHub stars~1.6k tokensUpdated 4 days ago
    Auto-check passed
  • App Clips

    appeeky/aso-skills

    When the user wants to implement, optimize, or use App Clips for app discovery and conversion.

    2.2k GitHub stars~1.4k tokensUpdated 4 days ago
    Auto-check passed
  • App Icon Optimization

    appeeky/aso-skills

    When the user wants to design, test, or improve their app icon to increase tap-through rate and conversions in App Store search and browse.

    2.2k GitHub stars~1.5k tokensUpdated 4 days ago
    Auto-check passed
  • App Marketing Context

    appeeky/aso-skills

    When the user wants to create or update their app marketing context document.

    2.2k GitHub stars~910 tokensUpdated 4 days ago
    Auto-check passed

Categories

Questions about In App Events

What does In App Events do?

When the user wants to create, plan, or optimize App Store In-App Events — the event cards that appear on the Today tab, search results, and your product page. In App Events is an agent skill from appeeky/aso-skills. When the user wants to create, plan, or optimize App Store In-App Events — the event cards that appear on the Today tab, search results, and your product page.

When should I use In App Events?

In App Events fits situations like: wants to create; optimize App Store In-App Events — the event cards that appear on the Today tab; your product page; the user mentions in-app event.

How do I install In App Events in Claude Code?

Run `npx skills add appeeky/aso-skills --skill in-app-events -a claude-code`. Or copy the skill folder (skills/in-app-events in appeeky/aso-skills) into .claude/skills/in-app-events in your project. Claude Code loads it when a task matches its description.

How do I install In App Events in Codex?

Run `npx skills add appeeky/aso-skills --skill in-app-events -a codex`. Or copy the skill folder (skills/in-app-events in appeeky/aso-skills) into .agents/skills/in-app-events in your project. Codex loads it when a task matches its description.

Can I use In App Events in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add appeeky/aso-skills --skill in-app-events -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/in-app-events, .gemini/skills/in-app-events, .github/skills/in-app-events and .opencode/skills/in-app-events in your project.

What does In App Events need to run?

SKILL.md names no scripts, command-line tools or credentials: In App Events is instructions for the agent only.

Does In App Events access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is In App Events safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does In App Events use?

In App Events is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does In App Events use?

About 1.6k tokens (SKILL.md is roughly 6.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to In App Events?

Skills that share tags, products or a category with In App Events: Aso Appstore Screenshots (adamlyttleapps/claude-skill-aso-appstore-screenshots, 1.8k stars), Asc Ppp Pricing (rorkai/app-store-connect-cli-skills, 1.1k stars), Maintain Docusaurus Manual (matthiasn/lotti, 1.2k stars) and Workbuddy Skin Studio (cdredfox/workbuddy-skin-studio, 197 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains In App Events?

appeeky (a GitHub organization) maintains it in appeeky/aso-skills, which has 2,163 GitHub stars. The repository holds 39 skills in this directory. The repository was last updated on October 6, 2026.

Source: appeeky/aso-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.