aso-metadata

name	aso-metadata
description	Metadata optimization for iOS and Android app listings. Per-field scoring, character limit validation, keyword placement analysis, and rewrite suggestions. Triggers on: "metadata", "title", "subtitle", "description", "optimize listing".
user-invokable	true
argument-hint	<app-id> [--platform ios|android]

ASO Metadata — Metadata Optimization

Capabilities

1. Per-field character limit validation
2. Keyword presence and placement scoring
3. Conversion copy quality assessment
4. Optimized metadata rewrite suggestions (3 variants)
5. Cross-field consistency check

Process

1. Fetch current metadata: uv run python scripts/fetch_listing.py <app-id> --json
2. Validate limits: uv run python scripts/validate_metadata.py --file listing.json --json
3. Analyze keyword density: uv run python scripts/keyword_density.py --file listing.json --keywords "<target>" --json
4. Score each field (0-10):
   • Character utilization (target: >80%)
   • Primary keyword present
   • Natural readability
   • Conversion impact (benefit/value proposition clear)
   • No keyword stuffing
5. Generate 3 variant rewrites per field

Field Scoring Criteria

iOS App Name (30 chars)

• Contains primary keyword: +3
• Uses >80% of characters: +2
• Brand name present: +2
• Natural readability: +2
• Unique value proposition clear: +1

iOS Subtitle (30 chars)

• Contains secondary keyword: +3
• Complements (not repeats) App Name: +2
• Uses >80% of characters: +2
• Benefit-oriented copy: +2
• Natural readability: +1

iOS Keywords (100 chars)

• Uses >90% of characters: +3
• No duplicates from title/subtitle: +2
• No spaces after commas: +2
• Singular forms used: +1
• Covers primary + secondary + long-tail: +2

iOS Description (4000 chars, NOT indexed)

• Strong opening (first 3 lines visible): +3
• Social proof included: +2
• Feature highlights structured: +2
• Call-to-action present: +2
• NOT keyword-stuffed (it's not indexed): +1

Android Title (50 chars)

• Contains primary keyword: +3
• Natural language (no stuffing): +2
• Uses >70% of characters: +2
• Brand recognition: +2
• Descriptive of function: +1

Android Short Description (80 chars)

• Contains secondary keyword: +3
• Compelling benefit statement: +3
• Uses >80% of characters: +2
• Complements title: +2

Android Full Description (4000 chars)

• Primary keyword in first sentence: +2
• Keyword density 2-3%: +2
• Structured with sections: +2
• Social proof: +1
• Call-to-action: +1
• Natural readability: +2

Output Format

# Metadata Report: [App Name]

## Current Metadata Scores
| Field | Score | Chars Used | Limit | Key Issue |
|-------|-------|-----------|-------|-----------|

## Field-by-Field Analysis
### [Field Name]
- Current: "[current value]"
- Score: X/10
- Issues: [list]
- Variant A: "[optimized version]"
- Variant B: "[alternative version]"
- Variant C: "[alternative version]"

Available Tools

Read, Bash, Write, Glob, Grep