diff --git a/docs/README.skills.md b/docs/README.skills.md index 4af14033d..66e390a6f 100644 --- a/docs/README.skills.md +++ b/docs/README.skills.md @@ -157,6 +157,7 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-skills) for guidelines on how to | [microsoft-docs](../skills/microsoft-docs/SKILL.md) | Query official Microsoft documentation to find concepts, tutorials, and code examples across Azure, .NET, Agent Framework, Aspire, VS Code, GitHub, and more. Uses Microsoft Learn MCP as the default, with Context7 and Aspire MCP for content that lives outside learn.microsoft.com. | None | | [microsoft-skill-creator](../skills/microsoft-skill-creator/SKILL.md) | Create agent skills for Microsoft technologies using Learn MCP tools. Use when users want to create a skill that teaches agents about any Microsoft technology, library, framework, or service (Azure, .NET, M365, VS Code, Bicep, etc.). Investigates topics deeply, then generates a hybrid skill storing essential knowledge locally while enabling dynamic deeper investigation. | `references/skill-templates.md` | | [mkdocs-translations](../skills/mkdocs-translations/SKILL.md) | Generate a language translation for a mkdocs documentation stack. | None | +| [mobile-best-practices](../skills/mobile-best-practices/SKILL.md) | Searchable database of 2,461 mobile development best practices for Android, iOS, Flutter, and React Native. Use when building, reviewing, or optimizing mobile apps — covers architecture, security, performance, UI patterns, and anti-patterns. | None | | [model-recommendation](../skills/model-recommendation/SKILL.md) | Analyze chatmode or prompt files and recommend optimal AI models based on task complexity, required capabilities, and cost-efficiency | None | | [msstore-cli](../skills/msstore-cli/SKILL.md) | Microsoft Store Developer CLI (msstore) for publishing Windows applications to the Microsoft Store. Use when asked to configure Store credentials, list Store apps, check submission status, publish submissions, manage package flights, set up CI/CD for Store publishing, or integrate with Partner Center. Supports Windows App SDK/WinUI, UWP, .NET MAUI, Flutter, Electron, React Native, and PWA applications. | None | | [multi-stage-dockerfile](../skills/multi-stage-dockerfile/SKILL.md) | Create optimized multi-stage Dockerfiles for any language or framework | None | diff --git a/skills/mobile-best-practices/SKILL.md b/skills/mobile-best-practices/SKILL.md new file mode 100644 index 000000000..88dd109e2 --- /dev/null +++ b/skills/mobile-best-practices/SKILL.md @@ -0,0 +1,87 @@ +--- +name: mobile-best-practices +description: Searchable database of 2,461 mobile development best practices for Android, iOS, Flutter, and React Native. Use when building, reviewing, or optimizing mobile apps — covers architecture, security, performance, UI patterns, and anti-patterns. +--- + +# Mobile Best Practices + +A searchable database of 2,461 curated mobile development guidelines for Android, iOS, Flutter, and React Native. Uses BM25 ranking with fuzzy search across 16 CSV databases. + +## When to Use This Skill + +- Building or reviewing Android apps (Jetpack Compose or XML) +- Building or reviewing iOS apps (SwiftUI or UIKit) +- Flutter or React Native development +- Security audits mapped to OWASP Mobile Top 10 +- Performance optimization and ANR/crash prevention +- Architecture pattern selection (MVVM, MVI, Clean Architecture, etc.) +- Choosing libraries and Gradle dependencies +- Code review against known anti-patterns + +## Installation + +```bash +npx mobile-best-practices install +``` + +Or manually copy to `~/.claude/skills/mobile-best-practices/`. + +## Search + +```bash +python3 search.py "" --domain -n +``` + +### Domains + +| Domain | Description | +|--------|-------------| +| `architecture` | MVVM, MVI, Clean Architecture, Redux | +| `design-patterns` | Repository, Factory, Observer, Singleton | +| `ui` | Compose, SwiftUI, UIKit, Flutter widgets | +| `anti-patterns` | Common mistakes and how to fix them | +| `security` | OWASP Mobile Top 10, encryption, storage | +| `performance` | Recomposition, memory, rendering, battery | +| `testing` | Unit, UI, integration, snapshot tests | +| `libraries` | Recommended third-party libraries | +| `snippets` | Copy-paste code examples | +| `gradle` | Dependency declarations with versions | + +### Examples + +```bash +# Find Jetpack Compose performance tips +python3 search.py "jetpack compose recomposition" --domain performance + +# Find security issues with API keys +python3 search.py "API key storage" --domain security + +# Find Flutter state management patterns +python3 search.py "flutter state management" --domain architecture + +# Find React Native anti-patterns +python3 search.py "react native memory leak" --domain anti-patterns + +# Search across all domains +python3 search.py "biometric authentication" --all-domains +``` + +## Database Coverage + +| Category | Count | +|----------|-------| +| Platform-specific guidelines | 792 | +| Security practices (OWASP-mapped) | 437 | +| Performance rules | 228 | +| Anti-patterns | 243 | +| UI component patterns | 191 | +| Design patterns | 112 | +| Architecture patterns | 49 | +| Libraries & dependencies | 103 | +| Testing patterns | 73 | +| Copy-paste snippets | 81 | +| Gradle dependencies | 78 | + +## Source + +https://github.com/tungnk123/mobile-best-practices — MIT License