Best practices for implementing Android ViewModels using Kotlin 2.3+ Explicit Backing Fields, StateFlow for UI state, and SharedFlow for one-off events.

Apache-2.0Auto-check passedMobile

Install Android Viewmodel

skills CLI
$ npx skills add new-silvermoon/awesome-android-agent-skills --skill android-viewmodel -a claude-code

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

GitHub CLI
$ gh skill install new-silvermoon/awesome-android-agent-skills android-viewmodel --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/new-silvermoon/awesome-android-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/architecture/android-viewmodel .claude/skills/android-viewmodel && 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
android-viewmodel
GitHub stars
972
Used in
1 other repo
Token cost
~1k tokens
SKILL.md length
309 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
Apache-2.0

At a glance

Best practices for implementing Android ViewModels using Kotlin 2.3+ Explicit Backing Fields, StateFlow for UI state, and SharedFlow for one-off events.

  • Works in 7 steps: UI State (StateFlow) → One-Off Events (SharedFlow) → Collecting in Compose → …
  • Tasks that involve Android development
  • SKILL.md covers Instructions, 1. UI State (StateFlow), 2. One-Off Events (SharedFlow) and 3. Collecting in Compose, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Android Viewmodel is an agent skill from new-silvermoon/awesome-android-agent-skills. Best practices for implementing Android ViewModels using Kotlin 2.3+ Explicit Backing Fields, StateFlow for UI state, and SharedFlow for one-off events.

Its SKILL.md is about 1k 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, covering Android development. It works with Android and Kotlin. The repository describes itself as: A collection of standardized Agent Skills to teach GitHub Copilot, Claude, Gemini and Cursor about modern Android development (Kotlin, Jetpack Compose, etc.). The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Android development

Example prompts

  • “/android-viewmodel”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. UI State (StateFlow)
  2. One-Off Events (SharedFlow)
  3. Collecting in Compose
  4. Collecting in XML/View System
  5. Coroutine Scope
  6. State Design
  7. Best Practices

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are kotlin).

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

  • Network

    No URLs in SKILL.md.

    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

Android Viewmodel loads about 1k tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 309 words of instructions outside code blocks.

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

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 new-silvermoon/awesome-android-agent-skills at commit 82900ea, republished under its Apache-2.0 licence (© new-silvermoon). 309 words, ~1,039 tokens.

