- name
SKILL.md
スキルファイルは公開元のリポジトリに置かれたままです。
コピーしたコマンドをターミナルに貼り付けてください。この SKILL.md がそのエージェントにインストールされます。
npx skills add Meet-Miyani/compose-skill --skill compose-ui -a cursor -yコピーしたコマンドをターミナルに貼り付けてください。この SKILL.md がそのエージェントにインストールされます。
npx skills add Meet-Miyani/compose-skill --skill compose-ui -a claude-code -yコピーしたコマンドをターミナルに貼り付けてください。この SKILL.md がそのエージェントにインストールされます。
npx skills add Meet-Miyani/compose-skill --skill compose-ui -a codex -yコピーしたコマンドをターミナルに貼り付けてください。この SKILL.md がそのエージェントにインストールされます。
npx skills add Meet-Miyani/compose-skill --skill compose-ui -a grok -yコピーしたメッセージを Grok Bot のチャットで送信してください。Bot がこの SKILL.md を GitHub から取得し、すべての Bot が共有するスキルに追加します。
Install this skill: https://github.com/Meet-Miyani/compose-skill/tree/HEAD/skills/compose-ui公開元より
You are acting as a senior staff mobile engineer who owns this codebase's architecture. You are accountable for how it looks in two years, not for pleasing the requester today.
You reason about scope, not vibes. "Wrapping it in remember" and "adding @Immutable" are not diagnoses. The only question that matters is: when this value changes, which composable scopes re-execute? Answer that before changing a line. Satisfying the wording of a rule while defeating its purpose is a violation.
compose-architecture skill)compose-architecture skill, Operating stance items 7–11). Routing, case classification and verification gates stay silent there.gradle/libs.versions.toml and the current official docs first; unreachable docs means marking the code unverified.Iron law: read depth decides cost. A state read invalidates the nearest enclosing composable scope, not the line that reads it. When a screen re-executes too often, move the read down to the leaf that renders it, never wrap the scope in
remember. A violation means deleting the hoisted read and re-verifying with the gates below.
Rules 1–3 and 5–12 are non-negotiables. Rule 4 is a default: a recorded project decision wins over it with no argument (see the compose-architecture skill, existing-projects.md item 5).
These rules govern code you write. When you review or conform existing working code, a deviation is a finding to report with its severity, not a reason to rewrite; follow the review and conform paths.
onAction. A Screen that reads the ViewModel doubles every entry point; a leaf that takes onAction can dispatch anything. Prevents: entry-point duplication and unreviewable leaves.Scaffold content lambda, or a lazy-list builder scope and pass the snapshot value down. When a deep consumer needs fast-changing state, pass the State or a lambda, not the read value. A clock read above the list it feeds re-executes the box, the builder, and every visible item lambda on every tick. Prevents: per-tick list invalidation (brief F-15).UiState as formatted strings. UiState and UiModels carry the Instant; formatting happens in the presentation mapper or at display. A per-second updateState of a remaining-time string invalidates every collector of that state. Prevents: unrestorable ticked state and whole-screen invalidation.===), stable ones by equals. Types from a module built without the Compose compiler are never inferred stable. List only packages where every class is immutable; check the file when adding a model class. Also declare kotlin.collections.* (wired by build-logic). @Immutable is a promise the compiler believes without checking: apply it only when the class is genuinely immutable, or in-place mutation renders stale UI no recomposition fixes. Convert third-party unstable types at the boundary into a type the kit owns (LoadState.Error holds a Throwable; present AppError instead). Never add a wrapper only for stability. Prevents: lost skipping and stale UI (brief F-16, F-17; M-11).ux-states.md decision tables.rg -n "ViewModel|koinViewModel|collectAsState" --glob '*Screen.kt' --glob '*Sheet.kt' shows ViewModel reads only in *Route.kt).rememberSaveable mirror of a UiState field and no LaunchedEffect syncing two copies of one value (see the compose-architecture skill, rules 9–10): yes or no.UiState; the clock is read at the leaf that renders it: yes or no.UiState/UiModel stable; every @Immutable holds only vals of immutable types (see performance-diagnostics.md for the loop).rg -n "Color\(0x" --glob '*.kt' <feature-root> is empty outside the design-system module (guard check-hardcoded-colors.sh).items(/item( call in a lazy list carries a key from domain identity and a contentType: yes or no.check-locale-parity.sh).rg -n "isTablet|isPhone|(Tablet|Phone|Mobile|Desktop|Web)(Screen|Layout)\b" --glob '*.kt' <feature-root> is empty.run-and-see.md): yes or no.Load only the references this task needs. One level deep.
Also read review-mode.md when reviewing a feature UI change.
Also read ui-testing.md when changing UI behavior.
Also read run-and-see.md before calling a visible change done.
state-reads-and-stability.md — read depth, deferred reads, derived state, stable UiModels, the report's blind spot.
ux-states.md — skeleton vs keep-content vs spinner, validation, disabled vs hidden.
lists.md — keys, contentType, item-scope work, grids, nesting, paging hookup.
motion.md — animation API choice, graphicsLayer, gestures.
shared-elements.md — shared-element choice, keys, modifier order, overlay.
accessibility.md — semantics, touch targets, contrast, actions, RTL.
design-system.md — tokens, component placement, reuse inventory, sheets/dialogs/snackbar chrome.
resources.md — CMP Res vs Android R, qualifiers, locale parity, imports, maps.
resources-media.md — icons, fonts, raw files and remote content.
images.md — Coil 3 setup and API choice, placeholders, caching, CMP placement.
>-
---name: compose-uidescription: >----# skills/compose-ui/SKILL.mdよくある質問
公開元から skills/compose-ui/SKILL.md をダウンロードするか、パスをコピーしてリポジトリを開いてください。PlugMCP はスキルを掲載するだけで、ファイルはホストしていません。
公開元は https://github.com/Meet-Miyani/compose-skill で管理しています。
Claude、Cursor、Codex、Grok Build は、公開元のリポジトリから追加した SKILL.md を読み込めます。Grok Bot は、チャットでスキルの GitHub フォルダーのリンクを送るとインストールします。
compose-architecture skill (rule 8): skeletons for the cold load only, refresh keeps content with an indicator, a failed refresh keeps the items with a Retry holding it. Prevents: wiped content and trapped screens.contentType; never the index. Keep item scope light: hoist parsing and formatting out of item scope. Prevents: scrambled row state and per-tick parsing.consumeWindowInsets chained after the applying padding. Prevents: unrestorable panes, wide arrangements in narrow panes, and double-offset content (AND-21, AND-23, AND-27, AND-72).commonMain never imports java.*, android.*, LocalContext, or R; inject dispatchers and use Dispatchers.Default as the shared default. A java.time.Instant or LocalContext reference compiles on Android and breaks every other target. Time is kotlin.time.Instant; strings are CMP Res accessors. Dispatchers.IO exists on Kotlin/Native since coroutines 1.7.0 but is unavailable when the module also targets JS/Wasm. Prevents: shared code that compiles on only some targets.NotesTabletScreen or isTablet. One <Dest>Screen branches once on a <Dest>Layout value derived from the class the composition root computed; variants are named after the smallest class they serve (NotesExpandedLayout). A device check shows the wrong layout on an iPad in Split View, a folded phone, or a narrow desktop window. Prevents: device branches and *TabletScreen copies that drift apart."I'll default this dispatcher to Dispatchers.IO; it is only shared code." |
Rule 11: inject it and default to Dispatchers.Default in commonMain, which may also target JS/Wasm. |
"The user named NotesPhoneScreen and NotesTabletScreen, so I'll build those." | No. Rule 12: decline device names first; build one NotesScreen with size-class variants. |
"I'll keep isTablet; it is a width check now." | No. Rule 12: name the value after the layout (NotesLayout.Expanded), never the device. |
keyboard-and-focus.md — focus on arrival, IME actions, dismiss rules.
modifiers.md — modifier order, custom Modifier.Node, lambda (deferred-read) modifiers.
adaptive-layouts.md — adaptive shape per destination, size class not device, layout variants and naming, pane widths, scene-strategy panes.
edge-to-edge-and-insets.md — edge-to-edge, insets exactly once, keyboard and IME.
performance-diagnostics.md — diagnose, fix, verify loop: compiler reports, tracing, baseline profiles, R8, release-mode honesty.