- Update skill count to 170, Python tools to 213, references to 314 across all docs
- Regenerate all 170 skill doc pages from latest SKILL.md sources
- Update CLAUDE.md with v2.1.1 highlights, accurate architecture tree, and roadmap
- Update README.md badges and overview table
- Update marketplace.json metadata description and version
- Update mkdocs.yml, index.md, getting-started.md with correct numbers
Write subtitle (iOS) or short description (Android):
Focus on primary benefit
Include secondary keyword
Use action verbs
Optimize keyword field (iOS only):
Remove duplicates from title
Remove plurals (Apple indexes both forms)
No spaces after commas
Prioritize by score
Rewrite full description:
Hook paragraph with value proposition
Feature bullets with keywords
Social proof section
Call to action
Validate character counts for each field
Calculate keyword density (target 2-3% primary)
Validation: All fields within character limits; primary keyword in title; no keyword stuffing (>5%); natural language preserved
Platform Character Limits
Field
Apple App Store
Google Play Store
Title
30 characters
50 characters
Subtitle
30 characters
N/A
Short Description
N/A
80 characters
Keywords
100 characters
N/A
Promotional Text
170 characters
N/A
Full Description
4,000 characters
4,000 characters
What's New
4,000 characters
500 characters
Description Structure
PARAGRAPH 1: Hook (50-100 words)
├── Address user pain point
├── State main value proposition
└── Include primary keyword
PARAGRAPH 2-3: Features (100-150 words)
├── Top 5 features with benefits
├── Bullet points for scanability
└── Secondary keywords naturally integrated
PARAGRAPH 4: Social Proof (50-75 words)
├── Download count or rating
├── Press mentions or awards
└── Summary of user testimonials
PARAGRAPH 5: Call to Action (25-50 words)
├── Clear next step
└── Reassurance (free trial, no signup)
TEST ID: ASO-2025-001
ELEMENT: App Icon
HYPOTHESIS: A bolder color icon will increase conversion by 10%
START DATE: [Date]
END DATE: [Date]
RESULTS:
├── Control CVR: 4.2%
├── Treatment CVR: 4.8%
├── Lift: +14.3%
├── Significance: 97%
└── Decision: Implement treatment
LEARNINGS:
- Bold colors outperform muted tones in this category
- Apply to screenshot backgrounds for next test
Before/After Examples
Title Optimization
Productivity App:
Version
Title
Analysis
Before
"MyTasks"
No keywords, brand only (8 chars)
After
"MyTasks - Todo List & Planner"
Primary + secondary keywords (29 chars)
Fitness App:
Version
Title
Analysis
Before
"FitTrack Pro"
Generic modifier (12 chars)
After
"FitTrack: Workout Log & Gym"
Category keywords (27 chars)
Subtitle Optimization (iOS)
Version
Subtitle
Analysis
Before
"Get Things Done"
Vague, no keywords
After
"Daily Task Manager & Planner"
Two keywords, benefit clear
Keyword Field Optimization (iOS)
Before (Inefficient - 89 chars, 8 keywords):
task manager, todo list, productivity app, daily planner, reminder app
MyTasks is a comprehensive task management solution designed
to help busy professionals organize their daily activities
and boost productivity.
After:
Forget missed deadlines. MyTasks keeps every task, reminder,
and project in one place—so you focus on doing, not remembering.
Trusted by 500,000+ professionals.
Improvements:
Leads with user pain point
Specific benefit (not generic "boost productivity")