Diagnosing Compose Stability
Use this skill to diagnose Jetpack Compose stability problems by enabling and reading...
Install
npx skills add skydoves/compose-performance-skills --skill diagnosing-compose-stability -g -a claude-code -y- Repository
- skydoves/compose-performance-skills524
- Category
- Engineering
- Updated
- 5mo ago
- License
- Apache-2.0
- Context cost
- Mediumabout 3,000 tokens
- Runs scripts
- No, instructions only
What it does
Use this skill to diagnose Jetpack Compose stability problems by enabling and reading the Compose Compiler Reports (classes.txt, composables.txt, composables.csv, module.json). Covers the Gradle DSL, the release-only build requirement, and how to interpret per-class and per-composable stability annotations including stable, unstable, runtime, restartable, skippable, readonly, @static, and @dynamic markers. Use when the developer asks "why does this recompose", reports jank, dropped frames, slow scroll, high recomposition count, suspects an unstable parameter, mentions Compose Compiler Reports, classes.txt, composables.txt, module.json, or wants to know which composables are non-skippable. The fix lives in a sibling skill, this one only diagnoses.
Diagnosing Compose Stability, Read the Compiler Reports First
Compose skips recomposition by comparing parameters. When a parameter is unstable, skipping is disabled, this skill tells Claude how to find out which parameters are unstable and why. The output is a prioritized list of unstable types and non-skippable composables; the fix lives in ../stabilizing-compose-types/SKILL.md.
When to use this skill
- The developer asks "why does this recompose?", reports jank, dropped frames, or scroll stutter.
- A
@TraceRecompositionlog shows recomposition counts that exceed the number of meaningful state changes. - The developer mentions Compose Compiler Reports,
classes.txt,composables.txt,composables.csv,module.json, or "non-skippable". - The developer asks how to find unstable parameters, or whether
List<Foo>,LocalDateTime, or a domain type is stable. - A reviewer asks for evidence that a perf-sensitive composable is skippable.
When NOT to use this skill
- The unstable types are already known, jump straight to
../stabilizing-compose-types/SKILL.md. - The symptom is a wrong-phase state read (
Modifier.alpha(state.value)); use../../recomposition/deferring-state-reads/SKILL.md. - The symptom is a
derivedStateOfmisuse; use../../recomposition/choosing-derivedstateof/SKILL.md. - The developer wants CI gating instead of one-shot diagnosis; use
../enforcing-stability-in-ci/SKILL.md.
