Files
claude-skills-reference/marketing-skill/app-store-optimization/HOW_TO_USE.md
Reza Rezvani 93e750a018 docs(skills): add 6 new undocumented skills and update all documentation
Pre-Sprint Task: Complete documentation audit and updates before starting
sprint-11-06-2025 (Orchestrator Framework).

## New Skills Added (6 total)

### Marketing Skills (2 new)
- app-store-optimization: 8 Python tools for ASO (App Store + Google Play)
  - keyword_analyzer.py, aso_scorer.py, metadata_optimizer.py
  - competitor_analyzer.py, ab_test_planner.py, review_analyzer.py
  - localization_helper.py, launch_checklist.py
- social-media-analyzer: 2 Python tools for social analytics
  - analyze_performance.py, calculate_metrics.py

### Engineering Skills (4 new)
- aws-solution-architect: 3 Python tools for AWS architecture
  - architecture_designer.py, serverless_stack.py, cost_optimizer.py
- ms365-tenant-manager: 3 Python tools for M365 administration
  - tenant_setup.py, user_management.py, powershell_generator.py
- tdd-guide: 8 Python tools for test-driven development
  - coverage_analyzer.py, test_generator.py, tdd_workflow.py
  - metrics_calculator.py, framework_adapter.py, fixture_generator.py
  - format_detector.py, output_formatter.py
- tech-stack-evaluator: 7 Python tools for technology evaluation
  - stack_comparator.py, tco_calculator.py, migration_analyzer.py
  - security_assessor.py, ecosystem_analyzer.py, report_generator.py
  - format_detector.py

## Documentation Updates

### README.md (154+ line changes)
- Updated skill counts: 42 → 48 skills
- Added marketing skills: 3 → 5 (app-store-optimization, social-media-analyzer)
- Added engineering skills: 9 → 13 core engineering skills
- Updated Python tools count: 97 → 68+ (corrected overcount)
- Updated ROI metrics:
  - Marketing teams: 250 → 310 hours/month saved
  - Core engineering: 460 → 580 hours/month saved
  - Total: 1,720 → 1,900 hours/month saved
  - Annual ROI: $20.8M → $21.0M per organization
- Updated projected impact table (48 current → 55+ target)

### CLAUDE.md (14 line changes)
- Updated scope: 42 → 48 skills, 97 → 68+ tools
- Updated repository structure comments
- Updated Phase 1 summary: Marketing (3→5), Engineering (14→18)
- Updated status: 42 → 48 skills deployed

### documentation/PYTHON_TOOLS_AUDIT.md (197+ line changes)
- Updated audit date: October 21 → November 7, 2025
- Updated skill counts: 43 → 48 total skills
- Updated tool counts: 69 → 81+ scripts
- Added comprehensive "NEW SKILLS DISCOVERED" sections
- Documented all 6 new skills with tool details
- Resolved "Issue 3: Undocumented Skills" (marked as RESOLVED)
- Updated production tool counts: 18-20 → 29-31 confirmed
- Added audit change log with November 7 update
- Corrected discrepancy explanation (97 claimed → 68-70 actual)

### documentation/GROWTH_STRATEGY.md (NEW - 600+ lines)
- Part 1: Adding New Skills (step-by-step process)
- Part 2: Enhancing Agents with New Skills
- Part 3: Agent-Skill Mapping Maintenance
- Part 4: Version Control & Compatibility
- Part 5: Quality Assurance Framework
- Part 6: Growth Projections & Resource Planning
- Part 7: Orchestrator Integration Strategy
- Part 8: Community Contribution Process
- Part 9: Monitoring & Analytics
- Part 10: Risk Management & Mitigation
- Appendix A: Templates (skill proposal, agent enhancement)
- Appendix B: Automation Scripts (validation, doc checker)

## Metrics Summary

**Before:**
- 42 skills documented
- 97 Python tools claimed
- Marketing: 3 skills
- Engineering: 9 core skills

**After:**
- 48 skills documented (+6)
- 68+ Python tools actual (corrected overcount)
- Marketing: 5 skills (+2)
- Engineering: 13 core skills (+4)
- Time savings: 1,900 hours/month (+180 hours)
- Annual ROI: $21.0M per org (+$200K)

## Quality Checklist

- [x] Skills audit completed across 4 folders
- [x] All 6 new skills have complete SKILL.md documentation
- [x] README.md updated with detailed skill descriptions
- [x] CLAUDE.md updated with accurate counts
- [x] PYTHON_TOOLS_AUDIT.md updated with new findings
- [x] GROWTH_STRATEGY.md created for systematic additions
- [x] All skill counts verified and corrected
- [x] ROI metrics recalculated
- [x] Conventional commit standards followed

