@buivietphi/skill-mobile-mt 1.4.2 → 1.4.3

package/AGENTS.md

@@ -40,7 +40,7 @@ skill-mobile-mt/
 │   └── ios-native.md               ← Swift + UIKit/SwiftUI patterns (1,452 tokens)
 │
 ├── android/
-│   └── android-native.md           ← Kotlin + Compose patterns (2,100 tokens)
+│   └── android-native.md           ← Kotlin + Compose + Java legacy patterns (4,400 tokens)
 │
 └── shared/
     │
@@ -71,8 +71,8 @@ skill-mobile-mt/
 ```
 
 **Token totals:**
-- Smart load (1 platform + core shared): **~38,600 tokens** (30.2% of 128K)
-- Full load (all files): **~74,700 tokens** (58.4% of 128K)
+- Smart load (1 platform + core shared): **~40,900 tokens** (31.9% of 128K)
+- Full load (all files): **~77,000 tokens** (60.2% of 128K)
 
 ---
 
@@ -122,7 +122,7 @@ The agent reads the task, then decides which extra file to load:
 
 **No automatic trigger.** Full load happens when the AI reads every file without being selective — either because it's over-eager, or because the user explicitly asks for it.
 
-**Total:** ~70,000 tokens (54.7% of 128K, 35% of 200K)
+**Total:** ~72,300 tokens (56.5% of 128K, 36% of 200K)
 
 **How it actually works:**
 - `@skill-mobile-mt` only injects SKILL.md into context
@@ -214,9 +214,9 @@ skill:
     java: ".java files in app/src/"
 
   context_budget:
-    max_tokens: 74700
-    smart_load_tokens: 38600
-    savings: "~48%"
+    max_tokens: 77000
+    smart_load_tokens: 40900
+    savings: "~47%"
 ```
 
 ---
