Agent skill

Kmp Starter Navigation

by DevAtrii in DevAtrii/Kmp-Starter-Template

Navigation on the KMP Starter Template using navigation3 — AppScreens, polymorphic registration, AppNavigationModule routes, StarterNavigator, nested navigation (scoped navigators, Nav3Transitions…

MITAuto-check passedMobile

Install Kmp Starter Navigation

skills CLI
$ npx skills add DevAtrii/Kmp-Starter-Template --skill kmp-starter-navigation -a claude-code

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

GitHub CLI
$ gh skill install DevAtrii/Kmp-Starter-Template kmp-starter-navigation --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/DevAtrii/Kmp-Starter-Template.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/kmp-starter/navigation .claude/skills/kmp-starter-navigation && 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
kmp-starter-navigation
GitHub stars
167
Token cost
~2.4k tokens
SKILL.md length
415 words
Files
1
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

Navigation on the KMP Starter Template using navigation3 — AppScreens, polymorphic registration, AppNavigationModule routes, StarterNavigator, nested navigation (scoped navigators, Nav3Transitions…

  • Works in 5 steps: Define screens → Register for serialization → Define route (Koin) → …
  • Tasks that involve Project scaffolding
  • SKILL.md covers 1. Define screens, 2. Register for serialization, 3. Define route (Koin) and 4. Navigate, plus 6 more sections
  • Reaches starter.atherio.dev

What it does

Kmp Starter Navigation is an agent skill from DevAtrii/Kmp-Starter-Template. Navigation on the KMP Starter Template using navigation3 — AppScreens, polymorphic registration, AppNavigationModule routes, StarterNavigator, nested navigation (scoped navigators, Nav3Transitions, entry decorators), and ResultStore.

Its SKILL.md is about 2.4k 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 Project scaffolding. The repository describes itself as: Starter template is a multi-module KMP boilerplate for Android & iOS with clean architecture and high-quality code. It handles basics like remote config, in-app purchases, and… The licence is MIT.

When your agent uses it

  • Tasks that involve Project scaffolding

Example prompts

  • “/kmp-starter-navigation”

Workflow steps

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

  1. Define screens
  2. Register for serialization
  3. Define route (Koin)
  4. Navigate
  5. Change initial screen

What it can do on your machine

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

    Hosts in commands or code, which the agent is likely to contact:

    • starter.atherio.dev

    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

Kmp Starter Navigation loads about 2.4k tokens when it runs. Until then it costs about 64 tokens; SKILL.md has 415 words of instructions outside code blocks.

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

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 DevAtrii/Kmp-Starter-Template at commit a8f7b27, republished under its MIT licence (© DevAtrii). 415 words, ~2,363 tokens.

Download SKILL.mdSave it as .claude/skills/kmp-starter-navigation/SKILL.md (or your agent's skills folder).
name
kmp-starter-navigation
description
Navigation on the KMP Starter Template using navigation3 — AppScreens, polymorphic registration, AppNavigationModule routes, StarterNavigator, nested navigation (scoped navigators, Nav3Transitions, entry decorators), and ResultStore.
author
DevAtrii
license
MIT

Navigation

Uses navigation3 + Koin. Global navigation lives in composeApp/core/navigation.

1. Define screens

composeApp/src/commonMain/kotlin/<your-package>/core/navigation/AppScreens.kt:

kotlin
@Serializable
@Stable
sealed class AppScreens : NavKey {
    @Serializable
    data object Home : AppScreens()
}

Rules: must be @Serializable; must extend NavKey; one sealed class per feature. Mark @Stable too. Group many screens into nested sealed classes (e.g. App, Web, Plugins) to keep one hierarchy.

2. Register for serialization

In composeApp/.../App.kt, AppConfig.navigationPolymorphicBuilder:

kotlin
val navigationPolymorphicBuilder: PolymorphicModuleBuilder<NavKey>.() -> Unit = {
    subclass(AppScreens.Home::class)
    // ... every screen
}

Missing registration → state restoration fails.

3. Define route (Koin)

composeApp/src/commonMain/kotlin/<your-package>/core/navigation/AppNavigationModule.kt:

kotlin
val appNavigationModule = module {
    includes(navigationCoreModule)

    navigation<AppScreens.Home> { route ->
        val navigator = StarterNavigator.getCurrent()
        HomeScreen(onTaskComplete = { navigator.navigateUp() })
    }
}

4. Navigate

kotlin
val navigator = StarterNavigator.getCurrent()

navigator.navigateTo(route)            // push
navigator.popAndNavigate(route)        // pop current, then push
navigator.popAllAndNavigate(route)     // clear stack, then push
navigator.navigateOrBringToTop(route)  // single instance, bring to top
navigator.navigateUp()                 // pop
navigator.remove(route)                // remove a destination

StarterNavigator extends BaseNavigator (features/navigation/.../BaseNavigator.kt) and is provided by Koin via navigationCoreModule.

5. Change initial screen

composeApp/.../App.kt → StarterNavigation(AppScreens.Splash, ...). First argument is the start screen.

Rules

  • Feature modules never contain app navigation logic; they expose composables only.
  • composeApp owns navigation.
  • ViewModels never navigate directly; screens call navigator from callbacks.

Nested navigation

When a feature owns multiple internal screens (e.g. a bottom-nav root with several tabs), it defines its own navigation graph inside the feature. Isolate everything in a nested_navigation package.

1. Define screens

A sealed class in the feature's nested-nav package (@Serializable, extend NavKey):

kotlin
@Serializable
sealed class FeatureScreens : NavKey {
    @Serializable data object Home : FeatureScreens()
    @Serializable data object History : FeatureScreens()
    @Serializable data object Settings : FeatureScreens()
}
2. Create the Koin scope

A scope object + getOrCreateScope() so the nested navigator (and any scoped deps) live/die with the feature:

kotlin
internal object FeatureNavScope {
    private val QUALIFIER = qualifier<FeatureNavScope>()
    private val ID = QUALIFIER.toString()

    @Composable
    fun getOrCreateScope() = getKoin().getOrCreateScope(scopeId = ID, qualifier = QUALIFIER)
}
3. Create the nested navigator

Extend BaseNavigator and add a getCurrent() companion that injects from the scope:

kotlin
internal class FeatureNestedNavigator : BaseNavigator() {
    companion object {
        @Composable
        fun getCurrent(): FeatureNestedNavigator =
            koinInject(scope = FeatureNavScope.getOrCreateScope())
    }
}

To signal the parent (e.g. "open a screen owned by the app, with args"), expose events from the navigator itself:

kotlin
    private val scope = CoroutineScope(Dispatchers.Main + SupervisorJob())
    private val _events = MutableSharedFlow<FeatureNestedNavigationEvents>(replay = 0)
    val events: SharedFlow<FeatureNestedNavigationEvents> = _events.asSharedFlow()

    fun emitEvent(event: FeatureNestedNavigationEvents) {
        scope.launch { _events.emit(event) }
    }

internal sealed class FeatureNestedNavigationEvents {
    data class OnNavigateToDetail(val id: String) : FeatureNestedNavigationEvents()
    data object OnNavigateToPurchases : FeatureNestedNavigationEvents()
}
4. Register routes in a Koin module

One module per feature graph, scope<FeatureNavScope> { scoped { Navigator() } + navigation<Screen> { ... } }:

kotlin
val featureNestedNavigationModule = module {
    scope<FeatureNavScope> {
        scoped { FeatureNestedNavigator() }
        navigation<FeatureScreens.Home> {
            val navigator = FeatureNestedNavigator.getCurrent()
            HomeScreen(
                onNavigateToDetail = { id ->
                    navigator.emitEvent(FeatureNestedNavigationEvents.OnNavigateToDetail(id))
                },
                onNavigateToPurchases = {
                    navigator.emitEvent(FeatureNestedNavigationEvents.OnNavigateToPurchases)
                },
            )
        }
        navigation<FeatureScreens.History> { HistoryScreen() }
        navigation<FeatureScreens.Settings> {
            val navigator = FeatureNestedNavigator.getCurrent()
            SettingsScreen(
                onNavigateToPurchases = {
                    navigator.emitEvent(FeatureNestedNavigationEvents.OnNavigateToPurchases)
                },
            )
        }
    }
}
Show full SKILL.md (187 more words)Show less
5. Root screen

The root composable holds the back stack, wires the navigator, and observes navigator events to bubble navigation up to the app:

kotlin
@Composable
fun FeatureRootScreen(
    onNavigateToDetail: (id: String) -> Unit,
    onNavigateToPurchases: () -> Unit,
) {
    FeatureRootScreenContent()

    val navigator = FeatureNestedNavigator.getCurrent()
    ObserveAsEvents(flow = navigator.events) { event ->
        when (event) {
            is FeatureNestedNavigationEvents.OnNavigateToDetail ->
                onNavigateToDetail(event.id)
            FeatureNestedNavigationEvents.OnNavigateToPurchases -> onNavigateToPurchases()
        }
    }
}

@Composable
private fun FeatureRootScreenContent() {
    val koinScope = rememberKoinScope(scope = FeatureNavScope.getOrCreateScope())
    val entryProvider = koinEntryProvider<Any>(scope = koinScope)
    val backStack: NavBackStack<NavKey> = rememberNavBackStack(FeatureScreens.Home) {
        subclass(FeatureScreens.Home::class)
        subclass(FeatureScreens.History::class)
        subclass(FeatureScreens.Settings::class)
    }

    val navigator = FeatureNestedNavigator.getCurrent()
    LaunchedEffect(backStack) { navigator.provideBackStack(backStack) }

    Scaffold(bottomBar = {
        // tab bar; each tab -> navigator.navigateOrBringToTop(item.route)
    }) { innerPaddings ->
        NavDisplay(
            modifier = Modifier.padding(bottom = innerPaddings.calculateBottomPadding()),
            backStack = backStack,
            entryProvider = entryProvider,
            transitionSpec = Nav3Transitions.horizontalSlideParallax(),
            popTransitionSpec = Nav3Transitions.horizontalSlideParallaxPop(),
            predictivePopTransitionSpec = Nav3Transitions.predictiveHorizontalSlideParallax(),
        )
    }
}

Key points:

  • Use rememberKoinScope(scope = FeatureNavScope.getOrCreateScope()) + koinEntryProvider<Any>(scope = koinScope) — the entry provider is scoped, so screen-level ViewModels resolve inside the feature scope.
  • Bind navigator with scoped { FeatureNestedNavigator() } in the scope; retrieve with getCurrent() (which injects from the same scope).
  • Tab switching uses navigator.navigateOrBringToTop(route) (single instance per tab).
  • Bubble "leave the feature" actions up via navigator events + ObserveAsEvents — feature modules never touch app navigation directly.
  • Transitions via Nav3Transitions (horizontalSlideParallax / fade / etc.). Pick per platform if needed (platform.isAndroid / platform.isIos).

Register the feature's *NestedNavigationModule in InitKoin (see koin skill).

Flow

  1. Create screen (@Serializable @Stable sealed class : NavKey)
  2. Register in navigationPolymorphicBuilder
  3. Add route in AppNavigationModule (or custom module)
  4. Use StarterNavigator
  5. Change initial screen if needed

Screen-to-screen results (ResultStore)

To send a result back or signal a parent without a direct nav-arg (e.g. "open the drawer" from a child), use ResultStore (features/navigation/.../utils/ResultStore.kt).

kotlin
val resultStore = rememberResultStore()
ProvideResultStore(resultStore) { ... }   // in the parent

// child: set a result
val store = LocalResultStore.current
scope.launch { store.setResult("open_drawer", true) }

// parent: observe it
ObserveAsEvents(store.observeResult<Boolean>("open_drawer")) { open ->
    if (open) drawerState.open()
}

Use a constant string key per result. Results are ephemeral (not saved across process death).

Reference

  • features/navigation/.../BaseNavigator.kt, StarterNavigator.kt, StarterNavigation.kt
  • composeApp/.../core/navigation/AppScreens.kt, AppNavigationModule.kt
  • Docs: https://starter.atherio.dev/fundamentals/08-navigation/

© DevAtrii, MIT. 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 .agents/skills/kmp-starter/navigation of DevAtrii/Kmp-Starter-Template.

Open the folder on GitHubat commit a8f7b27

Compare with similar skills

Kmp Starter Navigation 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.

Kmp Starter Navigation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Kmp Starter Navigation this skillDevAtrii/Kmp-Starter-Template167—~2.4kAutomated safety check: PassMIT
Compose FeatureMeet-Miyani/compose-skill301—~3.6kAutomated safety check: PassMIT
Core API Changelibnativeapi/nativeapi157—~2.5kAutomated safety check: PassMIT
Init Tauri Appglebis/claude-skills388—~1.5kAutomated safety check: PassMIT
Snapshot Test Setupgustavscirulis/snapgrid1171 repos~2.3kAutomated safety check: NotesCustom licence
Desktopgridaco/grida2.7k—~3.2kAutomated safety check: NotesApache-2.0

Similar skills

  • Compose Feature

    Meet-Miyani/compose-skill

    Adds, changes, or reviews a screen, sheet, dialog, or destination slice (endpoint to repository to ViewModel to UI to navigation to DI to tests) in a Compose or CMP project.

    301 GitHub stars~3.6k tokensUpdated yesterday
    MobileAuto-check passed
  • Core API Change

    libnativeapi/nativeapi

    Carry a change to the C++ public API in core/ all the way downstream — design check, header edit, six platform implementations, C ABI + Rust/Dart/C/JS/Python regeneration, per-binding verification…

    157 GitHub stars~2.5k tokensUpdated today
    MobileAuto-check passed
  • Init Tauri App

    glebis/claude-skills

    Scaffold a new Tauri v2 project with the cenno/cull house conventions — delegates boilerplate to npm create tauri-app, then layers an opinionated core plus opt-in modules (CLI+MCP, SQLite…

    388 GitHub stars~1.5k tokensUpdated 11 days ago
    MobileAuto-check passed
  • Snapshot Test Setup

    gustavscirulis/snapgrid

    Set up SwiftUI visual regression testing with swift-snapshot-testing.

    117 GitHub starsUsed in 1 repo~2.3k tokens
    MobileAuto-check: notes
  • Desktop

    gridaco/grida

    Grida Desktop Electron shell and release-impact work: BrowserWindow, preload, window.grida, menus, protocol/deep links, file associations, Forge, path-scoped bridge security, Electron-only UI bugs…

    2.7k GitHub stars~3.2k tokensUpdated yesterday
    Testing & QAAuto-check: notes
  • Rtdf

    any-tdf/any-tdf

    Build, review, and troubleshoot RTDF React applications using exact component APIs, themes, icons, localization, and scaffolding.

    779 GitHub stars~1.1k tokensUpdated 2 days ago
    Frontend & DesignAuto-check passed

More from DevAtrii/Kmp-Starter-Template

All 23 skills in this repo
  • Kmp Starter

    DevAtrii/Kmp-Starter-Template

    Build production Android & iOS apps on the KMP Starter Template (Clean Architecture, MVI, Koin, Compose Multiplatform).

    167 GitHub stars~3.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Kmp Starter Memory

    DevAtrii/Kmp-Starter-Template

    Persistent per-project memory for KMP Starter Template apps.

    167 GitHub stars~963 tokensUpdated 1 mo ago
    Auto-check passed
  • Kmp Starter Architecture

    DevAtrii/Kmp-Starter-Template

    Clean Architecture module and package layout for KMP Starter Template features — data/domain/presentation layers, core dependency rule, screen-based package organization, the Screen vs Content…

    167 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Kmp Starter Create Fresh App

    DevAtrii/Kmp-Starter-Template

    Research and plan a brand-new app before scaffolding it on the KMP Starter Template.

    167 GitHub stars~1.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Kmp Starter Data

    DevAtrii/Kmp-Starter-Template

    Data layer on the KMP Starter Template — repositories and data sources, Logics guidance, DataStore persistence, Room database, StarterFileManager, and the Calf file picker.

    167 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Kmp Starter Feature Analytics

    DevAtrii/Kmp-Starter-Template

    The KMP Starter Template analytics system — AppEvent/EventsTracker, Analytics routing, Mixpanel + Firebase providers, combining providers, and runtime swaps.

    167 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Kmp Starter Navigation

What does Kmp Starter Navigation do?

Navigation on the KMP Starter Template using navigation3 — AppScreens, polymorphic registration, AppNavigationModule routes, StarterNavigator, nested navigation (scoped navigators, Nav3Transitions…. Kmp Starter Navigation is an agent skill from DevAtrii/Kmp-Starter-Template. Navigation on the KMP Starter Template using navigation3 — AppScreens, polymorphic registration, AppNavigationModule routes, StarterNavigator, nested navigation (scoped navigators, Nav3Transitions, entry decorators), and ResultStore.

When should I use Kmp Starter Navigation?

Kmp Starter Navigation fits situations like: tasks that involve Project scaffolding.

How do I install Kmp Starter Navigation in Claude Code?

Run `npx skills add DevAtrii/Kmp-Starter-Template --skill kmp-starter-navigation -a claude-code`. Or copy the skill folder (.agents/skills/kmp-starter/navigation in DevAtrii/Kmp-Starter-Template) into .claude/skills/kmp-starter-navigation in your project. Claude Code loads it when a task matches its description.

How do I install Kmp Starter Navigation in Codex?

Run `npx skills add DevAtrii/Kmp-Starter-Template --skill kmp-starter-navigation -a codex`. Or copy the skill folder (.agents/skills/kmp-starter/navigation in DevAtrii/Kmp-Starter-Template) into .agents/skills/kmp-starter-navigation in your project. Codex loads it when a task matches its description.

Can I use Kmp Starter Navigation 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 DevAtrii/Kmp-Starter-Template --skill kmp-starter-navigation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/kmp-starter-navigation, .gemini/skills/kmp-starter-navigation, .github/skills/kmp-starter-navigation and .opencode/skills/kmp-starter-navigation in your project.

What does Kmp Starter Navigation need to run?

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

Does Kmp Starter Navigation access the network?

SKILL.md names 1 domain. In commands or code: starter.atherio.dev; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Kmp Starter Navigation 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 Kmp Starter Navigation use?

Kmp Starter Navigation is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Kmp Starter Navigation use?

About 2.4k tokens (SKILL.md is roughly 9.5k 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 Kmp Starter Navigation?

Skills that share tags, products or a category with Kmp Starter Navigation: Compose Feature (Meet-Miyani/compose-skill, 301 stars), Core API Change (libnativeapi/nativeapi, 157 stars), Init Tauri App (glebis/claude-skills, 388 stars) and Snapshot Test Setup (gustavscirulis/snapgrid, 117 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Kmp Starter Navigation?

DevAtrii (a GitHub user) maintains it in DevAtrii/Kmp-Starter-Template, which has 167 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on September 1, 2026.

Source: DevAtrii/Kmp-Starter-Template on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.