Skip to main content

​
Overview

The App Marketing Context skill helps you create a comprehensive context document that all other ASO and app marketing skills reference. This foundational document captures your app’s positioning, audience, goals, and competitive landscape.

​
When to Use This Skill

Use this skill when:
  • Starting any ASO or app marketing project
  • Creating a marketing brief for your app
  • Defining or refining your app’s positioning
  • Onboarding team members to app marketing
  • Beginning work with ASO or marketing consultants
This is the foundation skill. All other ASO skills check for this context first to provide personalized, relevant guidance.

​
Context Document Structure

The skill guides you through creating a complete app-marketing-context.md file with seven essential sections.

​
1. App Overview

Basic app information and technical details: 
## App Overview
- **App Name:** [name]
- **App ID (Apple):** [numeric ID]
- **App ID (Google Play):** [package name, if applicable]
- **Category:** [primary category]
- **Secondary Category:** [if applicable]
- **Platform:** [iOS / Android / Both]
- **Price Model:** [Free / Freemium / Paid / Subscription]
- **Launch Date:** [date or "not yet launched"]
- **Current Version:** [version]

​
2. Value Proposition

The skill asks strategic questions to define:
What pain point does your app solve? What user need does it address?
Who is your ideal user? (Demographics, behavior, specific needs)
What sets your app apart from alternatives? Why should users choose you?
Can you describe your app’s value in one compelling sentence?
Example Value Proposition: 
## Value Proposition
- **Problem:** Freelancers struggle to track time across multiple projects
  and generate professional invoices
- **Target Audience:** Solo freelancers and consultants (designers, developers,
  writers) who bill hourly
- **Unique Differentiator:** AI-powered time tracking that auto-categorizes work
  + one-tap invoice generation
- **Elevator Pitch:** The simplest way for freelancers to track time and get paid
  faster with AI-powered automation

​
3. Competitive Landscape

Document your top 3-5 competitors with analysis:
AppApp IDStrengthsWeaknesses
Competitor A123456789Strong brand, great UXExpensive, lacks automation
Competitor B987654321Free tier, simpleLimited features, outdated UI
Competitor C456789123Feature-richComplex, steep learning curve
Identifying competitor weaknesses helps you position your unique strengths and find market gaps.

​
4. Current ASO State

If you have an existing app, the skill captures current metadata: 
## Current ASO State
- **Title:** TaskFlow - Time Tracker
- **Subtitle:** Simple Time & Invoice App
- **Keyword Field:** time tracking, invoice, freelance, timer, billing
- **Rating:** 4.6 ★ (1,247 ratings)
- **Primary Keywords:** Ranks #12 for "time tracker", #8 for "freelance invoice"

​
5. Goals & KPIs

Define measurable objectives with timelines:

Downloads

Target: 10,000 installs by Q2

Revenue

Target: $5,000 MRR by Q3

Rankings

Target: Top 10 for “time tracker” by Q2

Retention

Target: 25% D30 retention by Q3

Conversion

Target: 30% CVR by Q2

Rating

Target: 4.5★+ with 2,000 reviews by Q4

​
6. Resources & Constraints

Document available resources and limitations: 
## Resources
- **Budget:** $2,000/month for paid acquisition
- **Team:** Solo founder + contract designer
- **Tools:** App Store Connect, Firebase Analytics, RevenueCat
- **Constraints:** Limited development capacity (1 major update per quarter),
  no in-house content creation

​
7. Markets & Localization

## Markets
- **Primary:** United States
- **Secondary:** Canada, United Kingdom, Australia
- **Languages:** English (US), English (UK)
- **Future Markets:** Germany, France (planned for Q3)

​
How the Skill Works

1

Check for Existing Context

Skill checks if app-marketing-context.md exists in project root or .claude/ directory
2

Read or Create

If exists: Reads and asks what to update If missing: Guides you through each section
3

Ask Strategic Questions

Interactive questions to build comprehensive context
4

Save Context Document

Creates app-marketing-context.md in project root
5

Provide Recommendations

Summarizes strengths, gaps, and next steps

​
Example Output

After creating your context document, the skill provides analysis: 
Context Document Created: app-marketing-context.md

Key Strengths to Leverage:
✓ Clear value proposition (AI-powered automation)
✓ Underserved target audience (solo freelancers)
✓ Strong current rating (4.6★)

Obvious Gaps to Address:
⚠ Low keyword rankings (#12, #8) - need metadata optimization
⚠ Missing secondary revenue streams
⚠ Limited to English markets - localization opportunity

Recommended Next Skills:
1. aso-audit - Full ASO health check to identify quick wins
2. keyword-research - Find high-value, low-competition keywords
3. competitor-analysis - Deep dive on competitor strategies
4. monetization-strategy - Optimize pricing and paywall

​
Why This Matters

Consistency

All other skills reference this context for personalized guidance

Focus

Keeps strategy aligned with your specific goals and constraints

Efficiency

Avoids repeating questions across different skills

Strategic Clarity

Forces you to articulate positioning and differentiation

​
Updating Your Context

Your app marketing context should evolve:
  • After launch: Update with actual metrics and user feedback
  • Quarterly: Refresh goals, KPIs, and competitive landscape
  • After pivots: Revise value proposition and target audience
  • Market expansion: Add new markets and languages
Keep your context document updated. Other skills will provide more relevant guidance when working from current information.
After creating your context, these skills build on this foundation:
  • ASO Audit - Comprehensive ASO health check using your context
  • Keyword Research - Find keywords aligned with your positioning
  • Competitor Analysis - Deep competitive analysis of apps you’ve identified
  • Monetization Strategy - Pricing strategy based on your model and goals
  • App Analytics - Set up tracking for your specific KPIs

Build docs developers (and LLMs) love

Get started for freeTalk to us