@@ -463,10 +463,10 @@ npx @buivietphi/skill-mobile-mt --init all        # → all files
 {
   "id": "skill-mobile-mt",
   "name": "skill-mobile-mt",
-  "version": "1.4.0",
+  "version": "1.4.3",
   "author": "buivietphi",
   "category": "engineering",
-  "description": "Master Senior Mobile Engineer. Pre-built patterns from 18 production apps + project adaptation. Auto-detects language and framework. React Native, Flutter, iOS, Android.",
+  "description": "Master Senior Mobile Engineer. Pre-built patterns from 30+ production repos + project adaptation. Auto-detects language and framework. React Native, Flutter, iOS, Android.",
   "risk": "low",
   "source": "buivietphi (MIT)",
   "platforms": ["react-native", "flutter", "ios", "android"],

package/README.md

@@ -72,6 +72,73 @@ Reads your current project first, then follows **your** conventions:
 - Clones the most similar existing feature when scaffolding new ones
 - Never suggests migrations or imposes different architecture
 
+## Humanizer — Mobile Copy
+
+Installed automatically alongside the main skill. Removes AI writing patterns from mobile app text.
+
+```
+@humanizer-mobile
+```
+
+Use for: app store descriptions, release notes, error messages, onboarding, push notifications, permission prompts, paywall copy.
+
+**App Store Description**
+```
+❌ "TaskFlow is a powerful, comprehensive task management application that
+seamlessly integrates with your existing workflow."
+
+✅ "TaskFlow keeps your team's work in one place. Add tasks, assign them,
+set deadlines — everything syncs in real time. Works with Slack and Notion."
+```
+
+**Release Notes**
+```
+❌ "Version 2.1.0 introduces significant enhancements to the overall user
+experience including robust improvements to performance and reliability."
+
+✅ "2.1.0
+- Faster load times on older Android devices (was 4s, now 1.2s)
+- Fixed crash when opening notifications while offline
+- Dark mode now remembers your setting between sessions"
+```
+
+**Error Messages**
+```
+❌ "We apologize for the inconvenience. An unexpected error has occurred."
+
+✅ "Couldn't save — no internet connection.
+   [Try again] [Save for later]"
+```
+
+**Push Notifications**
+```
+❌ "You have received a new message from a team member."
+✅ "Alex commented on "Landing page redesign""
+```
+
+**Paywall**
+```
+❌ "Unlock the full potential of our comprehensive premium features."
+
+✅ "Go Pro
+   • Unlimited projects (free plan: 3)
+   • Team sharing
+   [Start 7-day free trial]"
+```
+
+Covers 24 AI patterns across: content inflation, chatbot artifacts, style issues, mobile-specific copy (App Store limits, permission prompts, rating requests, subscription CTAs).
+
+### Works with all agents
+
+| Agent | Invocation |
+|-------|-----------|
+| Claude Code | `@humanizer-mobile` |
+| Gemini CLI | `@humanizer-mobile` |
+| Codex / Kimi / Antigravity | `@humanizer-mobile` |
+| Cline / Roo Code / Cursor / Windsurf / Copilot | Paste the text and say "humanize this app copy" |
+
+---
+
 ## Quick Start Examples
 
 ### Step 1: Install the skill
@@ -101,6 +168,15 @@ You'll see an interactive checkbox — use arrow keys to navigate, space to sele
     ◯ Antigravity    [not found]
 ```
 
+Install output:
+
+```
+  ✓ skill-mobile-mt/    → Claude Code  (~/.claude/skills/skill-mobile-mt)
+  ✓ humanizer-mobile/   → Claude Code  (~/.claude/skills/humanizer-mobile)
+```
+
+Both are installed automatically. Use `@humanizer-mobile` for app store copy, release notes, and UX text.
+
 ### Step 2: Generate project rules
 
 ```bash
@@ -231,9 +307,9 @@ iOS only?
 |----------|-------:|----------:|----------:|
 | SKILL.md only | ~13,200 | 10.3% | 6.6% |
 | + 1 platform + core shared/ | ~38,600 | 30.2% | 19.3% |
-| Cross-platform (RN/Flutter + iOS + Android) | ~53,000 | 41.4% | 26.5% |
-| All files loaded | ~74,700 | 58.4% | 37.4% |
-| **Smart load (recommended)** | **~38,600** | **30.2%** | **19.3%** |
+| Cross-platform (RN/Flutter + iOS + Android) | ~55,300 | 43.2% | 27.7% |
+| All files loaded | ~77,000 | 60.2% | 38.5% |
+| **Smart load (recommended)** | **~40,900** | **31.9%** | **20.5%** |
 
 ### Per-file token breakdown
 
@@ -244,7 +320,7 @@ iOS only?
 | `react-native/react-native.md` | 5,108 |
 | `flutter/flutter.md` | 2,100 |
 | `ios/ios-native.md` | 1,452 |
-| `android/android-native.md` | 2,100 |
+| `android/android-native.md` | 4,400 |
 | `shared/code-review.md` | 865 |
 | `shared/bug-detection.md` | 499 |
 | `shared/prompt-engineering.md` | 3,927 |
@@ -263,7 +339,7 @@ iOS only?
 | `shared/ci-cd.md` | 2,500 |
 | `shared/claude-md-template.md` | ~500 |
 | `shared/agent-rules-template.md` | ~2,500 |
-| **Total** | **~53,500** |
+| **Total** | **~55,800** |
 
 ## Installed Structure
 
@@ -279,7 +355,7 @@ iOS only?
     ├── ios/
     │   └── ios-native.md              iOS Swift patterns
     ├── android/
-    │   └── android-native.md          Android Kotlin patterns
+    │   └── android-native.md          Android Kotlin + Java patterns
     └── shared/
         ├── code-review.md             Senior review checklist
         ├── bug-detection.md           Auto bug scanner
@@ -427,66 +503,6 @@ your-project/
 | **Kiro** | Reads `.kiro/steering/` from project root | `npx skill-mobile-mt --init kiro` |
 | **Antigravity** | Reads from `~/.agents/skills/` | `npx skill-mobile-mt --antigravity` |
 
-## Humanizer — Mobile Copy
-
-Installed automatically alongside the main skill. Removes AI writing patterns from mobile app text.
-
-```
-@humanizer-mobile
-```
-
-Use for: app store descriptions, release notes, error messages, onboarding, push notifications, permission prompts, paywall copy.
-
-### Examples
-
-**App Store Description**
-```
-❌ "TaskFlow is a powerful, comprehensive task management application that
-seamlessly integrates with your existing workflow."
-
-✅ "TaskFlow keeps your team's work in one place. Add tasks, assign them,
-set deadlines — everything syncs in real time. Works with Slack and Notion."
-```
-
-**Release Notes**
-```
-❌ "Version 2.1.0 introduces significant enhancements to the overall user
-experience including robust improvements to performance and reliability."
-
-✅ "2.1.0
-- Faster load times on older Android devices (was 4s, now 1.2s)
-- Fixed crash when opening notifications while offline
-- Dark mode now remembers your setting between sessions"
-```
-
-**Error Messages**
-```
-❌ "We apologize for the inconvenience. An unexpected error has occurred."
-
-✅ "Couldn't save — no internet connection.
-   [Try again] [Save for later]"
-```
-
-**Push Notifications**
-```
-❌ "You have received a new message from a team member."
-✅ "Alex commented on "Landing page redesign""
-```
-
-**Paywall**
-```
-❌ "Unlock the full potential of our comprehensive premium features."
-
-✅ "Go Pro
-   • Unlimited projects (free plan: 3)
-   • Team sharing
-   [Start 7-day free trial]"
-```
-
-Covers 24 AI patterns across: content inflation, chatbot artifacts, style issues, mobile-specific copy (App Store limits, permission prompts, rating requests, subscription CTAs).
-
----
-
 ## License
 
 MIT — by [buivietphi](https://github.com/buivietphi)

package/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: skill-mobile-mt
 description: "Master Senior Mobile Engineer. Patterns from 30+ production repos (200k+ GitHub stars: Ignite, Expensify, Mattermost, Immich, AppFlowy, Now in Android, TCA). Use when: building mobile features, fixing mobile bugs, reviewing mobile code, mobile architecture, React Native, Flutter, iOS Swift, Android Kotlin, mobile performance, mobile security audit, mobile code review, app release. Two modes: (1) default = pre-built production patterns, (2) 'project' = reads current project and adapts."
-version: "1.4.2"
+version: "1.4.3"
 author: buivietphi
 priority: high
 user-invocable: true

package/android/android-native.md

@@ -254,5 +254,227 @@ dependencies {
 
 ---
 
+## Java Interop (Legacy Projects)
+
+> For projects still using Java. New code should use Kotlin.
+
+### Activity + XML Layout (Java)
+
+```java
+// MainActivity.java
+@AndroidEntryPoint
+public class MainActivity extends AppCompatActivity {
+
+    private MainViewModel viewModel;
+    private ActivityMainBinding binding;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        binding = ActivityMainBinding.inflate(getLayoutInflater());
+        setContentView(binding.getRoot());
+
+        viewModel = new ViewModelProvider(this).get(MainViewModel.class);
+
+        // Observe LiveData (Java equivalent of collectAsStateWithLifecycle)
+        viewModel.getUiState().observe(this, state -> {
+            if (state instanceof UiState.Loading) {
+                binding.progressBar.setVisibility(View.VISIBLE);
+                binding.recyclerView.setVisibility(View.GONE);
+            } else if (state instanceof UiState.Error) {
+                binding.progressBar.setVisibility(View.GONE);
+                Toast.makeText(this, ((UiState.Error) state).getMessage(), Toast.LENGTH_SHORT).show();
+            } else if (state instanceof UiState.Success) {
+                binding.progressBar.setVisibility(View.GONE);
+                binding.recyclerView.setVisibility(View.VISIBLE);
+                adapter.submitList(((UiState.Success<List<Product>>) state).getData());
+            }
+        });
+
+        binding.retryButton.setOnClickListener(v -> viewModel.load());
+    }
+}
+```
+
+### ViewModel + LiveData (Java)
+
+```java
+// ProductListViewModel.java
+@HiltViewModel
+public class ProductListViewModel extends ViewModel {
+
+    private final MutableLiveData<UiState<List<Product>>> _uiState =
+        new MutableLiveData<>(new UiState.Loading<>());
+    private final LiveData<UiState<List<Product>>> uiState = _uiState;
+
+    private final GetProductsUseCase getProducts;
+
+    @Inject
+    public ProductListViewModel(GetProductsUseCase getProducts) {
+        this.getProducts = getProducts;
+        load();
+    }
+
+    public LiveData<UiState<List<Product>>> getUiState() { return uiState; }
+
+    public void load() {
+        _uiState.setValue(new UiState.Loading<>());
+        // Use RxJava or ExecutorService for async in Java
+        ExecutorService executor = Executors.newSingleThreadExecutor();
+        executor.execute(() -> {
+            try {
+                List<Product> items = getProducts.executeSync(); // blocking call
+                new Handler(Looper.getMainLooper()).post(() -> {
+                    if (items.isEmpty()) _uiState.setValue(new UiState.Empty<>());
+                    else _uiState.setValue(new UiState.Success<>(items));
+                });
+            } catch (Exception e) {
+                new Handler(Looper.getMainLooper()).post(() ->
+                    _uiState.setValue(new UiState.Error<>(e.getMessage()))
+                );
+            } finally {
+                executor.shutdown();
+            }
+        });
+    }
+}
+```
+
+### Retrofit + Callback (Java)
+
+```java
+// ProductApi.java
+public interface ProductApi {
+    @GET("products")
+    Call<ApiResponse<List<ProductDto>>> getProducts();
+}
+
+// ProductRepositoryImpl.java
+public class ProductRepositoryImpl implements ProductRepository {
+    private final ProductApi api;
+    private final ProductDao dao;
+
+    @Inject
+    public ProductRepositoryImpl(ProductApi api, ProductDao dao) {
+        this.api = api;
+        this.dao = dao;
+    }
+
+    @Override
+    public void getProducts(Callback<List<Product>> callback) {
+        api.getProducts().enqueue(new retrofit2.Callback<ApiResponse<List<ProductDto>>>() {
+            @Override
+            public void onResponse(Call<ApiResponse<List<ProductDto>>> call,
+                                   Response<ApiResponse<List<ProductDto>>> response) {
+                if (response.isSuccessful() && response.body() != null) {
+                    List<Product> items = mapToDomain(response.body().getData());
+                    callback.onSuccess(items);
+                } else {
+                    callback.onError("Server error: " + response.code());
+                }
+            }
+
+            @Override
+            public void onFailure(Call<ApiResponse<List<ProductDto>>> call, Throwable t) {
+                callback.onError(t.getMessage());
+            }
+        });
+    }
+}
+```
+
+### Room DAO (Java)
+
+```java
+// ProductDao.java
+@Dao
+public interface ProductDao {
+    @Query("SELECT * FROM products")
+    LiveData<List<ProductEntity>> getAll();   // LiveData for Java observers
+
+    @Insert(onConflict = OnConflictStrategy.REPLACE)
+    void insertAll(List<ProductEntity> items);
+
+    @Query("DELETE FROM products")
+    void deleteAll();
+}
+```
+
+### Java-Kotlin Interop Annotations
+
+```kotlin
+// When writing Kotlin code that will be called from Java:
+
+// @JvmStatic — allows calling companion object functions as static
+class ProductMapper {
+    companion object {
+        @JvmStatic
+        fun toDomain(dto: ProductDto): Product = Product(dto.id, dto.name)
+    }
+}
+// Java: ProductMapper.toDomain(dto)  ✅ (without @JvmStatic: ProductMapper.Companion.toDomain(dto))
+
+// @JvmField — exposes Kotlin property as Java field (no getter/setter)
+class Config {
+    companion object {
+        @JvmField val BASE_URL = "https://api.example.com"
+    }
+}
+// Java: Config.BASE_URL  ✅
+
+// @JvmOverloads — generates overloaded methods for default parameters
+class ProductService @JvmOverloads constructor(
+    val baseUrl: String,
+    val timeout: Int = 30,
+    val retries: Int = 3,
+)
+// Java: new ProductService("url")  ✅  (without: must pass all 3 params)
+
+// @Throws — declares checked exceptions for Java callers
+@Throws(IOException::class)
+fun readFile(path: String): String { /* ... */ }
+```
+
+### Calling Kotlin Suspend from Java (Bridge Pattern)
+
+```java
+// Use CoroutineScope from Java via CoroutinesInstrumentationHelper or wrapper
+// ⚠️ Recommended: write a non-suspend wrapper in Kotlin
+
+// Kotlin wrapper (bridge.kt)
+object ProductBridge {
+    @JvmStatic
+    fun getProducts(scope: CoroutineScope, callback: ProductCallback) {
+        scope.launch {
+            try {
+                val items = getProductsUseCase()
+                callback.onSuccess(items)
+            } catch (e: Exception) {
+                callback.onError(e.message ?: "Error")
+            }
+        }
+    }
+}
+
+// Java side
+ProductBridge.getProducts(lifecycleScope, new ProductCallback() {
+    @Override public void onSuccess(List<Product> items) { /* update UI */ }
+    @Override public void onError(String message) { /* show error */ }
+});
+```
+
+### Java Common Pitfalls
+
+| Pitfall | Fix |
+|---------|-----|
+| NullPointerException | `@NonNull` / `@Nullable` + null checks |
+| Memory leak (Activity in async) | `WeakReference<Activity>` or cancel on `onDestroy` |
+| Main thread network call | `Executors.newSingleThreadExecutor()` |
+| No `Call.cancel()` | Store reference, cancel in `onDestroy` |
+| Anonymous inner class holding outer ref | Use static inner class |
+
+---
+
 > Multi-module Gradle + Hilt + Compose + offline-first.
 > Clean Architecture with domain module having zero dependencies.
+> Java legacy: use LiveData + Retrofit callbacks. Bridge Kotlin suspend with wrapper functions.

package/bin/install.mjs

@@ -70,7 +70,7 @@ const fail = m => log(`  ${c.red}✗${c.reset} ${m}`);
 
 function banner() {
   log(`\n${c.bold}${c.cyan}  ┌──────────────────────────────────────────────────┐`);
-  log(`  │  📱 @buivietphi/skill-mobile-mt v1.4.2           │`);
+  log(`  │  📱 @buivietphi/skill-mobile-mt v1.4.3           │`);
   log(`  │  Master Senior Mobile Engineer                    │`);
   log(`  │                                                  │`);
   log(`  │  Claude · Cline · Roo Code · Cursor · Windsurf  │`);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@buivietphi/skill-mobile-mt",
-  "version": "1.4.2",
-  "description": "Master Senior Mobile Engineer skill for AI agents. Pre-built patterns from 18 production apps + local project adaptation. React Native, Flutter, iOS, Android. Supports Claude, Gemini, Kimi, Cursor, Copilot, Antigravity.",
+  "version": "1.4.3",
+  "description": "Master Senior Mobile Engineer skill for AI agents. Pre-built patterns from 30+ production repos. React Native, Flutter, iOS, Android. Supports Claude, Cline, Cursor, Windsurf, Copilot, Codex, Gemini, Kimi, Kilo Code, Kiro, Antigravity.",
   "author": "buivietphi",
   "license": "MIT",
   "keywords": [