igorescodro/navigation
.claude/skills/navigation/SKILL.md
Use when adding a new screen or modifying navigation in the Alkaa project — triggers on tasks like "add a new screen", "navigate to X", "add destination", "wire up navigation", or "create a navigation event". Also triggers when connecting UI actions to routes in NavGraph.
$ install --global
skillsauthnpx skillsauth add igorescodro/alkaa navigationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 5, 2026, 8:22 PM9.0s2 files scanned
SKILL.md
- name:
- navigation
- description:
- Use when adding a new screen or modifying navigation in the Alkaa project — triggers on tasks like "add a new screen", "navigate to X", "add destination", "wire up navigation", or "create a navigation event". Also triggers when connecting UI actions to routes in NavGraph.
Alkaa Navigation
Overview
Alkaa uses event-driven navigation: UI components send named action events, and the system resolves where to go. Navigation is never triggered directly from UI or ViewModels — it always flows through NavEventController.
Required Files per Navigation Change
| File | Package | Purpose |
|------|---------|---------|
| *Event.kt | com.escodro.navigationapi.event | Defines action events |
| *Destination.kt | com.escodro.navigationapi.destination | Defines typed routes |
| *NavGraph.kt | feature module | Registers entries and sends events |
Both *Event.kt and *Destination.kt live in features/navigation-api. → See references/CODE_PATTERNS.md for Kotlin examples of all three files.
Steps
- Create the Event — Name after the action, not the destination (
OnEditClick, notNavigateToEdit) → seereferences/CODE_PATTERNS.md - Create the Destination — Add
@Serializable; choose interface based on screen type → seereferences/CODE_PATTERNS.md - Add a NavGraph Entry —
entry<Destination>block with appropriate transition spec → seereferences/CODE_PATTERNS.md - Hoist Navigation — Composables receive lambdas; NavGraph calls
navEventController.sendEvent()→ seereferences/CODE_PATTERNS.md
Destination Interface Rules
| Interface | When to use |
|-----------|-------------|
| TopLevel | Bottom-nav root screens only (requires title, icon, @CommonParcelize) |
| TopAppBarVisible | Dialogs, bottom sheets, non-full-screen destinations |
| Neither | Regular full-screen push destinations |
Also register TopLevel and TopAppBarVisible destinations in the corresponding sets in Destination.kt.
Checklist
- [ ] Event named after an action (verb phrase:
On*Click,On*Save) - [ ] Destination annotated with
@Serializable - [ ]
TopLevelonly for bottom-nav root screens (with@CommonParcelize,title,icon) - [ ]
TopAppBarVisibleonly for dialogs/sheets/non-full-screen - [ ]
TopLevel/TopAppBarVisibledestinations registered inDestination.ktsets - [ ] NavGraph
entry<>block exists for each new destination - [ ] Navigation events sent from within NavGraph lambda, not from composables or ViewModels
- [ ] Back navigation uses
Event.OnBack, not custom events
Common Mistakes
| Mistake | Fix |
|---------|-----|
| navEventController.sendEvent() in a ViewModel | Must not leave the NavGraph — pass navigation as lambda callbacks instead |
| navEventController.sendEvent() inside a @Composable | Move to NavGraph entry<> block via lambda callback |
| Event named NavigateToDetail or GoToSettings | Name after the action: OnDetailClick, OnSettingsClick |
| Destination without @Serializable | Add annotation — Navigation3 requires it |
| Full-screen destination with TopAppBarVisible | Remove — use only for dialogs/sheets |
| New feature with no NavGraph implementation | Create *NavGraph.kt and bind in Koin module |
Related Skills
igorescodro/code-review
development
VerifiedTrustedCommunity
A skill for reviewing Android code before it is pushed to production.
1,622SKILL.mdUpdated Apr 5, 2026
igorescodro/write-viewmodel
documentation
VerifiedTrustedCommunity
Use when writing a new ViewModel or modifying an existing one in the Alkaa project. Triggers on tasks like "add a ViewModel", "create VM for X screen", "implement state handling", or "connect use case to UI".
1,622SKILL.mdUpdated Apr 5, 2026
igorescodro/write-unit-tests
testing
VerifiedTrustedCommunity
Use when writing or modifying unit tests in the Alkaa project — triggers on tasks like "add a test", "write tests for X", "test this ViewModel", "cover this use case with tests", or "add unit test coverage".
1,622SKILL.mdUpdated Apr 5, 2026
igorescodro/write-ui-tests
testing
VerifiedTrustedCommunity
Use when writing or modifying UI/Compose instrumented tests in the Alkaa project — triggers on tasks like "add a UI test", "test this composable", "add instrumented test", "test this screen behavior".
1,622SKILL.mdUpdated Apr 5, 2026