@buivietphi/skill-mobile-mt 2.1.0 → 2.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (13) hide show
  1. package/AGENTS.md +83 -45
  2. package/README.md +44 -35
  3. package/SKILL.md +333 -46
  4. package/package.json +1 -1
  5. package/shared/code-generation-templates.md +656 -0
  6. package/shared/code-review.md +8 -8
  7. package/shared/complex-ui-patterns.md +526 -0
  8. package/shared/data-flow-patterns.md +422 -0
  9. package/shared/error-handling.md +394 -0
  10. package/shared/intent-analysis.md +473 -0
  11. package/shared/navigation-patterns.md +375 -0
  12. package/shared/spec-to-code.md +293 -0
  13. package/shared/testing-patterns.md +428 -0
package/AGENTS.md CHANGED
@@ -27,48 +27,56 @@
27
27
 
28
28
  ```
29
29
  skill-mobile-mt/
30
- ├── SKILL.md ← Entry point. Always load first. (~13,700 tokens)
30
+ ├── SKILL.md ← Entry point. Always load first. (~25,150 tokens)
31
31
  ├── AGENTS.md ← This file. Multi-agent config.
32
32
  │
33
33
  ├── react-native/
34
- │ └── react-native.md ← RN + Expo patterns (~3,300 tokens)
34
+ │ └── react-native.md ← RN + Expo patterns (~5,840 tokens)
35
35
  │
36
36
  ├── flutter/
37
- │ └── flutter.md ← Flutter + Dart 3.x patterns (~1,200 tokens)
37
+ │ └── flutter.md ← Flutter + Dart 3.x patterns (~2,350 tokens)
38
38
  │
39
39
  ├── ios/
40
- │ └── ios-native.md ← Swift + UIKit/SwiftUI patterns (~880 tokens)
40
+ │ └── ios-native.md ← Swift + UIKit/SwiftUI patterns (~1,660 tokens)
41
41
  │
42
42
  ├── android/
43
- │ └── android-native.md ← Kotlin + Compose + Java legacy patterns (~2,100 tokens)
43
+ │ └── android-native.md ← Kotlin + Compose + Java legacy patterns (~4,370 tokens)
44
44
  │
45
45
  └── shared/
46
46
  │
47
47
  ├── ── CORE (always load) ──────────────────────────────────
48
- ├── code-review.md ← 12-category PR-level review + grounded review + 25 production crash patterns (all platforms) (~6,600 tokens)
49
- ├── bug-detection.md ← Intelligent bug scanner + git-aware Phase 0 + error classification + stack trace parser (~3,900 tokens)
50
- ├── prompt-engineering.md ← Auto-think + XML templates + advanced patterns (~4,900 tokens)
48
+ ├── code-review.md ← 12-category PR-level review + grounded review + 25 production crash patterns (all platforms) (~11,600 tokens)
49
+ ├── bug-detection.md ← Intelligent bug scanner + git-aware Phase 0 + error classification + stack trace parser (~7,290 tokens)
50
+ ├── prompt-engineering.md ← Auto-think + XML templates + advanced patterns (~7,440 tokens)
51
51
  │
52
52
  ├── ── ON-DEMAND (load by task) ────────────────────────────
53
- ├── error-recovery.md ← 16 build/runtime error fixes (~1,800 tokens)
54
- ├── document-analysis.md ← Parse images/PDFs/DOCX → code (~1,100 tokens)
55
- ├── anti-patterns.md ← PII, cardinality, payload detection (~1,800 tokens)
56
- ├── performance-prediction.md ← Frame budget, FPS prediction (~970 tokens)
57
- ├── platform-excellence.md ← iOS 18+ vs Android 15+ UX + HIG (~1,300 tokens)
58
- ├── version-management.md ← SDK compat matrix + release testing (~2,500 tokens)
59
- ├── observability.md ← Sessions as 4th pillar (~2,800 tokens)
60
- ├── architecture-intelligence.md ← Patterns from 30+ production repos (~2,600 tokens)
61
- ├── common-pitfalls.md ← Known issue patterns (~970 tokens)
62
- ├── release-checklist.md ← App Store/Play Store checklist (~600 tokens)
53
+ ├── error-recovery.md ← 16 build/runtime error fixes (~2,780 tokens)
54
+ ├── document-analysis.md ← Parse images/PDFs/DOCX → code (~1,520 tokens)
55
+ ├── anti-patterns.md ← PII, cardinality, payload detection (~2,910 tokens)
56
+ ├── performance-prediction.md ← Frame budget, FPS prediction (~1,310 tokens)
57
+ ├── platform-excellence.md ← iOS 18+ vs Android 15+ UX + HIG (~1,890 tokens)
58
+ ├── version-management.md ← SDK compat matrix + release testing (~3,660 tokens)
59
+ ├── observability.md ← Sessions as 4th pillar (~5,750 tokens)
60
+ ├── architecture-intelligence.md ← Patterns from 30+ production repos (~3,860 tokens)
61
+ ├── common-pitfalls.md ← Known issue patterns (~1,330 tokens)
62
+ ├── release-checklist.md ← App Store/Play Store checklist (~670 tokens)
63
63
  │
64
- ├── offline-first.md ← Local-first + sync patterns (~1,600 tokens)
65
- ├── testing-strategy.md ← Detox + Maestro + XCUITest + Espresso E2E (~1,300 tokens)
66
- ├── ci-cd.md ← GitHub Actions CI templates (~1,300 tokens)
67
- ├── ai-dlc-workflow.md ← AI-DLC structured workflow for complex features (~1,400 tokens)
68
- ├── ui-ux-mobile.md ← Design system, screen templates, touch, navigation, a11y (~3,900 tokens)
69
- ├── storage-patterns.md ← MMKV / SecureStore / SQLite / WatermelonDB / Keychain (~1,400 tokens)
70
- ├── i18n-localization.md ← i18next / slang / .xcstrings / strings.xml / RTL / date format (~1,600 tokens)
71
- ├── debugging-intelligence.md ← 45+ error patterns (RN+Flutter+iOS+Android) + git-aware debugging + search strategies (~5,900 tokens)
64
+ ├── offline-first.md ← Local-first + sync patterns (~2,930 tokens)
65
+ ├── testing-strategy.md ← Detox + Maestro + XCUITest + Espresso E2E (~2,500 tokens)
66
+ ├── ci-cd.md ← GitHub Actions CI templates (~2,830 tokens)
67
+ ├── ai-dlc-workflow.md ← AI-DLC structured workflow for complex features (~1,950 tokens)
68
+ ├── ui-ux-mobile.md ← Design system, screen templates, touch, navigation, a11y (~6,910 tokens)
69
+ ├── storage-patterns.md ← MMKV / SecureStore / SQLite / WatermelonDB / Keychain (~2,760 tokens)
70
+ ├── i18n-localization.md ← i18next / slang / .xcstrings / strings.xml / RTL / date format (~3,140 tokens)
71
+ ├── debugging-intelligence.md ← 45+ error patterns (RN+Flutter+iOS+Android) + git-aware debugging + search strategies (~8,730 tokens)
72
+ ├── intent-analysis.md ← Task extraction, scope clarification, intent understanding, spec analysis (~6,250 tokens)
73
+ ├── code-generation-templates.md ← Zustand/Redux/Riverpod, API client, forms, type generation (~5,370 tokens)
74
+ ├── spec-to-code.md ← Spec → dependency graph → file plan → implementation (~2,640 tokens)
75
+ ├── navigation-patterns.md ← Auth flow, deep links, modals, tabs, push, permissions (~2,900 tokens)
76
+ ├── complex-ui-patterns.md ← Carousel, gestures, keyboard, responsive, dark mode, a11y (~3,810 tokens)
77
+ ├── data-flow-patterns.md ← Pagination, optimistic updates, cache, WebSocket, offline queue (~3,250 tokens)
78
+ ├── error-handling.md ← Error hierarchy, retry, error boundary, user messages (~2,960 tokens)
79
+ ├── testing-patterns.md ← Component tests, hook tests, factories, snapshots (~3,410 tokens)
72
80
  │
73
81
  ├── ── TEMPLATES (copy to your project) ────────────────────
74
82
  ├── claude-md-template.md ← CLAUDE.md for Claude Code (copy to project root)
@@ -76,12 +84,13 @@ skill-mobile-mt/
76
84
  ```
