Agent skill

Run App

by mrzmyr in mrzmyr/pixy-mood-tracker-app

Build, install, and run the app on a device. An agent skill from mrzmyr/pixy-mood-tracker-app.

MITAuto-check passedMobile

Install Run App

skills CLI
$ npx skills add mrzmyr/pixy-mood-tracker-app --skill run-app -a claude-code

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

GitHub CLI
$ gh skill install mrzmyr/pixy-mood-tracker-app run-app --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/mrzmyr/pixy-mood-tracker-app.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/run-app .claude/skills/run-app && 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
run-app
GitHub stars
153
Token cost
~893 tokens
SKILL.md length
474 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Build, install, and run the app on a device. An agent skill from mrzmyr/pixy-mood-tracker-app.

  • Works in 7 steps: bun devices list. Copy one value of… → bun app install → bun app seed --fixture= (ids: bun app… → …
  • Asked to run the app
  • Calls bun and bunx
  • Run it with Metro for hot reload

What it does

Run App is an agent skill from mrzmyr/pixy-mood-tracker-app. Build, install, and run the app on a device. Use when asked to run the app, run it with Metro for hot reload, install a build on a phone, simulator, or emulator, or time a native build.

Its SKILL.md is about 890 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Mobile. It works with Android and iOS. The repository describes itself as: Minimalistic app to track your mood within one pixel a day. The licence is MIT.

When your agent uses it

  • Asked to run the app
  • Run it with Metro for hot reload
  • Install a build on a phone
  • Time a native build

Example prompts

  • “/run-app”

Workflow steps

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

  1. bun devices list. Copy one value of column OPTION: --platform= for simulator or emulator, --target= for a phone. Use it as below.
  2. bun app install
  3. bun app seed --fixture= (ids: bun app seed --help)
  4. bun app open
  5. Use the app: bun app drive -- . Commands: bunx agent-device help workflow. Never call bunx agent-device directly: it skips reservations…
  6. bun app close
  7. Phone: bun devices release

What it can do on your machine

Read from SKILL.md and the folder at commit fcf43ad. 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:

    • bun
    • bunx

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

  • Network

    No URLs in SKILL.md. Its commands use bunx, 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 no API keys, tokens, secrets or passwords.

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

Context cost

Run App loads about 893 tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 474 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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

The full file from mrzmyr/pixy-mood-tracker-app at commit fcf43ad, republished under its MIT licence (© mrzmyr). 474 words, ~893 tokens.

Download SKILL.mdSave it as .claude/skills/run-app/SKILL.md (or your agent's skills folder).
name
run-app
description
Build, install, and run the app on a device. Use when asked to run the app, run it with Metro for hot reload, install a build on a phone, simulator, or emulator, or time a native build.

Steps

Run in order. Relay each Step N line. Do not pick variants; the CLI owns them.

  1. bun devices list. Copy one value of column OPTION: --platform=<ios|android> for simulator or emulator, --target=<target> for a phone. Use it as <device> below. Phone: bun devices reserve <device> --goal="<what you do>" first, so other agents cannot take it. Pick another phone on device_reserved.
  2. bun app install <device>
  3. bun app seed <device> --fixture=<id> (ids: bun app seed --help)
  4. bun app open <device>
  5. Use the app: bun app drive <device> -- <agent-device args>. Commands: bunx agent-device help workflow. Never call bunx agent-device directly: it skips reservations and picks its own session.
  6. bun app close <device>
  7. Phone: bun devices release <device>

e2e: bun e2e run <device> [--paths=<path,...>]. One device per command. Start one command per phone for parallel runs. Help and errors: bun <noun> <command> --help. devicectl hangs or "Device is busy": bun devices doctor. Limits on phones: development.md.

Waiting

app build, app install, app dev, and e2e run take minutes. First stderr line: Log: <path>, new file per run. Last stdout line: PIXY_RESULT status=<ok|error> command=<name> [code=<status>] [path=<artifact>].

  1. Start the command with run_in_background.
  2. Wait for the exit notification. Read PIXY_RESULT for the result.
  3. To watch progress, Monitor tail -n 0 -F <Log path> | grep -E --line-buffered 'Step |PIXY_RESULT|error:|BUILD FAILED'. Take the path from the Log: line of this run only.
  • Never poll with sleep N; tail. Never reuse old /tmp or log files.
  • Never switch verification surface (web, Playwright, other device) while you wait, unless the user asks.
Show full SKILL.md (213 more words)Show less

Development with Metro (hot reload)

Use when the user edits code and wants to see changes without a native build.

  1. bun app dev --platform=<ios|android>. Installs the cached dev client, starts this checkout's Metro, opens the app, prints a screenshot path. Data and flags in one go: bun app dev --platform=ios --fixture=year --flag=people=on,photos=off. Dev menu stays hidden.
  2. Edit code. The app reloads. Rerun step 1 to reload by hand.
  3. Drive the app: bun app drive --platform=<ios|android> -- <agent-device args>. App ID com.devmood.pixymoodtracker.dev.
  4. bun app close --platform=<ios|android> stops Metro and the device.

Rules:

  • Builds live in ~/.cache/pixy-mood-tracker/build-cache. bun builds list shows them. Never search ios/build or ~/Library/Developer/Xcode/DerivedData, never conclude "no dev build" from them.
  • Never create simulators by hand. The CLI owns one simulator per checkout.
  • Dev client is shared across worktrees with the same native dependencies. A cache miss means native dependencies changed. Compile then, not before.
  • Phones: bun ios --device <udid>.

Shell (zsh)

  • Never put several flags in one variable ($FLAGS). zsh does not split words, so the command gets one argument. Use an array: flags=(--platform=ios); bun app drive "${flags[@]}" -- snapshot
  • Write ${VAR}:path, not $VAR:path. zsh reads :r, :h, :t after $VAR as modifiers.
  • Quote globs in arguments (--include='*.ts'). zsh fails the command on an unmatched glob: no matches found.

© mrzmyr, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/run-app of mrzmyr/pixy-mood-tracker-app.

Open the folder on GitHubat commit fcf43ad

Compare with similar skills

Run App 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.

Run App compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Run App this skillmrzmyr/pixy-mood-tracker-app153—~893Automated safety check: PassMIT
Engine Whats Newflutter/flutter180k—~978Automated safety check: PassBSD-3-Clause
App Store Screenshots GeneratorParthJadhav/app-store-screenshots7.2k—~16kAutomated safety check: PassMIT
Mobilerun Docs Referencedroidrun/mobilerun9.6k—~943Automated safety check: PassMIT
Rnn Codebasewix/react-native-navigation13k—~2kAutomated safety check: PassMIT
Building Native UICherryHQ/cherry-studio-app4k8 repos~2.6kAutomated safety check: PassMIT

Similar skills

  • Engine Whats New

    flutter/flutter

    Generates the "what's new" release summary and diff file for changes in the Flutter engine (//engine/src/flutter) between two releases (e.g., 3.47 vs 3.44).

    180k GitHub stars~978 tokensUpdated today
    MobileAuto-check passed
  • App Store Screenshots Generator

    ParthJadhav/app-store-screenshots

    Scaffolds a Next.js editor for designing App Store and Google Play screenshots as ads and exporting them at every required size, for iOS, Mac and Android.

    7.2k GitHub stars~16k tokensUpdated yesterday
    MobileAuto-check passed
  • Mobilerun Docs Reference

    droidrun/mobilerun

    Answers questions about Mobilerun, the LLM-agent framework for automating Android and iOS devices, by pointing the agent to the right page of its v5 documentation.

    9.6k GitHub stars~943 tokensUpdated yesterday
    MobileAuto-check passed
  • Rnn Codebase

    wix/react-native-navigation

    Official

    Navigate and work with the react-native-navigation (RNN) codebase.

    13k GitHub stars~2k tokensUpdated 5 days ago
    MobileAuto-check passed
  • Building Native UI

    CherryHQ/cherry-studio-app

    Complete guide for building beautiful apps with Expo Router.

    4k GitHub starsUsed in 8 repos~2.6k tokens
    MobileAuto-check passed
  • Sim Use

    lycorp-jp/sim-use

    Drive iOS Simulator, Android emulator/device, and physical iPhone/iPad screens for AI agents.

    1.4k GitHub stars~3.4k tokensUpdated 2 days ago
    MobileAuto-check passed

More from mrzmyr/pixy-mood-tracker-app

  • Competitor Analysis

    mrzmyr/pixy-mood-tracker-app

    Competitor analysis for Pixy (or any mobile app) from public App Store and Google Play data, no API keys.

    153 GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Coding Standards

    mrzmyr/pixy-mood-tracker-app

    A skill your agent uses when writing, reviewing, or refactoring TypeScript

    153 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • PR Proof

    mrzmyr/pixy-mood-tracker-app

    Upload screenshots or videos to a PR body. An agent skill from mrzmyr/pixy-mood-tracker-app.

    153 GitHub stars~571 tokensUpdated today
    Auto-check passed
  • Add Testers

    mrzmyr/pixy-mood-tracker-app

    Add beta testers for Pixy on Android and iOS. An agent skill from mrzmyr/pixy-mood-tracker-app.

    153 GitHub stars~229 tokensUpdated today
    Auto-check passed
  • Test PR

    mrzmyr/pixy-mood-tracker-app

    Run changed e2e flows for a pull request and note the result.

    153 GitHub stars~391 tokensUpdated today
    Auto-check passed
  • Babysit PR

    mrzmyr/pixy-mood-tracker-app

    Monitor a pull request until review comments and CI are handled.

    153 GitHub stars~189 tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Run App

What does Run App do?

Build, install, and run the app on a device. An agent skill from mrzmyr/pixy-mood-tracker-app. Run App is an agent skill from mrzmyr/pixy-mood-tracker-app. Build, install, and run the app on a device.

When should I use Run App?

Run App fits situations like: asked to run the app; run it with Metro for hot reload; install a build on a phone; time a native build.

How do I install Run App in Claude Code?

Run `npx skills add mrzmyr/pixy-mood-tracker-app --skill run-app -a claude-code`. Or copy the skill folder (.agents/skills/run-app in mrzmyr/pixy-mood-tracker-app) into .claude/skills/run-app in your project. Claude Code loads it when a task matches its description.

How do I install Run App in Codex?

Run `npx skills add mrzmyr/pixy-mood-tracker-app --skill run-app -a codex`. Or copy the skill folder (.agents/skills/run-app in mrzmyr/pixy-mood-tracker-app) into .agents/skills/run-app in your project. Codex loads it when a task matches its description.

Can I use Run App 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 mrzmyr/pixy-mood-tracker-app --skill run-app -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/run-app, .gemini/skills/run-app, .github/skills/run-app and .opencode/skills/run-app in your project.

What does Run App need to run?

Going by SKILL.md and its folder, Run App needs the command-line tools its instructions call (bun and bunx).

Does Run App access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Run App safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Run App use?

Run App is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Run App use?

About 893 tokens (SKILL.md is roughly 3.6k 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 Run App?

Skills that share tags, products or a category with Run App: Engine Whats New (flutter/flutter, 180k stars), App Store Screenshots Generator (ParthJadhav/app-store-screenshots, 7.2k stars), Mobilerun Docs Reference (droidrun/mobilerun, 9.6k stars) and Rnn Codebase (wix/react-native-navigation, 13k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Run App?

mrzmyr (a GitHub user) maintains it in mrzmyr/pixy-mood-tracker-app, which has 153 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 11, 2026.

Source: mrzmyr/pixy-mood-tracker-app on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.