Agent skills for iOS, iPadOS, Swift, SwiftUI, and modern Apple framework development.
90
90%
Does it follow best practices?
Impact
—
Average score across 248 eval scenarios
Advisory
Suggest reviewing before use
Step-by-step process for identifying, scoring, and maintaining the keyword field for App Store search optimization.
Apple documents the main App Store search signals as text relevance, including matches for the app title, subtitle, keywords, and primary category, plus user behavior such as downloads, ratings, and reviews. Use this table as a practical planning map, not as a precise ranking-weight model:
| Field | Indexed for search? | Controllable per version? | Notes |
|---|---|---|---|
| App name | Yes | Yes (with new version/status permitting) | 30 characters. Choose a distinctive name that hints at what the app does. |
| Subtitle | Yes | Yes (with new version/status permitting) | 30 characters. Summarize value or typical use in a concise phrase. |
| Keyword field | Yes | Yes (with new version/status permitting) | Up to 100 bytes. Use comma-separated terms with no spaces after commas. |
| Primary category | Yes | Yes (with new version/status permitting) | Apple includes the primary category in search relevance. Do not repeat the category name in keywords. |
| Custom Product Page assigned keywords | Yes, for approved visible pages | Yes (in App Store Connect) | Can route matching searches to a custom page instead of the default product page. |
| In-app event name and short description | Visible in Search/event cards | Yes (per event) | Use query-relevant language for the event card, but avoid treating event copy as a hidden keyword field. |
| Description | Conversion-focused | Yes (with new version/status permitting) | Apple's product page guidance says not to add unnecessary keywords to improve search results. |
| Promotional text | No ranking effect | Yes (anytime) | Apple says promotional text does not affect search ranking. Use it for timely conversion messaging. |
| Ratings and reviews | Behavior/search signal | Ongoing | Ratings and reviews influence search and conversion, but review text should be used as customer research rather than keyword stuffing. |
Identify the top 5-10 apps ranking for the primary category terms. For each competitor, note:
Use App Store search autocomplete to discover what users actually type. Start typing a category term and note the suggested completions.
List every term a user might associate with the app's functionality:
Filter this list against competitor findings. Terms that appear in many competitor titles are high-volume but high-competition. Terms that appear in autocomplete but not in competitor metadata represent opportunities.
Run Apple Search Ads discovery campaigns with broad-match keywords matching the primary function. After 2-4 weeks of data:
With each app update:
Score each candidate keyword on three dimensions:
| Dimension | Score range | How to assess |
|---|---|---|
| Relevance | 1-5 | Does the keyword describe what the app actually does? 5 = core function, 1 = tangentially related |
| Volume | 1-5 | Is this term frequently searched? Use Search Ads impression data as a proxy. 5 = high impressions, 1 = minimal |
| Difficulty | 1-5 | How many established apps target this term? 5 = low competition (good), 1 = dominated by major apps |
Decision rule: Include a keyword only if Relevance >= 3. Among qualifying keywords, prioritize by (Relevance x 2) + Volume + Difficulty. This weights relevance heavily while still favoring discoverable, winnable terms.
Disqualify keywords that:
The 100-character keyword field requires careful allocation. Here are allocation patterns for different app types:
Title: FitTrack -- Workout Log (23 chars used)
Subtitle: Exercise & Activity Stats (25 chars used)
Keyword field strategy -- do not repeat: fittrack, workout, log, exercise, activity, stats
gym,training,health,run,step,calorie,weight,strength,cardio,hiit,yoga,plank,squat,routine,progress(96 characters -- 4 remaining, all unique against title/subtitle)
Title: PixelPop -- Photo Editor (24 chars used)
Subtitle: Filters & Retouch Tools (23 chars used)
Keyword field -- do not repeat: pixelpop, photo, editor, filter, retouch, tool
selfie,portrait,collage,crop,blur,preset,enhance,adjust,brightness,contrast,saturation,beauty,skin(99 characters -- all unique against title/subtitle)
Some keywords have seasonal search volume spikes. Plan rotation around predictable events:
| Season/Event | Example keywords to add | When to deploy |
|---|---|---|
| New Year | resolution,goal,habit,new year | December release |
| Back to school | student,school,study,planner | July/August release |
| Holiday shopping | gift,holiday,deal,wish list | October/November release |
| Summer fitness | outdoor,running,summer,beach | April/May release |
| Tax season | tax,receipt,expense,deduction | January/February release |
Rotate 2-3 keyword slots per seasonal cycle. Keep the core 70-80 characters stable and use the remaining 20-30 characters for seasonal experimentation.
Before:
fitness tracker, workout app, best exercise, health and wellness, gymIssues: spaces after commas (-5 chars wasted), "fitness" and "tracker" may duplicate title, "best" and "app" have no search value, "and" is a stop word.
After:
gym,health,run,step,calorie,weight,strength,cardio,hiit,yoga,plank,squat,routine,progress,streakFixes: no spaces, no duplicates of title/subtitle, no filler words, all terms are genuine search queries.
Before (title is "RunMate -- Running Tracker"):
running,tracker,run,jog,marathon,5k,pace,distance,route,gps,heart,rate,training,fitness,healthIssues: "running", "tracker", and "run" duplicate the title -- 17 characters wasted.
After:
jog,marathon,5k,pace,distance,route,gps,heart,rate,training,fitness,health,stride,tempo,intervalFixes: removed title duplicates, added 3 new high-value terms with the recovered space.
.tessl-plugin
skills
accessorysetupkit
references
activitykit
references
adattributionkit
references
alarmkit
references
app-clips
app-intents
references
app-store-optimization
app-store-review
apple-on-device-ai
appmigrationkit
references
audioaccessorykit
references
authentication
references
avkit
references
background-processing
references
browserenginekit
references
callkit
references
carplay
references
cloudkit
references
contacts-framework
references
core-bluetooth
references
core-data
core-motion
references
core-nfc
references
coreml
references
cryptokit
references
cryptotokenkit
references
debugging-instruments
device-integrity
references
dockkit
references
energykit
references
eventkit
references
financekit
references
focus-engine
gamekit
references
healthkit
references
homekit
references
ios-accessibility
ios-localization
ios-networking
ios-simulator
references
mapkit
metrickit
references
musickit
references
natural-language
references
paperkit
references
passkit
references
pdfkit
references
pencilkit
references
permissionkit
references
photokit
push-notifications
realitykit
references
relevancekit
references
scenekit
references
sensorkit
references
speech-recognition
references
spritekit
references
storekit
swift-api-design-guidelines
swift-architecture
swift-charts
references
swift-codable
swift-concurrency
swift-formatstyle
swift-language
swift-security
references
swift-testing
swiftdata
swiftlint
swiftui-animation
swiftui-gestures
references
swiftui-layout-components
swiftui-liquid-glass
references
swiftui-patterns
swiftui-performance
swiftui-uikit-interop
swiftui-webkit
tabletopkit
references
tipkit
references
vision-framework
weatherkit
references
widgetkit
references