77
85
 
78
86
  **Token totals:**
79
- - Smart load (1 platform + core shared): **~34,000 tokens** (26.6% of 128K)
80
- - Full load (all files): **~76,300 tokens** (59.6% of 128K)
81
- - debugging-intelligence.md, storage-patterns.md, i18n-localization.md: on-demand only — NOT loaded unless triggered
82
- - code-review.md now ~6,600 tokens — 12-category PR-level review + grounded review + 25 production crash patterns (all 4 platforms)
83
- - bug-detection.md now ~3,900 tokens — git-aware Phase 0, error classification, noise filter, stack trace parsing (all 4 platforms)
84
- - debugging-intelligence.md now ~5,900 tokens — 45+ error patterns across RN, Flutter, iOS Swift, Android Kotlin
87
+ - Smart load (SKILL.md + 1 platform + core shared): **~53,350 – 57,350 tokens** (42% – 45% of 128K)
88
+ - Full load (all files): **~166,380 tokens** (exceeds 128K — use smart load for 128K models)
89
+ - Full load fits within **200K context** (83% of 200K)
90
+ - On-demand files (NOT loaded unless triggered): debugging-intelligence, storage-patterns, i18n-localization, observability, architecture-intelligence, etc.
91
+ - code-review.md ~11,600 tokens — 12-category PR-level review + 25 production crash patterns (all 4 platforms)
92
+ - bug-detection.md ~7,290 tokens — git-aware Phase 0, error classification, stack trace parsing (all 4 platforms)
93
+ - debugging-intelligence.md ~8,730 tokens — 45+ error patterns across RN, Flutter, iOS Swift, Android Kotlin
85
94
 
