# App marketing copy Human Guide

## What This Is For
1) Ask for missing inputs (or infer from repo/product docs): App name + 1-sentence value prop Target user + primary job-to-be-done 3–7 key features + 1–3 differentiators Desired tone (and. It gives the agent a clearer input/output frame for content production: what context to ask for, what decisions to make, and what usable artifact to return.

Use this as a human-readable version of the App marketing copy agent skill. It is meant for marketers, operators, founders, and other non-coders who want the workflow without reading agent-specific implementation instructions.

## When To Use This
- Use this when you need a repeatable process for app marketing copy.
- Use this when the task needs judgment, examples, constraints, or a clear output format rather than a one-off prompt.
- Use this when you want to hand an AI assistant enough context to produce a usable marketing artifact.

## When Not To Use This
- Do not use this when you only need a quick factual answer.
- Do not use this when the work depends on private data you cannot share with the assistant.
- Do not use this as a replacement for legal, compliance, financial, or medical review.

## What You Need Before Starting
- The goal or business outcome you want.
- The audience, customer segment, or market context.
- Any source material the assistant should respect, such as notes, briefs, examples, URLs, or brand guidance.
- Constraints such as tone, length, channel, deadline, region, or approval requirements.
- A clear definition of what a good final answer should look like.

## Step-By-Step Workflow
1. State the job clearly: "Use the App marketing copy guide to help me with..."
2. Add context: audience, goal, offer, channel, source material, and constraints.
3. Ask the assistant to identify missing inputs before producing the final output.
4. Have the assistant follow the skill-specific guidance below.
5. Review the result against the final checklist and ask for revisions where needed.

## Skill-Specific Guidance
- App name + 1-sentence value prop
- Target user + primary job-to-be-done
- 3–7 key features + 1–3 differentiators
- Desired tone (and words to use/avoid)
- Platform(s): iOS App Store, Google Play, or both
- Screenshot count and theme (if needed)
- Store listing (iOS, Google Play)
- Marketing pack (landing hero, feature blurbs, CTAs, ads)
- Screenshot pack (caption copy + image-generation prompts)
- Run intake questions to clarify missing details
- Generate 3 subtitle variants, recommend best
- Create keyword set optimized for student productivity searches

## Decision Points And Nuance
The original skill emphasizes: Quick start, Examples, Example 1: New App Store Listing, Example 2: Marketing Copy Refresh, Example 3: Multi-Platform Launch, Intake template (ask, then proceed), Outputs, iOS App Store listing, Google Play listing, Marketing copy pack.

Use these questions to steer the work:
- What is the intended audience or buyer?
- What source material must be preserved?
- What should the assistant optimize for: clarity, persuasion, accuracy, speed, creativity, or conversion?
- What examples represent the desired quality bar?
- What should the assistant avoid?

## Common Mistakes
- Desired tone (and words to use/avoid)
- Constraints: claims to avoid, legal/compliance notes, pricing mention policy
- Keep claims supportable; avoid "#1 / best" unless proven.
- Compliance: avoid disallowed claims, competitor trademarks, and sensitive targeting; ask if regulated domain (health/finance/kids).
- Let keywords live in distinct fields (keyword set, full description) where they don't disrupt the narrative
- **Problem:** Vague promises like "Fast," "Easy," "Simple," or "Best" don't differentiate and raise user skepticism. Without specificity, users can't judge if the app solves *their* problem.
- Write tight; avoid filler words (a, the, very, really, just)
- Use contractions (don't, it's) to save characters without losing personality

## Copy-And-Paste Prompt
```text
Use the App marketing copy human guide.

My goal:
[Describe the business outcome]

Audience:
[Describe who this is for]

Context and source material:
[Paste notes, examples, links, or existing copy]

Constraints:
[Tone, length, channel, timeline, must-include items, must-avoid items]

Before producing the final output, ask me for any missing information that would materially improve the result.
```

## Final Checklist
- [ ] The output matches the original goal.
- [ ] The audience and context are reflected in the answer.
- [ ] Important constraints and source material were preserved.
- [ ] The assistant made the relevant decisions explicit.
- [ ] The final artifact is ready to use, review, or hand to the next person.

## Source
This guide was generated from the ckorhonen/claude-skills skill entry for `app-marketing-copy`.

## Source Skill Notes
These notes preserve the nuance from the original skill. Use them as supporting reference when the workflow above feels too generic.

# App Marketing Copy

## Quick start

1) Ask for missing inputs (or infer from repo/product docs):
- App name + 1-sentence value prop
- Target user + primary job-to-be-done
- 3–7 key features + 1–3 differentiators
- Desired tone (and words to use/avoid)
- Platform(s): iOS App Store, Google Play, or both
- Screenshot count and theme (if needed)

2) Confirm deliverables:
- Store listing (iOS, Google Play)
- Marketing pack (landing hero, feature blurbs, CTAs, ads)
- Screenshot pack (caption copy + image-generation prompts)

3) Produce 2–3 variants per high-impact field, then recommend a "best pick" with 1-sentence rationale.

## Examples

### Example 1: New App Store Listing

**User input:**
```
App: FocusTimer
Purpose: Pomodoro timer for students
Key features: Custom intervals, study stats, break reminders
Platform: iOS App Store
Tone: Friendly but not childish
```

**Workflow:**
1. Run intake questions to clarify missing details
2. Generate 3 subtitle variants, recommend best
3. Create keyword set optimized for student productivity searches
4. Write full description with feature bullets
5. Generate 5 screenshot captions in narrative order
6. Validate with `scripts/check_app_store_limits.py`

**Expected output:**
- iOS App Store listing (all fields within limits)
- 3 subtitle options with rationale
- Keyword set (100 chars max)
- Screenshot copy pack

### Example 2: Marketing Copy Refresh

**User input:**
```
"Our app store listing conversion is terrible. Help refresh it."
App: PhotoFix (photo editing)
Current problem: Generic copy, keyword-stuffed
```

**Workflow:**
1. Review current listing (if provided)
2. Ask: "What makes PhotoFix different from competitors?"
3. Identify ASO keyword stuffing issues
4. Generate 3 new subtitle variants (specific, benefit-focused)
5. Rewrite full description with user benefits (not tech specs)
6. Create fresh screenshot captions
7. Compare before/after character counts

**Expected output:**
- Refactored listing with specificity
- Side-by-side comparison showing improvements
- Rationale for each change

### Example 3: Multi-Platform Launch

**User input:**
```
Launching on both iOS and Google Play
App: TaskFlow (project management for freelancers)
Need everything: store listings, landing page copy, ads
```

**Workflow:**
1. Complete intake (audience, differentiators, proof points)