## Next Steps

1. Review and approve this pre-sprint documentation update
2. Begin sprint-11-06-2025 (Orchestrator Framework)
3. Use GROWTH_STRATEGY.md for future skill additions
4. Verify engineering core/AI-ML tools (future task)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-07 10:08:08 +01:00

10 KiB

How to Use the App Store Optimization Skill

Hey Claude—I just added the "app-store-optimization" skill. Can you help me optimize my app's presence on the App Store and Google Play?

Example Invocations

Keyword Research

Example 1: Basic Keyword Research

Hey Claude—I just added the "app-store-optimization" skill. Can you research the best keywords for my productivity app? I'm targeting professionals who need task management and team collaboration features.

Example 2: Competitive Keyword Analysis

Hey Claude—I just added the "app-store-optimization" skill. Can you analyze keywords that Todoist, Asana, and Monday.com are using? I want to find gaps and opportunities for my project management app.

Metadata Optimization

Example 3: Optimize App Title

Hey Claude—I just added the "app-store-optimization" skill. Can you optimize my app title for the Apple App Store? My app is called "TaskFlow" and I want to rank for "task manager", "productivity", and "team collaboration". The title needs to be under 30 characters.

Example 4: Full Metadata Package

Hey Claude—I just added the "app-store-optimization" skill. Can you create optimized metadata for both Apple App Store and Google Play Store? Here's my app info:
- Name: TaskFlow
- Category: Productivity
- Key features: AI task prioritization, team collaboration, calendar integration
- Target keywords: task manager, productivity app, team tasks

Competitor Analysis

Example 5: Analyze Top Competitors

Hey Claude—I just added the "app-store-optimization" skill. Can you analyze the ASO strategies of the top 5 productivity apps in the App Store? I want to understand their title strategies, keyword usage, and visual asset approaches.

Example 6: Identify Competitive Gaps

Hey Claude—I just added the "app-store-optimization" skill. Can you compare my app's ASO performance against competitors and identify what I'm missing? Here's my current metadata: [paste metadata]

ASO Score Calculation

Example 7: Calculate Overall ASO Health

Hey Claude—I just added the "app-store-optimization" skill. Can you calculate my app's ASO health score? Here are my metrics:
- Average rating: 4.2 stars
- Total ratings: 3,500
- Keywords in top 10: 3
- Keywords in top 50: 12
- Conversion rate: 4.5%

Example 8: Identify Improvement Areas

Hey Claude—I just added the "app-store-optimization" skill. My ASO score is 62/100. Can you tell me which areas I should focus on first to improve my rankings and downloads?

A/B Testing

Example 9: Plan Icon Test

Hey Claude—I just added the "app-store-optimization" skill. I want to A/B test two different app icons. My current conversion rate is 5%. Can you help me plan the test, calculate required sample size, and determine how long to run it?

Example 10: Analyze Test Results

Hey Claude—I just added the "app-store-optimization" skill. Can you analyze my A/B test results?
- Variant A (control): 2,500 visitors, 125 installs
- Variant B (new icon): 2,500 visitors, 150 installs
Is this statistically significant? Should I implement variant B?

Localization

Example 11: Plan Localization Strategy

Hey Claude—I just added the "app-store-optimization" skill. I currently only have English metadata. Which markets should I localize for first? I'm a bootstrapped startup with moderate budget.

Example 12: Translate Metadata

Hey Claude—I just added the "app-store-optimization" skill. Can you help me translate my app metadata to Spanish for the Mexico market? Here's my English metadata: [paste metadata]. Check if it fits within character limits.

Review Analysis

Example 13: Analyze User Reviews

Hey Claude—I just added the "app-store-optimization" skill. Can you analyze my recent reviews and tell me:
- Overall sentiment (positive/negative ratio)
- Most common complaints
- Most requested features
- Bugs that need immediate fixing

Example 14: Generate Review Response Templates

Hey Claude—I just added the "app-store-optimization" skill. Can you create professional response templates for:
- Users reporting crashes
- Feature requests
- Positive 5-star reviews
- General complaints

Launch Planning

Example 15: Pre-Launch Checklist

Hey Claude—I just added the "app-store-optimization" skill. Can you generate a comprehensive pre-launch checklist for both Apple App Store and Google Play Store? My launch date is December 1, 2025.

Example 16: Optimize Launch Timing

Hey Claude—I just added the "app-store-optimization" skill. What's the best day and time to launch my fitness app? I want to maximize visibility and downloads in the first week.

Example 17: Plan Seasonal Campaign

Hey Claude—I just added the "app-store-optimization" skill. Can you identify seasonal opportunities for my fitness app? It's currently October—what campaigns should I run for the next 6 months?

What to Provide