86
95
  ---
87
96
 
@@ -93,13 +102,13 @@ skill-mobile-mt/
93
102
 
94
103
  **Loads automatically:**
95
104
  ```
96
- SKILL.md (~13,700 tokens)
97
- + 1 platform file (~880–3,300 tokens depending on platform)
98
- + shared/code-review.md (~6,600 tokens)
99
- + shared/bug-detection.md (~3,900 tokens)
100
- + shared/prompt-engineering.md (~4,900 tokens)
105
+ SKILL.md (~25,150 tokens)
106
+ + 1 platform file (~1,660–5,840 tokens depending on platform)
107
+ + shared/code-review.md (~11,600 tokens)
108
+ + shared/bug-detection.md (~7,290 tokens)
109
+ + shared/prompt-engineering.md (~7,440 tokens)
101
110
  ─────────────────────────────────────────────────
102
- ≈ 34,000 tokens total (estimated)
111
+ ≈ 53,350 – 57,350 tokens total (42%–45% of 128K)
103
112
  ```
104
113
 
105
114
  **Use case:** Regular coding, new features, code review. Covers 90% of daily work.
@@ -128,6 +137,18 @@ The agent reads the task, then decides which extra file to load:
128
137
  | "Storage / MMKV / SecureStore / save data" | `shared/storage-patterns.md` |
129
138
  | "i18n / multi-language / translation / RTL" | `shared/i18n-localization.md` |
130
139
  | "Review PR / review code / accessibility check" | `shared/code-review.md` (already loaded) + `shared/anti-patterns.md` |
