Compose performance

Skill GDvega/super-android-kotlin-firebase-skill/skills/compose-performance

A modular Agent Skills repository for Android, Kotlin, Jetpack Compose and Firebase development.

Install

npx -y skills add GDvega/super-android-kotlin-firebase-skill --skill compose-performance

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use for Compose recomposition, stability, LazyColumn/LazyGrid performance, derivedStateOf, remember, keys, baseline profiles, tracing and measurement.

SKILL.md

3.0 KB, as published. Nobody here has run it

Purpose

Diagnose and fix measurable Compose performance issues without guessing.

When to use

A screen scrolls poorly or drops frames.
Recomposition counts spike unexpectedly.
Lazy lists, side effects or state reads are suspected performance causes.
Baseline profiles, tracing or performance CI are needed.

Inputs to inspect

Affected composables and state models.
Profiler, compiler report or benchmark evidence if available.
Lazy list item models and keys.
Build variants and benchmark tasks.

Required workflow

Reproduce or describe the performance symptom.
Inspect state reads, stability, keys and side effects.
Apply the smallest targeted fix.
Measure again with available tools.
Document residual risks and validation gaps.

Rules

Measure before large rewrites.
Do not add remember everywhere blindly.
Do not use @Stable/@Immutable unless the contract is true.
Use stable lazy keys and content types when needed.
Prefer release-mode measurement for meaningful performance claims.

Related existing skills

Local skills to invoke

jetpack-compose
macrobenchmark-baseline-profiles
screen-ux-audit
testing

External companion skills to use when installed

Do not assume these companion skills are installed. Prefer the local skills above first, then consult Companion Skills for install and verification commands.

aldefy/compose-skill — use for deeper Jetpack Compose, Material 3, design-to-code, theming or Compose architecture guidance.
skydoves/compose-performance-skills — use for deeper Compose performance, recomposition, stability or release-mode measurement guidance.

Files commonly touched

Compose screens
UI models
benchmark module
baseline-prof.txt
build.gradle.kts

Commands to validate

./gradlew assembleRelease
./gradlew connectedBenchmarkAndroidTest
./gradlew test
adb shell am profile start

Common mistakes to avoid

Optimizing from intuition only.
Ignoring image size/loading.
Using unstable mutable models as parameters.
Missing lazy item keys.

Checklist

Symptom known.
Stability/recomposition checked.
Lazy keys checked.
Measurement command provided.
Fix does not harm readability.

Example prompts

Use $super-android-kotlin-firebase to diagnose jank in this LazyColumn.
Use $super-android-kotlin-firebase to review Compose stability and recomposition.

Expected response style

Respond with: brief diagnosis, change plan, affected files, code or diff summary, validation commands, tests added or recommended, risks, and next step. For review tasks, lead with findings ordered by severity.

References

../../docs/audits/FUENTES_LOCALES.md
references/recomposition-checklist.md
templates/performance-investigation-template.md