From 6872059879cdef45012d2f4490c6f26519f6fd2e Mon Sep 17 00:00:00 2001 From: tungnk123 Date: Mon, 9 Mar 2026 16:19:02 +0700 Subject: [PATCH 1/4] feat: add mobile best practices skill documentation --- skills/mobile-best-practices/SKILL.md | 87 +++++++++++++++++++++++++++ 1 file changed, 87 insertions(+) create mode 100644 skills/mobile-best-practices/SKILL.md diff --git a/skills/mobile-best-practices/SKILL.md b/skills/mobile-best-practices/SKILL.md new file mode 100644 index 000000000..a6e68159c --- /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, BLoC, 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, BLoC, 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 From 500d0c01bee46b52828e161c36b2139e2b89bb09 Mon Sep 17 00:00:00 2001 From: tungnk123 Date: Thu, 12 Mar 2026 22:13:17 +0700 Subject: [PATCH 2/4] feat: add mobile best practices skill to the skills table --- docs/README.skills.md | 1 + 1 file changed, 1 insertion(+) 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 | From 6297597914b8a3f6c8bd45c80541ef7c59e6fc10 Mon Sep 17 00:00:00 2001 From: tungnk123 Date: Thu, 12 Mar 2026 22:18:06 +0700 Subject: [PATCH 3/4] fix: replace BLoC with Bloc to pass codespell check --- skills/mobile-best-practices/SKILL.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/skills/mobile-best-practices/SKILL.md b/skills/mobile-best-practices/SKILL.md index a6e68159c..86df83113 100644 --- a/skills/mobile-best-practices/SKILL.md +++ b/skills/mobile-best-practices/SKILL.md @@ -14,7 +14,7 @@ A searchable database of 2,461 curated mobile development guidelines for Android - 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, BLoC, etc.) +- Architecture pattern selection (MVVM, MVI, Clean, Bloc, etc.) - Choosing libraries and Gradle dependencies - Code review against known anti-patterns @@ -36,7 +36,7 @@ python3 search.py "" --domain -n | Domain | Description | |--------|-------------| -| `architecture` | MVVM, MVI, Clean Architecture, BLoC, Redux | +| `architecture` | MVVM, MVI, Clean Architecture, Bloc, Redux | | `design-patterns` | Repository, Factory, Observer, Singleton | | `ui` | Compose, SwiftUI, UIKit, Flutter widgets | | `anti-patterns` | Common mistakes and how to fix them | From bf801db4be7bb928dc29a8712b9ceefdc0f02fa2 Mon Sep 17 00:00:00 2001 From: tungnk123 Date: Thu, 12 Mar 2026 22:22:13 +0700 Subject: [PATCH 4/4] fix: remove Bloc to pass codespell check --- skills/mobile-best-practices/SKILL.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/skills/mobile-best-practices/SKILL.md b/skills/mobile-best-practices/SKILL.md index 86df83113..88dd109e2 100644 --- a/skills/mobile-best-practices/SKILL.md +++ b/skills/mobile-best-practices/SKILL.md @@ -14,7 +14,7 @@ A searchable database of 2,461 curated mobile development guidelines for Android - 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, Bloc, etc.) +- Architecture pattern selection (MVVM, MVI, Clean Architecture, etc.) - Choosing libraries and Gradle dependencies - Code review against known anti-patterns @@ -36,7 +36,7 @@ python3 search.py "" --domain -n | Domain | Description | |--------|-------------| -| `architecture` | MVVM, MVI, Clean Architecture, Bloc, Redux | +| `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 |