140
+ | "Fix multiple / fix A then B / several places" | `shared/intent-analysis.md` (Task Extraction Protocol) |
141
+ | "Make it better / fix everything / vague request" | `shared/intent-analysis.md` (Scope Clarification Protocol) |
142
+ | "It's slow / doesn't work / non-technical description" | `shared/intent-analysis.md` (Intent Understanding Protocol) |
143
+ | "Build X like other apps / vague feature spec" | `shared/intent-analysis.md` (Spec Analysis Protocol) |
144
+ | "URGENT / production down / deadline / blocker" | `shared/intent-analysis.md` (Priority Detection) |
145
+ | "Build from spec / implement requirements" | `shared/spec-to-code.md` |
146
+ | "Setup state / Zustand / Redux / API client / forms" | `shared/code-generation-templates.md` |
147
+ | "Auth flow / deep links / modals / tabs / permissions" | `shared/navigation-patterns.md` |
148
+ | "Carousel / gestures / responsive / dark mode / a11y" | `shared/complex-ui-patterns.md` |
149
+ | "Pagination / optimistic / cache / WebSocket / offline" | `shared/data-flow-patterns.md` |
150
+ | "Error handling / retry / error boundary / toast" | `shared/error-handling.md` |
151
+ | "Component tests / unit tests / mock / factory" | `shared/testing-patterns.md` |
131
152
  | "Compare options / best approach / upgrade vs stay" | SKILL.md Decision Matrix Protocol (already loaded) |
132
153
 
133
154
  **Load cost:** +600 to +5,900 tokens per on-demand file.
@@ -138,7 +159,7 @@ The agent reads the task, then decides which extra file to load:
138
159
 
139
160
  **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.
140
161
 
141
- **Total:** ~76,300 tokens (59.6% of 128K, 38.2% of 200K)
162
+ **Total:** ~100,880 tokens (78.8% of 128K, 50.4% of 200K)
142
163
 
143
164
  **How it actually works:**
144
165
  - `@skill-mobile-mt` only injects SKILL.md into context
@@ -163,7 +184,7 @@ The agent reads the task, then decides which extra file to load:
163
184
  ```yaml
164
185
  skill:
165
186
  name: skill-mobile-mt
166
- version: "2.1.0"
187
+ version: "2.2.0"
167
188
  author: buivietphi
168
189
  category: engineering
169
190
  tags:
@@ -230,9 +251,10 @@ skill:
230
251
  java: ".java files in app/src/"
231
252
 
232
253
  context_budget:
233
- max_tokens: 76300
234
- smart_load_tokens: 34000
235
- savings: "~47%"
254
+ max_tokens: 166380
255
+ smart_load_tokens: 57350
256
+ fits_128k: "smart load only"
257
+ fits_200k: "full load (83%)"
236
258
  ```
237
259
 
238
260
  ---
@@ -281,6 +303,14 @@ Every agent MUST follow this loading sequence:
281
303
  - shared/storage-patterns.md (when choosing or implementing local storage)
282
304
  - shared/i18n-localization.md (when implementing multi-language or RTL)
283
305
  - shared/debugging-intelligence.md (when investigating complex bugs or long stack traces)
306
+ - shared/intent-analysis.md (when input is multi-part, vague, non-technical, or ambiguous)
307
+ - shared/code-generation-templates.md (when setting up state management, API client, or forms)
308
+ - shared/spec-to-code.md (when building new feature from spec or requirements)
309
+ - shared/navigation-patterns.md (when implementing auth flow, deep links, modals, tabs, permissions)
310
+ - shared/complex-ui-patterns.md (when building carousel, gestures, responsive layout, dark mode, a11y)
311
+ - shared/data-flow-patterns.md (when implementing pagination, optimistic updates, cache, WebSocket)
312
+ - shared/error-handling.md (when implementing error handling, retry, error boundary)
313
+ - shared/testing-patterns.md (when writing component tests, hook tests, or setting up test factories)
284
314
 
285
315
  7. SKIP non-matching platform subfolders (saves ~66% context)
