AppScreenshotStudio

Generate finished App Store / Play Store screenshots directly from your terminal.

Setup#

Requires APPSCREENSHOTSTUDIO_API_KEY in your environment. Get a key at https://appscreenshotstudio.com/settings (requires an account with credits).

When to use this skill#

Use when the user says: "generate screenshots", "App Store screenshots", "Play Store screenshots", "store listing", "marketing screenshots", or wants to ship a new app.

Workflow#

Step 1 — Research the codebase#

Before calling the API, gather context from the project. This context directly improves the generated layouts, colors, and headlines.

Find and read:

• README.md — app name, purpose, main features
• package.json / pubspec.yaml / Cargo.toml / build.gradle — app name, tech stack
• Brand colors: tailwind.config.* ( theme.extend.colors), SwiftUI Color(, Flutter ThemeData
• Key screens: Next.js app/ routes, SwiftUI NavigationView/ TabView, Flutter GoRouter
• App Store metadata: Info.plist, fastlane metadata/, AndroidManifest.xml

Build this context:

text

app_name, readme_summary, key_screens[], color_tokens{}, target_audience,
app_category (fitness|finance|social|productivity|food|travel|health|education|other),
competitive_edge, ui_style, primary_user_flow

Step 2 — Confirm with the user#

Show what you found and ask:

• "I found these main features: [X, Y, Z]. Which 3-5 should I highlight?"
• "Your brand color appears to be [#hex]. Should I use it?"
• "Mood? Options: minimal, bold, playful, professional, dark, warm, energetic"
• "Device? iphone-6.9 (default), ipad-13, android-phone, android-tablet-10"
• "How many screenshots? (3–8, default 5)"

Step 3 — Create project and generate#

3a. Create a project:

bash

curl -s -X POST https://appscreenshotstudio.com/api/v1/projects \
  -H "Authorization: Bearer $APPSCREENSHOTSTUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "device_id": "iphone-6.9",
    "name": "<app_name> Screenshots",
    "codebase_context": {
      "readme_summary": "...",
      "key_screens": ["..."],
      "color_tokens": {"primary": "#hex"},
      "target_audience": "...",
      "app_category": "...",
      "competitive_edge": "...",
      "ui_style": "...",
      "primary_user_flow": "..."
    }
  }'

Save data.id as PROJECT_ID.

3b. Generate the screenshot set via chat:

bash

curl -s -X POST "https://appscreenshotstudio.com/api/v1/projects/$PROJECT_ID/chat" \
  -H "Authorization: Bearer $APPSCREENSHOTSTUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Create a 5-card screenshot set. Highlight: [feature1], [feature2], [feature3]. Mood: minimal. Use brand color #hex."
  }'

On success, data.canvas_state contains the generated layout. The response also includes data.message (Claude's description of what was created) and credits_remaining.

If data.operations is empty, Claude asked a clarifying question — no credits were deducted. Answer the question and call chat again.

Step 4 — Iterate if needed#

If the user wants changes, call chat again on the same PROJECT_ID:

bash

curl -s -X POST "https://appscreenshotstudio.com/api/v1/projects/$PROJECT_ID/chat" \
  -H "Authorization: Bearer $APPSCREENSHOTSTUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Make the first card more playful. Change the headline to something punchier."}'

Step 5 — Render and export#

Render the final PNGs at exact App Store dimensions (free, no credits):

bash

curl -s -X POST "https://appscreenshotstudio.com/api/v1/projects/$PROJECT_ID/render" \
  -H "Authorization: Bearer $APPSCREENSHOTSTUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Returns data.images[] — array of CDN URLs. Download them or share the project URL: https://appscreenshotstudio.com/builder/<PROJECT_ID>

Credit costs#

• Project creation: free
• Chat (screenshot generation): 5 credits per message
• Render: free
• Clarifying questions (no operations generated): refunded automatically

Headline quality rules#

When reviewing or suggesting headlines, enforce:

• 3–5 words per line, readable at thumbnail size
• Three styles: paint a moment ("Morning runs handled"), state an outcome ("Never miss a workout"), eliminate a pain ("Ditch the spreadsheet")
• Never: feature lists, "and"-joined clauses, starting with "The", vague aspirational phrases

Error codes#

• NO_CREDITS (402) — user needs to top up at https://appscreenshotstudio.com/billing
• PROJECT_LIMIT_REACHED (403) — plan limit hit
• UNAUTHORIZED (401) — invalid or missing API key
• NOT_FOUND (404) — project ID doesn't exist