Download SKILL.mdSave it as .claude/skills/android-viewmodel/SKILL.md (or your agent's skills folder).
name
android-viewmodel
description
Best practices for implementing Android ViewModels using Kotlin 2.3+ Explicit Backing Fields, StateFlow for UI state, and SharedFlow for one-off events.

Android ViewModel & State Management

Instructions

Use ViewModel to own UI state and business logic. It should survive configuration changes and expose immutable APIs.

Kotlin 2.3+

Prefer Explicit Backing Fields instead of the traditional _state/state backing property pattern.

  • Kotlin 2.3: Experimental (-Xexplicit-backing-fields)
  • Kotlin 2.4+: Stable (recommended)

Avoid creating duplicate backing properties unless targeting older Kotlin versions.


1. UI State (StateFlow)

Purpose

Represents the persistent UI state.

Examples:

  • Loading
  • Success(data)
  • Error(message)
  • Empty
Declaration

Use an explicit backing field.

kotlin
val uiState: StateFlow<UiState>
    field = MutableStateFlow(UiState.Loading)

The backing field is mutable (MutableStateFlow) while consumers only see StateFlow.

Updating State

Prefer update { } for atomic updates.

kotlin
_uiState.update { old ->
    old.copy(isLoading = false)
}

With explicit backing fields:

kotlin
uiState.update {
    it.copy(isLoading = false)
}

You may also assign directly when appropriate.

kotlin
uiState.value = UiState.Success(data)

2. One-Off Events (SharedFlow)

Purpose

Use for transient events that should not survive recomposition or configuration changes.

Examples:

  • Navigate
  • Show Snackbar
  • Show Toast
  • Open Dialog
  • Request Permissions
Declaration
kotlin
val uiEvent: SharedFlow<UiEvent>
    field = MutableSharedFlow(
        replay = 0,
        extraBufferCapacity = 1
    )

replay = 0 ensures events are not replayed after recreation.

Using extraBufferCapacity = 1 is recommended for UI events sent with tryEmit().

Sending Events

Suspend:

kotlin
uiEvent.emit(UiEvent.NavigateBack)

Non-suspending:

kotlin
uiEvent.tryEmit(UiEvent.ShowSnackbar("Saved"))

3. Collecting in Compose

StateFlow

Always collect lifecycle-aware.

kotlin
val state by viewModel.uiState.collectAsStateWithLifecycle()
SharedFlow

Collect inside a single LaunchedEffect.

kotlin
LaunchedEffect(Unit) {
    viewModel.uiEvent.collect { event ->
        when (event) {
            is UiEvent.NavigateBack -> { /* ... */ }
            is UiEvent.ShowSnackbar -> { /* ... */ }
        }
    }
}

Do not collect SharedFlow with collectAsState().


4. Collecting in XML/View System

Use lifecycle-aware collection.

kotlin
lifecycleScope.launch {
    repeatOnLifecycle(Lifecycle.State.STARTED) {
        viewModel.uiState.collect {
            render(it)
        }
    }
}

Likewise for events.

kotlin
lifecycleScope.launch {
    repeatOnLifecycle(Lifecycle.State.STARTED) {
        viewModel.uiEvent.collect(::handleEvent)
    }
}

5. Coroutine Scope

Launch all ViewModel work in viewModelScope.

kotlin
viewModelScope.launch {
    repository.refresh()
}

Business logic should preferably be delegated to UseCases or Repositories.


6. State Design

Represent the entire screen with a single immutable state object.

kotlin
data class UiState(
    val isLoading: Boolean = false,
    val items: List<Item> = emptyList(),
    val error: String? = null
)

Avoid exposing multiple unrelated StateFlows for one screen unless they truly have different lifecycles.


7. Best Practices

Expose immutable APIs (StateFlow, SharedFlow)

Prefer Explicit Backing Fields (Kotlin 2.4+)

Use immutable UI state

Use update {} when modifying state

Keep one-off events in SharedFlow

Keep business logic out of Composables

Use collectAsStateWithLifecycle()

Use repeatOnLifecycle() in Views

Launch work in viewModelScope

Do not expose MutableStateFlow

Do not use StateFlow for navigation events

Do not use SharedFlow for persistent screen state

Do not keep duplicate _state properties when Explicit Backing Fields are available

© new-silvermoon, Apache-2.0. 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 .github/skills/architecture/android-viewmodel of new-silvermoon/awesome-android-agent-skills.

Open the folder on GitHubat commit 82900ea

Used in 1 other repository

We found 3 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in new-silvermoon/awesome-android-agent-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Android Viewmodel 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.

Android Viewmodel compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Android Viewmodel this skillnew-silvermoon/awesome-android-agent-skills9721 repos~1kAutomated safety check: PassApache-2.0
Android Hidden API and R8 Checkgkd-kit/gkd43k—~1.5kAutomated safety check: PassGPL-3.0
Compose Multiplatform Patternsmonta-app/ocpp-emulator1805 repos~2kAutomated safety check: PassApache-2.0
Android Developmentdpconde/claude-android-skill336—~1.7kAutomated safety check: PassMIT
Architecture Overclocknekomangaorg/Neko2.8k—~1.4kAutomated safety check: PassApache-2.0
Claude Android NinjaDrjacky/claude-android-ninja124—~5.2kAutomated safety check: PassApache-2.0

Similar skills

  • Checks whether Android hidden-API implementations and system callbacks survive R8 minification, and diagnoses Release-only failures such as AbstractMethodError.

    43k GitHub stars~1.5k tokensUpdated yesterday
    MobileAuto-check passed
  • Compose Multiplatform Patterns

    monta-app/ocpp-emulator

    Compose Multiplatform and Jetpack Compose patterns for KMP projects — state management, navigation, theming, performance, and platform-specific UI.

    180 GitHub starsUsed in 5 repos~2k tokens
    MobileAuto-check passed
  • Android Development

    dpconde/claude-android-skill

    Create production-quality Android applications following Google's official architecture guidance and NowInAndroid best practices.

    336 GitHub stars~1.7k tokensUpdated 10 mo ago
    MobileAuto-check passed
  • Architecture Overclock

    nekomangaorg/Neko

    Resolves deep, structural performance bottlenecks in the Kotlin Android codebase.

    2.8k GitHub stars~1.4k tokensUpdated today
    MobileAuto-check passed
  • Claude Android Ninja

    Drjacky/claude-android-ninja

    Build and migrate Android apps with Kotlin, Jetpack Compose, MVVM, Hilt, Room 3 (KSP, SQLiteDriver, Flow/suspend DAOs), Navigation3, and multi-module Gradle.

    124 GitHub stars~5.2k tokensUpdated 8 days ago
    MobileAuto-check passed
  • Expo Brownfield Integration

    mweinbach/agent-coworker

    Helps add Expo and React Native to an existing native iOS or Android app, and choose between a prebuilt AAR or XCFramework and a fully integrated build.

    156 GitHub starsUsed in 2 repos~900 tokens
    MobileAuto-check: notes

More from new-silvermoon/awesome-android-agent-skills

  • Navigation3

    new-silvermoon/awesome-android-agent-skills

    Implement navigation in Jetpack Compose using Navigation 3. An agent skill from new-silvermoon/awesome-android-agent-skills.

    972 GitHub stars~1.9k tokensUpdated 2 mo ago
    Auto-check passed

Works with

Categories

Questions about Android Viewmodel

What does Android Viewmodel do?

Best practices for implementing Android ViewModels using Kotlin 2.3+ Explicit Backing Fields, StateFlow for UI state, and SharedFlow for one-off events. Android Viewmodel is an agent skill from new-silvermoon/awesome-android-agent-skills.3+ Explicit Backing Fields, StateFlow for UI state, and SharedFlow for one-off events.

When should I use Android Viewmodel?

Android Viewmodel fits situations like: tasks that involve Android development.

How do I install Android Viewmodel in Claude Code?

Run `npx skills add new-silvermoon/awesome-android-agent-skills --skill android-viewmodel -a claude-code`. Or copy the skill folder (.github/skills/architecture/android-viewmodel in new-silvermoon/awesome-android-agent-skills) into .claude/skills/android-viewmodel in your project. Claude Code loads it when a task matches its description.

How do I install Android Viewmodel in Codex?

Run `npx skills add new-silvermoon/awesome-android-agent-skills --skill android-viewmodel -a codex`. Or copy the skill folder (.github/skills/architecture/android-viewmodel in new-silvermoon/awesome-android-agent-skills) into .agents/skills/android-viewmodel in your project. Codex loads it when a task matches its description.

Can I use Android Viewmodel 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 new-silvermoon/awesome-android-agent-skills --skill android-viewmodel -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/android-viewmodel, .gemini/skills/android-viewmodel, .github/skills/android-viewmodel and .opencode/skills/android-viewmodel in your project.

What does Android Viewmodel need to run?

SKILL.md names no scripts, command-line tools or credentials: Android Viewmodel is instructions for the agent only.

Does Android Viewmodel 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 Android Viewmodel 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 Android Viewmodel use?

Android Viewmodel is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Android Viewmodel use?

About 1k tokens (SKILL.md is roughly 4.2k 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 Android Viewmodel?

Skills that share tags, products or a category with Android Viewmodel: Android Hidden API and R8 Check (gkd-kit/gkd, 43k stars), Compose Multiplatform Patterns (monta-app/ocpp-emulator, 180 stars), Android Development (dpconde/claude-android-skill, 336 stars) and Architecture Overclock (nekomangaorg/Neko, 2.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Android Viewmodel?

new-silvermoon (a GitHub user) maintains it in new-silvermoon/awesome-android-agent-skills, which has 972 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on July 27, 2026.

Source: new-silvermoon/awesome-android-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.