Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Mavericks MVI Skills

An agent skill for working with Airbnb Mavericks 3.x MVI architecture on Android. Provides guidance on MavericksState, MavericksViewModel, Hilt registration, Compose / Fragment subscriptions, Async requests, and DeliveryMode one-shot events.

The skill follows the common SKILL.md (frontmatter + Markdown) format and works with any agent tool that supports it — Claude Code, Claude Agent SDK, GitHub Copilot CLI, Gemini CLI, and other compatible runtimes.

It uses progressive disclosure: a concise SKILL.md plus focused references/ files the agent reads only when a task needs them.

Articles

Language Article
Chinese Android Airbnb Mavericks 架构教程:基于协程的 MVI 实践
English Android Airbnb Mavericks Architecture Tutorial: Coroutine-Based MVI in Practice

Skill

Skill Path
mavericks-mvi skills/mavericks-mvi/SKILL.md

Reference files

Topic Path
State fields, immutability, args, @PersistState references/state.md
ViewModel template, execute, setOnEach, setState, withState references/viewmodel-execute.md
Hilt component and map binding references/hilt.md
Compose, Fragment, MavericksView, DeliveryMode, scopes references/observing-ui.md
Nullable effects, effect queues, consumption rules references/effects.md
Async<T> states and rendering patterns references/async.md
Mavericks ViewModel testing references/testing.md

Install

Copy the skill folder into your agent's skills directory. The exact location depends on your tool:

# Claude Code — project-scoped (recommended for teams)
mkdir -p .claude/skills && cp -r skills/mavericks-mvi .claude/skills/

# Claude Code — user-scoped (across all your projects)
cp -r skills/mavericks-mvi ~/.claude/skills/

# Other tools (Copilot CLI, Gemini CLI, custom agents built on the Claude Agent SDK, ...)
# Place the skill folder wherever your tool discovers skills.
# Refer to your tool's docs for the exact path.

Copy the whole mavericks-mvi folder so the references/ files travel with SKILL.md.

Usage

Once installed, the agent loads the skill automatically when you work on Mavericks code. You can also invoke it explicitly:

"Using the mavericks-mvi skill, add a new ViewModel for the profile screen."

Contributing

Issues and PRs welcome.

License

MIT

Releases

Packages

Contributors