Mobbin Skill

Mobbin UI Inspiration

Preconditions

• mobbin must be installed and on PATH (global npm link)
• Use grouped commands (current CLI): auth, shots, app screens, config
• Use profile default by default (avoid accidental test profile)

Authenticate first:

mobbin auth login --profile default

Parameters

When collecting inspiration, identify:

Default workflow

1. Verify auth

mobbin auth status --profile default

If not logged in:

mobbin auth login --profile default

2. Search

mobbin search "<screenType>" --platform <platform> --limit <limit> --json > results.json

3. Download inspiration

Recommended: full app screen collections

For each result URL in results.json (url field):

mobbin app screens download \
  --url "<appScreensUrl>" \
  --out ./inspiration/mobbin/<screenType> \
  --profile default \
  --concurrency 8 \
  --timeout-ms 15000 \
  --retries 1 \
  --max-scrolls 60 \
  --scroll-wait-ms 900 \
  --timing

Optional: single screen/shot

Use only when you already have a screen URL or screen UUID:

mobbin shots download "https://mobbin.com/screens/<screen-id>" \
  --out ./inspiration/mobbin/<screenType> \
  --profile default \
  --concurrency 8 \
  --timeout-ms 15000 \
  --retries 1 \
  --timing

4. Write INDEX.md

Create ./inspiration/mobbin/<screenType>/INDEX.md:

# <ScreenType> UI Inspiration

Collected from Mobbin on <date>

| App | Source | Local Path | Notes |
|-----|--------|------------|-------|
| <App Name> | [link](<mobbin-url>) | `./path/to/folder/or/file` | <2-3 observations> |

Fast path (script)

node mobbin-skill/scripts/gather-inspiration.mjs \
  --query "<screenType>" \
  --platform ios \
  --limit 15 \
  --out ./inspiration/mobbin/<screenType> \
  --profile default

Optional flags:

--download-mode app-screens|shots
--max-scrolls 60
--scroll-wait-ms 900
--no-creative
--creative-per-query-limit 10
--creative-max-per-app 2
--verify-min-score 3

Current CLI reference

mobbin auth login --profile default
mobbin auth status --profile default
mobbin auth logout --profile default

mobbin search <query> --platform ios|android|web --limit <n> --json

mobbin shots download <screen-id-or-screen-url> --out <dir> --profile default --timing

mobbin app screens download --url <app-screens-url> --out <dir> --profile default --max-scrolls 60 --scroll-wait-ms 900 --timing

mobbin config get defaultProfile
mobbin config set defaultProfile default

Troubleshooting

• Not logged in: run mobbin auth login --profile default
• Wrong default profile:

  mobbin config set defaultProfile default
  

• shots download invalid id message: pass a /screens/<uuid> URL or use app screens download for /apps/.../screens URLs.
• Rebuild/relink CLI:

  cd mobbin-cli
  npm run build
  npm link
  

Converted and distributed by TomeVault — claim your Tome and manage your conversions.