286
316
  ```
@@ -308,6 +338,14 @@ Priority 6 (ON-DEMAND): shared/ai-dlc-workflow.md — AI-DLC structured workflow
308
338
  Priority 6 (ON-DEMAND): shared/ui-ux-mobile.md — Screen templates, design tokens, components, dark mode
309
339
  Priority 6 (ON-DEMAND): shared/storage-patterns.md — MMKV, SecureStore, SQLite, WatermelonDB, Keychain
310
340
  Priority 6 (ON-DEMAND): shared/i18n-localization.md — i18next, slang, .xcstrings, strings.xml, RTL
341
+ Priority 6 (ON-DEMAND): shared/intent-analysis.md — Task extraction, scope clarification, intent understanding, spec analysis
342
+ Priority 6 (ON-DEMAND): shared/code-generation-templates.md — Zustand/Redux/Riverpod, API client, forms, types
343
+ Priority 6 (ON-DEMAND): shared/spec-to-code.md — Spec → dependency graph → file plan → implementation
344
+ Priority 6 (ON-DEMAND): shared/navigation-patterns.md — Auth flow, deep links, modals, tabs, push, permissions
345
+ Priority 6 (ON-DEMAND): shared/complex-ui-patterns.md — Carousel, gestures, keyboard, responsive, dark mode, a11y
346
+ Priority 6 (ON-DEMAND): shared/data-flow-patterns.md — Pagination, optimistic updates, cache, WebSocket, offline queue
347
+ Priority 6 (ON-DEMAND): shared/error-handling.md — Error hierarchy, retry, error boundary, user messages
348
+ Priority 6 (ON-DEMAND): shared/testing-patterns.md — Component tests, hook tests, factories, snapshots
311
349
  Priority 6 (ON-DEMAND): shared/debugging-intelligence.md — 30+ error patterns, git-aware debugging
312
350
  ```
313
351
 
