Agent skill

Mobile Demo Recording

by superset-sh in superset-sh/superset

Runs the Superset mobile app on a headless iOS simulator against the local stack, drives it with Maestro and captures clean screen recordings and screenshots.

Custom licenceAuto-check: notesMobile

Install Mobile Demo Recording

skills CLI
$ npx skills add superset-sh/superset --skill mobile-demo-record -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install superset-sh/superset mobile-demo-record --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/superset-sh/superset.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/mobile-demo-record .claude/skills/mobile-demo-record && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
mobile-demo-record
GitHub stars
15k
Token cost
~2.2k tokens
SKILL.md length
1,061 words
Files
1
Skills in repo
47
Repo updated
First seen
Licence
Custom licence

At a glance

Runs the Superset mobile app on a headless iOS simulator against the local stack, drives it with Maestro and captures clean screen recordings and screenshots.

  • Works in 4 steps: Real app state only. Record real… → No real data in frame. Use the dev… → One take per story. A host that has… → …
  • Recording a demo video of the mobile app on the iOS simulator
  • SKILL.md covers Rules, Stack, Simulator and Driving, plus 3 more sections
  • Calls xcrun, bun and bunx; needs USERCONTENT_TOKEN_SECRET

What it does

Mobile has no browser debugging protocol, so this skill boots the iOS simulator headless, drives it with Maestro and records with `simctl`, without opening a window on your screen. Four rules apply: record only real app state with no mockups, keep real data out of frame by using the dev account and a demo organization and checking every frame of a contact sheet for names, emails, repo names and tokens, take one take per story with state reset each time, and report what was recorded against, such as the worktree, API port, simulator UDID and app build date.

The local stack starts in separate Superset terminals: the API with `bun run dev`, a relay that runs `wrangler dev` inside a restart loop because it dies whenever a client aborts a request, and Metro through `expo start --dev-client` with file watching off, so it needs a restart after code edits and a pre-warmed first bundle. The skill also records traps, such as a cleaned-up Neon branch that shows up as a 500 password error.

When your agent uses it

  • Recording a demo video of the mobile app on the iOS simulator
  • Taking clean screenshots of a mobile change for a pull request
  • Verifying a mobile change in the real app rather than only in tests

Example prompts

  • “Record a short demo of the new host list screen on the iOS simulator.”
  • “Film the mobile sign-in flow with the dev account and give me a contact sheet.”
  • “Screenshot the empty state of the mobile app after reseeding the demo org.”

Requirements

  • macOS with an iOS simulator and `xcrun simctl`
  • Maestro for driving the app
  • The Superset API, relay and Metro services, run with bun

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Real app state only. Record real sessions, real pull requests, real pages. No mockups,
  2. No real data in frame. Use the dev account (admin@local.test) and a demo org with demo
  3. One take per story. A host that has connected once is no longer "never connected", a
  4. Report what you recorded against: worktree, API port, simulator UDID, app build date.

What it can do on your machine

