Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    Frame Performance Check (Flutter & React Native)

    1

    Find the work your Flutter, React Native or Expo app or game repeats every frame or every render, fix it, and prove the fix helped without being fooled by a hot phone.

    Free

    2 usesSecurity scanned
    Frame Performance Check (Flutter & React Native)

    Frame Performance Check (Flutter & React Native)

    Example session with this skill installed

    This game stutters on my old phone. Find out why.

    • Read your context and instructions
    • Compiled the frame performance check

    What I ran

    Frame cost: my-game
      157 source file(s), 9 with per-frame methods
    
      NOTE  paint-per-frame  (2)
            packages/ui/lib/screens/game/game/components/splat_component.dart:48
            packages/ui/lib/screens/game/game/components/splat_component.dart:55
            a Paint allocated inside a per-frame method; hoist it to a field when its colour does not change
    
    Each of these is a hypothesis. Measure it, paired, before and after: see SKILL.md.
    

    What it means

    Two Paint objects are built inside a per-frame method of a Flame component, so they're rebuilt every frame for every splat on screen. If the colour doesn't change, they can be fields.

    Next steps

    1. Hoist both Paints to fields.
    2. Measure with paired_bench.py, old and new builds alternated in pairs, so a phone warming up halfway through doesn't make the second run look slower.
    3. Keep the fix only if the paired numbers say it helped.

    Output is from a real run on one of my games (name changed).

    Connects securely to your tools. The creator never sees your data.

    About this skill

    Most Flutter jank I've chased came from the same place: something built inside render, paint or update that only needed building once. A Paint, a Path, a TextPainter, a list. Analyze is clean and the tests pass, and the game drops frames on a three-year-old phone.

    This skill finds those shapes in Flame games, CustomPainters and custom canvas code, fixes them, then measures. The benchmark runs the old and new versions in alternating pairs, because a phone that heats up halfway through a test makes the second run look slower whatever you changed.

    It also works on React Native and Expo. There it looks for react-native-skia objects (paints, shaders, paths, colour parsing, text measuring) built inside per-frame code, allocations and unguarded runOnJS in Reanimated worklets, setState inside requestAnimationFrame loops, and re-render costs: inline props passed to memo() children, StyleSheet.create inside a component, sorting or JSON work in a component body, lists mapped inside a ScrollView, and inline renderItem. A small frame_probe.ts logs p50, p95 and max frame intervals for the UI and JS threads.

    Scripts: check_perf.py, paired_bench.py, frame_probe.dart, frame_probe.ts.

    These are free and MIT-licensed, and the source is at github.com/jameskrupnik/indie-app-skills. If you ship several apps, my paid skills cover the rest of the release: new-app (forking without carrying the parent's Firebase and ad ids), ship-ios (fork to App Store review), bug-hunt and daily-update (pacing releases across many apps).

    Only tested in Claude Code. The script flags shapes, and each one is a hypothesis until it's measured. Benchmarks are only meaningful on a real device or a quiet machine.

    How to use

    1. 1

      Connect your agent to the Agensi MCP

      Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup

    2. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before any payment.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill goes through the trust checks below.

    Security scanned

    Checked by our 8-point scan before listing

    2 uses

    Times used to date

    Free forever

    No account required to browse

    Trust & safety

    Security scan

    Security scan passed 1 month ago

    • Free with an Agensi account

    Requires

    expo
    Node.js

    Permissions

    Terminal / Shell
    Read Files
    Write Files

    File Scopes

    your
    project/**

    Reads your Dart code and edits it to apply a fix. Runs python3, and flutter for benchmarks. No network.

    Listed1 month ago
    Updated1 month ago

    What's inside

    Frequently Asked Questions

    This skill targets 'hidden' jank caused by objects like Path, Paint, or TextPainter being unnecessarily recreated inside build or render loops, which often passes standard static analysis but causes frame drops on older hardware.

    The skill includes `check_perf.py` for code analysis, `frame_probe.dart` for instrumentation, and `paired_bench.py`, which uses an alternating execution method to ensure thermal throttling doesn't skew your benchmark results.

    Yes, while it is highly effective for standard Flutter CustomPainters, it includes specific logic optimized for the Flame game engine's update and render cycles.

    The skill is compatible with most AI agents that have access to your local filesystem and can execute Python and Dart commands, such as GitHub Copilot, Cursor, or Windsurf.

    Unlike standard benchmarks that run Version A then Version B, this tool alternates them in pairs; this ensures that as the device heats up, both versions are equally affected by CPU throttling for a fair comparison.

    This specific skill is free and MIT-licensed, but it serves as a specialized entry point to a broader suite of paid 'Indie App Skills' designed for full-cycle Flutter app management and deployment.

    New in Mobile Development