@@ -487,10 +525,10 @@ npx @buivietphi/skill-mobile-mt --init all # → all files
487
525
  {
488
526
  "id": "skill-mobile-mt",
489
527
  "name": "skill-mobile-mt",
490
- "version": "2.1.0",
528
+ "version": "2.2.0",
491
529
  "author": "buivietphi",
492
530
  "category": "engineering",
493
- "description": "Master Senior Mobile Engineer. Patterns from 30+ production repos (200k+ GitHub stars) + research from top 53k+ star skill repos. Cardinal rules, self-critique loops, leverage pyramid, verification-first, decision matrix, codebase scan strategy, grounded code review (anti-false-positive), git-aware debugging. React Native, Flutter, iOS, Android.",
531
+ "description": "Master Senior Mobile Engineer. Patterns from 30+ production repos (200k+ GitHub stars) + research from top 53k+ star skill repos. Cardinal rules, self-critique loops, leverage pyramid, verification-first, decision matrix, codebase scan strategy, grounded code review (anti-false-positive), git-aware debugging, task extraction protocol, multi-fix execution, UI fix protocol, completion re-check. React Native, Flutter, iOS, Android.",
494
532
  "risk": "low",
495
533
  "source": "buivietphi (MIT)",
496
534
  "platforms": ["react-native", "flutter", "ios", "android"],
package/README.md CHANGED
@@ -305,46 +305,55 @@ iOS only?
305
305
 
306
306
  | Scenario | Tokens | % of 128K | % of 200K |
307
307
  |----------|-------:|----------:|----------:|
308
- | SKILL.md only | ~13,400 | 10.5% | 6.7% |
309
- | + 1 platform + core shared/ | ~34,000 | 26.6% | 17.0% |
310
- | Cross-platform (RN/Flutter + iOS + Android) | ~70,000 | 54.7% | 35.0% |
311
- | All files loaded | ~76,300 | 59.6% | 38.2% |
312
- | **Smart load (recommended)** | **~34,000** | **26.6%** | **17.0%** |
308
+ | SKILL.md only | ~25,150 | 19.6% | 12.6% |
309
+ | **Smart load (recommended)** | **~53,350 – 57,350** | **42% – 45%** | **27% – 29%** |
310
+ | Cross-platform (RN+Flutter+iOS+Android) | ~95,350 | 74.5% | 47.7% |
311
+ | All files loaded | ~166,380 | 130.0% | 83.2% |
312
+ | | | *exceeds 128K* | *fits 200K* |
313
313
 
314
314
  ### Per-file token breakdown
315
315
 
316
316
  | File | Tokens |
317
317
  |------|-------:|
318
- | `SKILL.md` | ~13,400 |
319
- | `AGENTS.md` | ~3,300 |
320
- | `react-native/react-native.md` | ~3,200 |
321
- | `flutter/flutter.md` | ~1,200 |
322
- | `ios/ios-native.md` | ~860 |
323
- | `android/android-native.md` | ~2,000 |
324
- | `shared/code-review.md` | ~6,600 |
325
- | `shared/bug-detection.md` | ~3,900 |
326
- | `shared/debugging-intelligence.md` | ~5,900 |
327
- | `shared/prompt-engineering.md` | ~4,700 |
328
- | `shared/architecture-intelligence.md` | ~2,500 |
329
- | `shared/common-pitfalls.md` | ~950 |
330
- | `shared/error-recovery.md` | ~1,700 |
331
- | `shared/document-analysis.md` | ~1,000 |
332
- | `shared/release-checklist.md` | ~590 |
333
- | `shared/anti-patterns.md` | ~1,750 |
334
- | `shared/performance-prediction.md` | ~950 |
335
- | `shared/platform-excellence.md` | ~1,250 |
336
- | `shared/version-management.md` | ~2,400 |
337
- | `shared/observability.md` | ~2,700 |
338
- | `shared/offline-first.md` | ~1,560 |
339
- | `shared/testing-strategy.md` | ~1,300 |
340
- | `shared/ci-cd.md` | ~1,290 |
341
- | `shared/ai-dlc-workflow.md` | ~1,380 |
342
- | `shared/ui-ux-mobile.md` | ~3,850 |
343
- | `shared/storage-patterns.md` | ~1,370 |
344
- | `shared/i18n-localization.md` | ~1,570 |
345
- | `shared/claude-md-template.md` | ~760 |
346
- | `shared/agent-rules-template.md` | ~2,140 |
347
- | **Total** | **~76,300** |
318
+ | `SKILL.md` | ~25,150 |
319
+ | `AGENTS.md` | ~6,440 |
320
+ | `react-native/react-native.md` | ~5,840 |
321
+ | `flutter/flutter.md` | ~2,350 |
322
+ | `ios/ios-native.md` | ~1,660 |
323
+ | `android/android-native.md` | ~4,370 |
324
+ | `shared/code-review.md` | ~11,600 |
325
+ | `shared/bug-detection.md` | ~7,290 |
326
+ | `shared/debugging-intelligence.md` | ~8,730 |
327
+ | `shared/prompt-engineering.md` | ~7,440 |
328
+ | `shared/architecture-intelligence.md` | ~3,860 |
329
+ | `shared/common-pitfalls.md` | ~1,330 |
330
+ | `shared/error-recovery.md` | ~2,780 |
331
+ | `shared/document-analysis.md` | ~1,520 |
332
+ | `shared/release-checklist.md` | ~670 |
333
+ | `shared/anti-patterns.md` | ~2,910 |
334
+ | `shared/performance-prediction.md` | ~1,310 |
335
+ | `shared/platform-excellence.md` | ~1,890 |
336
+ | `shared/version-management.md` | ~3,660 |
337
+ | `shared/observability.md` | ~5,750 |
338
+ | `shared/offline-first.md` | ~2,930 |
339
+ | `shared/testing-strategy.md` | ~2,500 |
340
+ | `shared/ci-cd.md` | ~2,830 |
341
+ | `shared/ai-dlc-workflow.md` | ~1,950 |
342
+ | `shared/ui-ux-mobile.md` | ~6,910 |
343
+ | `shared/storage-patterns.md` | ~2,760 |
344
+ | `shared/i18n-localization.md` | ~3,140 |
345
+ | `shared/intent-analysis.md` | ~6,250 |
346
+ | `shared/code-generation-templates.md` | ~5,370 |
347
+ | `shared/spec-to-code.md` | ~2,640 |
348
+ | `shared/navigation-patterns.md` | ~2,900 |
349
+ | `shared/complex-ui-patterns.md` | ~3,810 |
350
+ | `shared/data-flow-patterns.md` | ~3,250 |
351
+ | `shared/error-handling.md` | ~2,960 |
352
+ | `shared/testing-patterns.md` | ~3,410 |
353
+ | `shared/claude-md-template.md` | ~1,050 |
354
+ | `shared/agent-rules-template.md` | ~2,870 |
355
+ | `humanizer/humanizer-mobile.md` | ~2,630 |
356
+ | **Total** | **~166,380** |
348
357
 
349
358
  ## Installed Structure
350
359