mobile-best-practices

name	mobile-best-practices
description	Mobile development intelligence for Android, iOS, Flutter, and React Native. 2,461 searchable entries: 49 architecture patterns, 112 design patterns, 191 UI patterns, 243 anti-patterns, 103 libraries, 228 performance rules, 437 security practices, 73 testing patterns, 56 reasoning rules, 18 project templates, 792 platform-specific guidelines, 81 copy-paste code snippets, and 78 Gradle dependency declarations. Use when building, reviewing, fixing, or optimizing mobile apps. Post-generation checks: performance, security, ANR/crash/splash.
license	MIT
compatibility	Requires Python 3.x for BM25 search. Works with Claude Code and other skills-compatible agents.
metadata	{"author":"tungnk123","version":"1.9.0","usage":"READER | AGENT | CLI","invocation":"explicit-only — database is never searched automatically","modes":{"reader":"Browse CSV/markdown files directly — no Python or IDE required","agent":"Explicit slash command /mobile-best-practices in Claude Code only","cli":"python3 scripts/search.py — direct terminal search, works outside Claude Code"}}

Mobile Best Practices

2,461 searchable best practices for Android, iOS, Flutter, and React Native. Android-first with Jetpack Compose.

How to Use

This skill does not trigger automatically. The database is only searched when you explicitly invoke it. Three ways to use it:

Mode	How	Requires
AGENT	/mobile-best-practices slash command in Claude Code	Claude Code + IDE restart
CLI	python3 scripts/search.py "<query>" -p android	Python 3
READER	Open CSV/markdown files directly	Nothing

AGENT — Slash command (primary mode)

/mobile-best-practices

Restart your IDE after installing. The slash command registry is only loaded at startup — the skill will not appear until you restart.

⚠️ Some IDEs do not support slash skills (e.g. certain VS Code forks, JetBrains AI Assistant, non-Claude agents). Use CLI mode in those cases.

CLI — Terminal search

python3 scripts/search.py "<query>" -p android -n 3

Works anywhere Python 3 is available. No IDE needed.

READER — Browse files directly

No tooling required. Open the source files:

File	Content
data/platforms/android.csv	423 Android/Compose guidelines
data/platforms/ios.csv	iOS/SwiftUI guidelines
data/code-snippets.csv	80 copy-paste code templates
data/security.csv	437 security practices
references/CODE-RULES.md	Code generation rules
references/CHECKLIST.md	Pre-delivery checklist

Installation

# via npm
npx mobile-best-practices install

# or manually symlink
ln -s /path/to/mobile-best-practices ~/.claude/skills/mobile-best-practices

After installing, restart your IDE to register the /mobile-best-practices slash command.

Prerequisites

Python 3.x required. Check: python3 --version

Search

python3 scripts/search.py "<query>" --domain <domain> [-n <max_results>]
python3 scripts/search.py "<query>" --platform <platform>
python3 scripts/search.py "<query>" --domain <domain> --filter-platform <platform>
python3 scripts/search.py "<query>" --domain <domain> --compact  # token-optimized output

Domains (12)

Domain	Use For
snippet	Copy-paste code templates
gradle	Gradle dependency declarations
designpattern	Design patterns & code smell detection
reasoning	Product type recommendations
architecture	Architecture patterns
library	Libraries and dependencies
ui	UI patterns and components
antipattern	Common mistakes
performance	Performance optimization
security	Security best practices
testing	Testing patterns
template	Project starters

Platforms

android (623) | android-xml (623) | ios (60) | flutter (54) | react-native (55)

Flags

--domain/-d domain | --platform/-p platform | --filter-platform/-fp filter | --stack/-s tech stack | --max-results/-n count (default: 15/30) | --all-domains/-a cross-domain search | --fuzzy/-f typo-tolerant | --compact/-c shorter output | --comment-style/-cs code comments | --json JSON output | --persist save blueprint | --page page blueprint

Workflow

When user requests mobile work, default to Android with Jetpack Compose unless specified otherwise.

Build: search snippet → gradle → platform → antipattern → designpattern → architecture

python3 scripts/search.py "viewmodel repository" --domain snippet -n 5
python3 scripts/search.py "hilt room retrofit" --domain gradle -n 5
python3 scripts/search.py "compose state" --platform android -n 5
python3 scripts/search.py "android compose" --domain antipattern -n 5
python3 scripts/search.py "repository factory" --domain designpattern -n 5
python3 scripts/search.py "mvvm clean" --domain architecture -n 5

Review: antipattern → designpattern → platform → performance → security

python3 scripts/search.py "android compose viewmodel" --domain antipattern -n 5
python3 scripts/search.py "code smell switch if-else" --domain designpattern -n 5
python3 scripts/search.py "state recomposition lifecycle" --platform android -n 5
python3 scripts/search.py "compose lazy startup" --domain performance -n 5
python3 scripts/search.py "storage encryption api key" --domain security -n 5

Code Quality

Before generating code, read code generation rules. Before delivering, verify against pre-delivery checklist.