appllama-usage

Research top-grossing mobile app screens and flows via the Appllama MCP to guide app design and builds.

3|Updated Jul 28, 2026
One-click install
npx skills add https://github.com/marcmarti9/agentit --skill appllama-usage-marcmarti9
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: appllama-usage
Source: https://github.com/marcmarti9/agentit/tree/main/skills/appllama-usage
Command: npx skills add https://github.com/marcmarti9/agentit --skill appllama-usage-marcmarti9

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Designing competitive mobile apps without evidence leads to guesswork. This Skill gives an agent structured access to the Appllama library of real screens, flows, and UI patterns from top-grossing apps, so research directly informs what gets built. ## Core Features & Use Cases - Tool map and ground rules: Covers all Appllama MCP tools (search_apps, list_app_screens, search_screens, get_screen, boards, credits), plus pagination, expiring media URLs, and rate-limit handling. - Build-from-scratch playbook: A six-phase loop from finding winning apps, studying every screen, and synthesizing category design language to building and verifying each screen in the simulator. - Screen improvement playbook: Diagnose deficits, build a 30+30 reference board via keyword and semantic search, extract a checkable spec, and iterate until the screen matches the best reference. - Use Case: A user asks to build a habit tracker. The agent searches top-grossing habit trackers, walks their onboarding and paywall flows screen by screen, synthesizes the category's patterns, then designs and builds each screen verified against those references. ## Quick Start Use the Appllama MCP to research the top five habit tracker apps and summarize their onboarding and paywall design patterns before we build ours.

Frequently Asked Questions about appllama-usage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I research top-grossing app designs with the Appllama MCP?▼

Start with get_credits to check your balance, then use search_apps with natural-language queries and revenue filters to shortlist top apps. Walk each app's screens with list_app_screens in journey order, downloading images since media URLs expire in about an hour.

How to find reference screens for a specific mobile UI component?▼

Call list_ui_elements once to see the roughly 38 element families, then get_element_screens for screens featuring that family. You can also combine content and component with search_screens using the element filter, in keyword or semantic mode.

What is the Appllama screen_ref format and how do I use it?▼

A screen_ref looks like app_id/screen_id, for example 1393061654/spl_9i075, copied via "Copy Screen ID" on appllama.io. Pass it directly to get_screen to retrieve that exact screen plus up to five visually similar screens from other apps.

Why did my Appllama media URLs stop working?▼

Appllama image and video URLs expire in roughly one hour. Screen IDs are durable, so re-request the page or call get_screen with the screen ID to get fresh links, and download screens promptly while studying them.

How does Appllama MCP pagination work?▼

Every list response returns a next_cursor that you pass back to continue; you cannot jump to a specific page. A cursor only works for the query that minted it, so if a cursor errors, drop it and restart from page one.

What are the usage limits of the Appllama MCP?▼

get_credits is free; every other call costs one credit, with Pro including 1,500 credits resetting on the 1st of each month (UTC). Harvesting the catalog to extract the dataset is against the terms and detected server-side, while per-minute and per-day rate limits sit above normal research.