Read from SKILL.md and the folder at commit 6b94a61. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • xcrun
    • bun
    • bunx
    • ffmpeg
    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use bunx and curl, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • USERCONTENT_TOKEN_SECRET

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Mobile Demo Recording loads about 2.2k tokens when it runs. Until then it costs about 64 tokens; SKILL.md has 1,061 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~64
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:27
    and the root `.env`.
  • NoteMentions a .env fileSKILL.md:31
    ite the "# Workspace Database" lines in `.env`. |
  • NoteMentions a .env fileSKILL.md:35
    bile/app.config.ts` loads the repo-root `.env` with `override: true`, so every local
  • NoteMentions a .env fileSKILL.md:36
    kspace's API no matter what `apps/mobile/.env` says.
  • NoteMentions a .env fileSKILL.md:96
    the value in the root `.env`, or every page answers 500. Start it with

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,061 words (~2,225 tokens).

“There is no CDP for mobile. The equivalent is the iOS simulator, booted headless, driven by Maestro, recorded with simctl. Nothing here opens a window on the user's display.”

— opening of SKILL.md by superset-sh, Custom licence
name
mobile-demo-record

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/mobile-demo-record of superset-sh/superset.

Open the folder on GitHubat commit 6b94a61

Compare with similar skills

Mobile Demo Recording next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Mobile Demo Recording compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Mobile Demo Recording this skillsuperset-sh/superset15k—~2.2kAutomated safety check: NotesCustom licence
Orca iOS Simulator Controlstablyai/orca89k1 repos~584Automated safety check: PassApache-2.0
UI Kitten Showcase QAakveo/react-native-ui-kitten11k—~2.3kAutomated safety check: PassMIT
Live-Device iOS QAgarrytan/gstack136k—~11kAutomated safety check: NotesMIT
Xcode Simulator TestEveryInc/compound-engineering-plugin25k—~519Automated safety check: PassMIT
iOS Bug Fixergarrytan/gstack136k—~7.8kAutomated safety check: NotesMIT

Similar skills

  • iOS Simulator control from inside Orca, with the live device view in Orca's emulator pane. Use when driving a booted Apple Simulator on macOS: taps, gestures…

    89k GitHub starsUsed in 1 repo~584 tokens
    MobileAuto-check passed
  • UI Kitten Showcase QA

    akveo/react-native-ui-kitten

    Drives the Expo showcase app in an iOS simulator with agent-device to sweep every UI Kitten component in all theme and mapping combinations, reporting regressions with evidence.

    11k GitHub stars~2.3k tokensUpdated 5 days ago
    MobileAuto-check passed
  • Live-Device iOS QA

    garrytan/gstack

    Tests a SwiftUI app on a real iPhone connected by USB, reading the Swift source and then looping through screenshot, analysis and action to find bugs.

    136k GitHub stars~11k tokensUpdated today
    MobileAuto-check: notes
  • Xcode Simulator Test

    EveryInc/compound-engineering-plugin

    Builds an iOS app, exercises it on a simulator with XcodeBuildMCP and reports PASS, FAIL or PARTIAL with screenshots, logs and per-screen evidence.

    25k GitHub stars~519 tokensUpdated today
    MobileAuto-check passed
  • iOS Bug Fixer

    garrytan/gstack

    Takes a bug reported by /ios-qa, fixes the source, rebuilds, redeploys and checks the fix on a real device, saving a regression test fixture.

    136k GitHub stars~7.8k tokensUpdated today
    MobileAuto-check: notes
  • Official

    Resolves .NET runtime frames in Apple .ips crash logs to function names, source files and line numbers using dSYM symbols, atos and the Microsoft symbol server.

    5.6k GitHub starsUsed in 1 repo~2.4k tokens
    MobileAuto-check passed

More from superset-sh/superset

All 47 skills in this repo
  • Mobile Demo Film Editor

    superset-sh/superset

    Edits real mobile screen recordings into a configurable demo video with phone framing, title cards, cutaways and an end card, using a bundled renderer.

    15k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Superset Agent Standup

    superset-sh/superset

    Sweeps every Superset workspace, task and agent terminal to report what finished, what needs review and what is blocked, read-only, and can publish the digest as a page.

    15k GitHub stars~712 tokensUpdated today
    Auto-check passed
  • Superset Browser Control

    superset-sh/superset

    Opens pages, takes screenshots, reads the console, clicks and types in the browser panes of a Superset workspace, with Browser Use as a fallback for other browsers.

    15k GitHub stars~3.1k tokensUpdated today
    Auto-check passed
  • Superset Automate

    superset-sh/superset

    Turns a recurring chore into a scheduled or event-triggered Superset agent, drafting its prompt, picking a target and trigger, and reviewing the first run.

    15k GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Generates a Drizzle migration on a fresh Neon branch and runs a production-safety checklist for table sizes, lock order and load rehearsal before the PR opens.

    15k GitHub stars~2k tokensUpdated today
    Auto-check: notes
  • Superset Feedback Reporter

    superset-sh/superset

    Turns a bug report or feature request about Superset into a short, scannable write-up and submits it privately or as a public GitHub issue.

    15k GitHub stars~2.9k tokensUpdated today
    Auto-check passed

Questions about Mobile Demo Recording

What does Mobile Demo Recording do?

Runs the Superset mobile app on a headless iOS simulator against the local stack, drives it with Maestro and captures clean screen recordings and screenshots. Mobile has no browser debugging protocol, so this skill boots the iOS simulator headless, drives it with Maestro and records with `simctl`, without opening a window on your screen. Four rules apply: record only real app state with no mockups, keep real data out of frame by using the dev account and a demo organization and checking every frame of a contact sheet for names, emails, repo names and tokens, take one take per story with state reset each time, and report what was recorded against, such as the worktree, API port, simulator UDID and app build date.

When should I use Mobile Demo Recording?

Mobile Demo Recording fits situations like: recording a demo video of the mobile app on the iOS simulator; taking clean screenshots of a mobile change for a pull request; verifying a mobile change in the real app rather than only in tests.

How do I install Mobile Demo Recording in Claude Code?

Run `npx skills add superset-sh/superset --skill mobile-demo-record -a claude-code`. Or copy the skill folder (.agents/skills/mobile-demo-record in superset-sh/superset) into .claude/skills/mobile-demo-record in your project. Claude Code loads it when a task matches its description.

How do I install Mobile Demo Recording in Codex?

Run `npx skills add superset-sh/superset --skill mobile-demo-record -a codex`. Or copy the skill folder (.agents/skills/mobile-demo-record in superset-sh/superset) into .agents/skills/mobile-demo-record in your project. Codex loads it when a task matches its description.

Can I use Mobile Demo Recording in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add superset-sh/superset --skill mobile-demo-record -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mobile-demo-record, .gemini/skills/mobile-demo-record, .github/skills/mobile-demo-record and .opencode/skills/mobile-demo-record in your project.

What does Mobile Demo Recording need to run?

Going by SKILL.md and its folder, Mobile Demo Recording needs the command-line tools its instructions call (xcrun, bun, bunx, ffmpeg and curl) and credentials named USERCONTENT_TOKEN_SECRET. Our summary lists: macOS with an iOS simulator and `xcrun simctl`; Maestro for driving the app; The Superset API, relay and Metro services, run with bun.

Does Mobile Demo Recording access the network?

SKILL.md contains no URLs. Its commands use curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Mobile Demo Recording safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Mobile Demo Recording use?

Mobile Demo Recording has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Mobile Demo Recording use?

About 2.2k tokens (SKILL.md is roughly 8.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Mobile Demo Recording?

Skills that share tags, products or a category with Mobile Demo Recording: Orca iOS Simulator Control (stablyai/orca, 89k stars), UI Kitten Showcase QA (akveo/react-native-ui-kitten, 11k stars), Live-Device iOS QA (garrytan/gstack, 136k stars) and Xcode Simulator Test (EveryInc/compound-engineering-plugin, 25k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mobile Demo Recording?

superset-sh (a GitHub organization) maintains it in superset-sh/superset, which has 15,063 GitHub stars. The repository holds 47 skills in this directory. The repository was last updated on October 11, 2026.

Source: superset-sh/superset on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.