For Keyword Research

  • App name and category
  • Target audience description
  • Key features and unique value proposition
  • Competitor apps (optional)
  • Geographic markets to target

For Metadata Optimization

  • Current app name
  • Platform (Apple, Google, or both)
  • Target keywords (prioritized list)
  • Key features and benefits
  • Target audience
  • Current metadata (for optimization)

For Competitor Analysis

  • Your app category
  • List of competitor app names or IDs
  • Platform (Apple or Google)
  • Specific aspects to analyze (keywords, visuals, ratings)

For ASO Score Calculation

  • Metadata quality metrics (title length, description length, keyword density)
  • Rating data (average rating, total ratings, recent ratings)
  • Keyword rankings (top 10, top 50, top 100 counts)
  • Conversion metrics (impression-to-install rate, downloads)

For A/B Testing

  • Test type (icon, screenshot, title, description)
  • Control variant details
  • Test variant details
  • Baseline conversion rate
  • For results analysis: visitor and conversion counts for both variants

For Localization

  • Current market and language
  • Budget level (low, medium, high)
  • Target number of markets
  • Current metadata text for translation

For Review Analysis

  • Recent reviews (text, rating, date)
  • Platform (Apple or Google)
  • Time period to analyze
  • Specific focus (bugs, features, sentiment)

For Launch Planning

  • Platform (Apple, Google, or both)
  • Target launch date
  • App category
  • App information (name, features, target audience)

What You'll Get

Keyword Research Output

  • Prioritized keyword list with search volume estimates
  • Competition level analysis
  • Relevance scores
  • Long-tail keyword opportunities
  • Strategic recommendations

Metadata Optimization Output

  • Optimized titles (multiple options)
  • Optimized descriptions (short and full)
  • Keyword field optimization (Apple)
  • Character count validation
  • Keyword density analysis
  • Before/after comparison

Competitor Analysis Output

  • Ranked competitors by ASO strength
  • Common keyword patterns
  • Keyword gaps and opportunities
  • Visual asset assessment
  • Best practices identified
  • Actionable recommendations

ASO Score Output

  • Overall score (0-100)
  • Breakdown by category (metadata, ratings, keywords, conversion)
  • Strengths and weaknesses
  • Prioritized action items
  • Expected impact of improvements

A/B Test Output

  • Test design with hypothesis
  • Required sample size calculation
  • Duration estimates
  • Statistical significance analysis
  • Implementation recommendations
  • Learnings and insights

Localization Output

  • Prioritized target markets
  • Estimated translation costs
  • ROI projections
  • Character limit validation for each language
  • Cultural adaptation recommendations
  • Phased implementation plan

Review Analysis Output

  • Sentiment distribution (positive/neutral/negative)
  • Common themes and topics
  • Top issues requiring fixes
  • Most requested features
  • Response templates
  • Trend analysis over time

Launch Planning Output

  • Platform-specific checklists (Apple, Google, Universal)
  • Timeline with milestones
  • Compliance validation
  • Optimal launch timing recommendations
  • Seasonal campaign opportunities
  • Update cadence planning

Tips for Best Results

  1. Be Specific: Provide as much detail about your app as possible
  2. Include Context: Share your goals (increase downloads, improve ranking, boost conversion)
  3. Provide Data: Real metrics enable more accurate analysis
  4. Iterate: Start with keyword research, then optimize metadata, then test
  5. Track Results: Monitor changes after implementing recommendations
  6. Stay Compliant: Always verify recommendations against current App Store/Play Store guidelines
  7. Test First: Use A/B testing before making major metadata changes
  8. Localize Strategically: Start with highest-ROI markets first
  9. Respond to Reviews: Use provided templates to engage with users
  10. Plan Ahead: Use launch checklists and timelines to avoid last-minute rushes

Common Workflows

New App Launch

  1. Keyword research → Competitor analysis → Metadata optimization → Pre-launch checklist → Launch timing optimization

Improving Existing App

  1. ASO score calculation → Identify gaps → Metadata optimization → A/B testing → Review analysis → Implement changes

International Expansion

  1. Localization planning → Market prioritization → Metadata translation → ROI analysis → Phased rollout

Ongoing Optimization

  1. Monthly keyword ranking tracking → Quarterly metadata updates → Continuous A/B testing → Review monitoring → Seasonal campaigns

Need Help?

If you need clarification on any aspect of ASO or want to combine multiple analyses, just ask! For example:

Hey Claude—I just added the "app-store-optimization" skill. Can you create a complete ASO strategy for my new productivity app? I need keyword research, optimized metadata for both stores, a pre-launch checklist, and launch timing recommendations.

The skill can handle comprehensive, multi-phase ASO projects as well as specific tactical optimizations.