Android navigation 3

Skill GDvega/super-android-kotlin-firebase-skill/skills/android-navigation-3

Use for Android Navigation 3 setup, migration from Navigation Compose, typed routes, deep links, back stack handling and navigation tests.From its SKILL.md

Install

npx -y skills add GDvega/super-android-kotlin-firebase-skill --skill android-navigation-3

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

2 things 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.
runs commandsInstructs the agent to run 3 commands, including `./gradlew assembleDebug` and 2 more.

SKILL.md

3.4 KB, 709 tokens by cl100k_base, as published. Nobody here has run it

Purpose

Implement or migrate modern Android navigation without breaking screens, route arguments, deep links or back stack behavior.

When to use

Adding Navigation 3 to an Android app.
Migrating from Navigation Compose or custom navigation.
Fixing typed routes, deep links, nested graphs or back stack issues.

Inputs to inspect

build.gradle.kts and libs.versions.toml
MainActivity.kt and app entry points
NavHost, routes and feature navigation files
AndroidManifest.xml deep links
screens/* and ViewModel event flow

Required workflow

Map current destinations, arguments and deep links.
Choose typed routes or preserve the existing route convention.
Move navigation decisions to route-level event handling.
Add or update navigation tests for critical flows.
Validate back behavior, process recreation and deep links.

Rules

Do not pass large objects as route arguments.
Do not put business logic inside route definitions.
Do not create duplicate NavHost owners.
Preserve existing deep links unless the user approves a migration.
Prefer typed route patterns when the project already uses them.

Related existing skills

Local skills to invoke

jetpack-compose
android-core
testing
edge-to-edge-adaptive-ui

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.
android/skills — use for official Android workflow alignment around edge-to-edge, adaptive UI, Navigation 3, R8, AGP or testing setup.

Files commonly touched

settings.gradle.kts
build.gradle.kts
gradle/libs.versions.toml
MainActivity.kt
feature/*/navigation/*
AndroidManifest.xml
androidTest/*Navigation*

Commands to validate

./gradlew assembleDebug
./gradlew test
./gradlew connectedDebugAndroidTest

Common mistakes to avoid

Navigating directly from deep reusable Composables.
Changing route strings without migration notes.
Forgetting saved state and process death.
Testing only happy-path forward navigation.

Checklist

Destinations and arguments documented.
Deep links preserved or explicitly migrated.
Back stack behavior tested.
Navigation events flow from UI state/events.
Validation commands provided.

Example prompts

Use $super-android-kotlin-firebase to migrate this app to Navigation 3.
Use $super-android-kotlin-firebase to add typed routes and deep links safely.

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/navigation-3-patterns.md
references/migration-from-navigation-compose.md
references/deep-links-and-back-stack.md
templates/typed-route-template.md
templates/navigation-host-template.md
templates/navigation-test-template.md