{"_id":"@buivietphi/skill-mobile-mt","_rev":"29-566e341462ba4ae17912c2a91b13f84f","name":"@buivietphi/skill-mobile-mt","dist-tags":{"latest":"2.2.1"},"versions":{"2.0.0":{"name":"@buivietphi/skill-mobile-mt","version":"2.0.0","keywords":["claude-code","gemini","kimi","antigravity","cursor","agent-skills","mobile","react-native","flutter","ios","android","clean-architecture","code-review","prompt-engineering"],"author":{"name":"buivietphi"},"license":"MIT","_id":"@buivietphi/skill-mobile-mt@2.0.0","maintainers":[{"name":"buivietphi","email":"buivietphii@gmail.com"}],"homepage":"https://github.com/buivietphi/skill-mobile-mt#readme","bugs":{"url":"https://github.com/buivietphi/skill-mobile-mt/issues"},"bin":{"skill-mobile":"bin/install.mjs"},"dist":{"shasum":"ea6e9d3261276d70771c0001a4ebf65a655bebfb","tarball":"https://registry.npmjs.org/@buivietphi/skill-mobile-mt/-/skill-mobile-mt-2.0.0.tgz","fileCount":30,"integrity":"sha512-95xpU6nciILR9J4Rxm77YZTSk+iLe6p2yD8hf8XX8BsUIt0kPE7NHq6CDVFD+fSn6waaMVEFCpZ2iazozxQOQQ==","signatures":[{"sig":"MEUCIQDILmxNPVv4ofnLOrtNU0WIATiNMSmTla0LByI4iO4XXQIgPVX191yjKsn6KGVXvzaTrHBdgl52i+z0YaB8YIDASc4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":373936},"engines":{"node":">=18"},"gitHead":"d5c9b6b290740bf5a62b0845b6272af46f6807d7","scripts":{"init":"node bin/install.mjs --init","init:all":"node bin/install.mjs --init all","init:cursor":"node bin/install.mjs --init cursor","install:all":"node bin/install.mjs --all","postinstall":"node bin/install.mjs --auto","init:copilot":"node bin/install.mjs --init copilot","install:kimi":"node bin/install.mjs --kimi","init:windsurf":"node bin/install.mjs --init windsurf","install:claude":"node bin/install.mjs --claude","install:gemini":"node bin/install.mjs --gemini"},"_npmUser":{"name":"buivietphi","email":"buivietphii@gmail.com"},"repository":{"url":"git+https://github.com/buivietphi/skill-mobile-mt.git","type":"git"},"_npmVersion":"10.8.2","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.","directories":{},"_nodeVersion":"20.19.4","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/skill-mobile-mt_2.0.0_1772119132024_0.6946929035476788","host":"s3://npm-registry-packages-npm-production"}},"2.0.1":{"name":"@buivietphi/skill-mobile-mt","version":"2.0.1","keywords":["claude-code","gemini","kimi","antigravity","cursor","agent-skills","mobile","react-native","flutter","ios","android","clean-architecture","code-review","prompt-engineering"],"author":{"name":"buivietphi"},"license":"MIT","_id":"@buivietphi/skill-mobile-mt@2.0.1","maintainers":[{"name":"buivietphi","email":"buivietphii@gmail.com"}],"homepage":"https://github.com/buivietphi/skill-mobile-mt#readme","bugs":{"url":"https://github.com/buivietphi/skill-mobile-mt/issues"},"bin":{"skill-mobile":"bin/install.mjs"},"dist":{"shasum":"5f811c71ff07ba8b764b02f3277a9b23564b3246","tarball":"https://registry.npmjs.org/@buivietphi/skill-mobile-mt/-/skill-mobile-mt-2.0.1.tgz","fileCount":30,"integrity":"sha512-0Cj215xg2ML6NklK91kaWLsXMWby+wrwZXF44/o6krhhazxounVACKlx9wkYYzcqFCadlIojaQAabysH21PA8A==","signatures":[{"sig":"MEUCIFV/rHweFbX1shcbuZ5qomMs/eTqMFpkx6pvg5Iz6k1VAiEAmrrXaD76UKu2cq/jNV8a00ap8KPVFxqcjeNej/1qvaU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":382777},"engines":{"node":">=18"},"gitHead":"eed6a51a8ebb62e2880a85687960223424ef23cf","scripts":{"init":"node bin/install.mjs --init","init:all":"node bin/install.mjs --init all","init:cursor":"node bin/install.mjs --init cursor","install:all":"node bin/install.mjs --all","postinstall":"node bin/install.mjs --auto","init:copilot":"node bin/install.mjs --init copilot","install:kimi":"node bin/install.mjs --kimi","init:windsurf":"node bin/install.mjs --init windsurf","install:claude":"node bin/install.mjs --claude","install:gemini":"node bin/install.mjs --gemini"},"_npmUser":{"name":"buivietphi","email":"buivietphii@gmail.com"},"repository":{"url":"git+https://github.com/buivietphi/skill-mobile-mt.git","type":"git"},"_npmVersion":"10.8.2","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.","directories":{},"_nodeVersion":"20.19.4","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/skill-mobile-mt_2.0.1_1772120595677_0.19130996888411733","host":"s3://npm-registry-packages-npm-production"}},"2.1.0":{"name":"@buivietphi/skill-mobile-mt","version":"2.1.0","keywords":["claude-code","gemini","kimi","antigravity","cursor","agent-skills","mobile","react-native","flutter","ios","android","clean-architecture","code-review","prompt-engineering"],"author":{"name":"buivietphi"},"license":"MIT","_id":"@buivietphi/skill-mobile-mt@2.1.0","maintainers":[{"name":"buivietphi","email":"buivietphii@gmail.com"}],"homepage":"https://github.com/buivietphi/skill-mobile-mt#readme","bugs":{"url":"https://github.com/buivietphi/skill-mobile-mt/issues"},"bin":{"skill-mobile":"bin/install.mjs"},"dist":{"shasum":"ea7fa29d8d638a5237976b5d418fa22ac5cf0d40","tarball":"https://registry.npmjs.org/@buivietphi/skill-mobile-mt/-/skill-mobile-mt-2.1.0.tgz","fileCount":33,"integrity":"sha512-2Bpfx/zIFzORWMSKepXMBdRaQy8OD3zQHazVPikLfZhMbZDjJYfkKtLv5I+uG2ymmKtjkO+urstzC+S173nvsg==","signatures":[{"sig":"MEYCIQCxZpsKtrqaEA9oF775t7KGB6hY1wgZ3bzYdSBi//faFgIhAL8SE34Z+SCPQjhXHdOhlnCOYHE/W3I6qyZ/5W7s2pqQ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":528941},"engines":{"node":">=18"},"gitHead":"c7a4f24a65f2e8fe205c2a33513cf85ff6fc5c15","scripts":{"init":"node bin/install.mjs --init","init:all":"node bin/install.mjs --init all","init:cursor":"node bin/install.mjs --init cursor","install:all":"node bin/install.mjs --all","postinstall":"node bin/install.mjs --auto","init:copilot":"node bin/install.mjs --init copilot","install:kimi":"node bin/install.mjs --kimi","init:windsurf":"node bin/install.mjs --init windsurf","install:claude":"node bin/install.mjs --claude","install:gemini":"node bin/install.mjs --gemini"},"_npmUser":{"name":"buivietphi","email":"buivietphii@gmail.com"},"repository":{"url":"git+https://github.com/buivietphi/skill-mobile-mt.git","type":"git"},"_npmVersion":"10.8.2","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.","directories":{},"_nodeVersion":"20.19.4","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/skill-mobile-mt_2.1.0_1772180172351_0.09523065214824045","host":"s3://npm-registry-packages-npm-production"}},"2.2.0":{"name":"@buivietphi/skill-mobile-mt","version":"2.2.0","keywords":["claude-code","gemini","kimi","antigravity","cursor","agent-skills","mobile","react-native","flutter","ios","android","clean-architecture","code-review","prompt-engineering"],"author":{"name":"buivietphi"},"license":"MIT","_id":"@buivietphi/skill-mobile-mt@2.2.0","maintainers":[{"name":"buivietphi","email":"buivietphii@gmail.com"}],"homepage":"https://github.com/buivietphi/skill-mobile-mt#readme","bugs":{"url":"https://github.com/buivietphi/skill-mobile-mt/issues"},"bin":{"skill-mobile":"bin/install.mjs"},"dist":{"shasum":"c317a47062d48584d00edfd60bb33b6741c11030","tarball":"https://registry.npmjs.org/@buivietphi/skill-mobile-mt/-/skill-mobile-mt-2.2.0.tgz","fileCount":41,"integrity":"sha512-5gzsaBzohT8fCKNRuhUdebMT2XL4oD/o/yvBRIWugtWIg6VVrJSzxX45u0YraMnC3Y2dJpcllQ6OBYnZrsw82Q==","signatures":[{"sig":"MEUCICoItPT/o465n/V2sYdNOnjeDc/F/AKf7AdxRscr8xOxAiEA9bJ51tYIadyYZAu19vJO+WyPpuZ81h2+sp8Eu2qFdFQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":654608},"engines":{"node":">=18"},"gitHead":"334c123b4f7df3e3f5fb722bba01a2797a45215b","scripts":{"init":"node bin/install.mjs --init","init:all":"node bin/install.mjs --init all","init:cursor":"node bin/install.mjs --init cursor","install:all":"node bin/install.mjs --all","postinstall":"node bin/install.mjs --auto","init:copilot":"node bin/install.mjs --init copilot","install:kimi":"node bin/install.mjs --kimi","init:windsurf":"node bin/install.mjs --init windsurf","install:claude":"node bin/install.mjs --claude","install:gemini":"node bin/install.mjs --gemini"},"_npmUser":{"name":"buivietphi","email":"buivietphii@gmail.com"},"repository":{"url":"git+https://github.com/buivietphi/skill-mobile-mt.git","type":"git"},"_npmVersion":"10.8.2","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.","directories":{},"_nodeVersion":"20.19.4","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/skill-mobile-mt_2.2.0_1772227050207_0.8963109937656097","host":"s3://npm-registry-packages-npm-production"}},"2.2.1":{"name":"@buivietphi/skill-mobile-mt","version":"2.2.1","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":{"name":"buivietphi"},"license":"MIT","keywords":["claude-code","gemini","kimi","antigravity","cursor","agent-skills","mobile","react-native","flutter","ios","android","clean-architecture","code-review","prompt-engineering"],"bin":{"skill-mobile":"bin/install.mjs"},"scripts":{"postinstall":"node bin/install.mjs --auto","install:claude":"node bin/install.mjs --claude","install:gemini":"node bin/install.mjs --gemini","install:kimi":"node bin/install.mjs --kimi","install:all":"node bin/install.mjs --all","init":"node bin/install.mjs --init","init:cursor":"node bin/install.mjs --init cursor","init:copilot":"node bin/install.mjs --init copilot","init:windsurf":"node bin/install.mjs --init windsurf","init:all":"node bin/install.mjs --init all"},"engines":{"node":">=18"},"repository":{"type":"git","url":"git+https://github.com/buivietphi/skill-mobile-mt.git"},"_id":"@buivietphi/skill-mobile-mt@2.2.1","gitHead":"e1d16cb21e9c527a5e02a294e3a9d63a0a831429","bugs":{"url":"https://github.com/buivietphi/skill-mobile-mt/issues"},"homepage":"https://github.com/buivietphi/skill-mobile-mt#readme","_nodeVersion":"20.19.4","_npmVersion":"10.8.2","dist":{"integrity":"sha512-o6NQwngjFJmZkk2wLpVfWXjm6qTUwX2jzRKuWpmO7f/rdWJIcClMIa+e8ttW8Z2V0Gn7bNfwTWPe5uRMJVpUkg==","shasum":"a6ee003b0d4b9aeec0e3ba852f0514085d7da592","tarball":"https://registry.npmjs.org/@buivietphi/skill-mobile-mt/-/skill-mobile-mt-2.2.1.tgz","fileCount":41,"unpackedSize":652921,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIENNm2R/gZOqj6b+P552cROinaCs15EwY2uoJx0pCHwQAiEAoCPhFBpRjovenkjRcFVeQNMFHb4RtViw5CRR3/LNBVE="}]},"_npmUser":{"name":"buivietphi","email":"buivietphii@gmail.com"},"directories":{},"maintainers":[{"name":"buivietphi","email":"buivietphii@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/skill-mobile-mt_2.2.1_1772416075341_0.34065802646593535"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-26T15:18:51.932Z","modified":"2026-03-02T01:47:55.625Z","1.0.0":"2026-02-26T03:35:03.496Z","1.0.1":"2026-02-26T04:15:05.365Z","1.1.0":"2026-02-26T04:58:42.595Z","1.2.0":"2026-02-26T05:30:06.215Z","1.3.0":"2026-02-26T05:50:37.476Z","1.4.0":"2026-02-26T08:36:57.349Z","1.4.1":"2026-02-26T08:58:15.029Z","1.4.2":"2026-02-26T09:32:40.142Z","1.4.3":"2026-02-26T09:51:41.756Z","1.4.4":"2026-02-26T10:39:10.658Z","1.4.5":"2026-02-26T12:53:08.990Z","2.0.0":"2026-02-26T15:18:52.173Z","2.0.1":"2026-02-26T15:43:15.846Z","2.1.1":"2026-02-27T08:07:05.460Z","2.1.0":"2026-02-27T08:16:12.598Z","2.2.0":"2026-02-27T21:17:30.398Z","2.2.1":"2026-03-02T01:47:55.501Z"},"bugs":{"url":"https://github.com/buivietphi/skill-mobile-mt/issues"},"author":{"name":"buivietphi"},"license":"MIT","homepage":"https://github.com/buivietphi/skill-mobile-mt#readme","keywords":["claude-code","gemini","kimi","antigravity","cursor","agent-skills","mobile","react-native","flutter","ios","android","clean-architecture","code-review","prompt-engineering"],"repository":{"type":"git","url":"git+https://github.com/buivietphi/skill-mobile-mt.git"},"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.","maintainers":[{"name":"buivietphi","email":"buivietphii@gmail.com"}],"readme":"# @buivietphi/skill-mobile-mt\n\n**Master Senior Mobile Engineer** — AI skill for Claude Code, Cline, Roo Code, Cursor, Windsurf, Copilot, Codex, Gemini CLI, Kimi, Kilo Code, Kiro, and Antigravity.\n\nPre-built architecture patterns from **30+ production repos (200k+ GitHub stars)** including Ignite, Expensify, Mattermost, Immich, AppFlowy, Now in Android, TCA. Trained from research of **top 53k+ star skill repos** (everything-claude-code, awesome-cursorrules, planning-with-files, Lovable, Cursor, Manus Agent prompts). Auto-adaptation to your current project.\n\n## Install\n\n```bash\nnpx @buivietphi/skill-mobile-mt\n```\n\nInteractive checkbox UI — detects which AI agents are installed, lets you select with arrow keys + space.\n\n### Install to specific agents\n\n```bash\nnpx @buivietphi/skill-mobile-mt --claude       # Claude Code\nnpx @buivietphi/skill-mobile-mt --codex        # Codex\nnpx @buivietphi/skill-mobile-mt --gemini       # Gemini CLI\nnpx @buivietphi/skill-mobile-mt --kimi         # Kimi\nnpx @buivietphi/skill-mobile-mt --antigravity  # Antigravity\nnpx @buivietphi/skill-mobile-mt --all          # All agents\nnpx @buivietphi/skill-mobile-mt --path ./dir   # Custom directory\n```\n\n### Generate project-level rules\n\nCline, Roo Code, Cursor, Windsurf, Copilot, Kilo Code, and Kiro read rules from **project-level files**. Run `--init` inside your project to generate them:\n\n```bash\nnpx @buivietphi/skill-mobile-mt --init            # Interactive selector\nnpx @buivietphi/skill-mobile-mt --init cursor     # .cursorrules\nnpx @buivietphi/skill-mobile-mt --init cline      # .clinerules/mobile-rules.md\nnpx @buivietphi/skill-mobile-mt --init roocode    # .roo/rules/mobile-rules.md\nnpx @buivietphi/skill-mobile-mt --init copilot    # .github/copilot-instructions.md\nnpx @buivietphi/skill-mobile-mt --init windsurf   # .windsurfrules\nnpx @buivietphi/skill-mobile-mt --init kilocode   # .kilocode/rules/mobile-rules.md\nnpx @buivietphi/skill-mobile-mt --init kiro       # .kiro/steering/mobile-rules.md\nnpx @buivietphi/skill-mobile-mt --init all        # All files\n```\n\n**What `--init` does:**\n1. Auto-detects your project (framework, language, state management, navigation, API client, package manager)\n2. Generates rules files pre-filled with your detected stack\n3. Includes mobile best practices, security rules, and quality gates\n4. Won't overwrite existing files (safe to run multiple times)\n\n## Usage\n\n### Mode 1: Pre-Built Architecture (default)\n\n```\n@skill-mobile-mt\n```\n\nUses battle-tested patterns from 30+ production repos:\n- **React Native** — Ignite (19.7k stars), Obytes Template, Expensify/App, Mattermost Mobile, Artsy Eigen\n- **Flutter** — Immich (93.5k stars), AppFlowy (68.2k), Spotube (44.6k), Hiddify, Ente Photos\n- **iOS** — TCA / Point-Free (14.4k), Clean Arch SwiftUI, Modern Clean Arch\n- **Android** — Now in Android (20.7k), Android Showcase, Mihon (18.8k)\n\n### Mode 2: Adapt to Your Project (project)\n\n```\n@skill-mobile-mt project\n```\n\nReads your current project first, then follows **your** conventions:\n- Detects framework, language, package manager, state management, navigation\n- Matches your naming, imports, file structure, patterns\n- Clones the most similar existing feature when scaffolding new ones\n- Never suggests migrations or imposes different architecture\n\n## Quick Start Examples\n\n### Step 1: Install the skill\n\n```bash\n# Install globally (one-time setup)\nnpx @buivietphi/skill-mobile-mt\n```\n\nYou'll see an interactive checkbox — use arrow keys to navigate, space to select, Enter to confirm:\n\n```\n  Select agents to install:\n  ↑↓ navigate   Space toggle   A select all   Enter confirm   Q cancel\n\n  › ◉ Claude Code   [detected]\n    ◯ Cline          [detected]\n    ◯ Roo Code       [not found]\n    ◯ Cursor         [detected]\n    ◯ Windsurf       [not found]\n    ◯ Copilot        [not found]\n    ◯ Codex          [not found]\n    ◉ Gemini CLI     [detected]\n    ◯ Kimi           [not found]\n    ◯ Kilo Code      [not found]\n    ◯ Kiro           [not found]\n    ◯ Antigravity    [not found]\n```\n\nInstall output:\n\n```\n  ✓ skill-mobile-mt/    → Claude Code  (~/.claude/skills/skill-mobile-mt)\n  ✓ humanizer-mobile/   → Claude Code  (~/.claude/skills/humanizer-mobile)\n```\n\nBoth are installed automatically. Use `@humanizer-mobile` for app store copy, release notes, and UX text.\n\n### Step 2: Generate project rules\n\n```bash\n# cd into your mobile project first\ncd ~/projects/my-app\n\n# Generate rules for your agents\nnpx @buivietphi/skill-mobile-mt --init all\n```\n\nOutput:\n\n```\n  📁 Project directory: /Users/you/projects/my-app\n  🔍 Detected: Expo (React Native) (TypeScript)\n\n  ✓ .cursorrules → Cursor (auto-detected: Expo (React Native))\n  ✓ .github/copilot-instructions.md → GitHub Copilot\n  ✓ .clinerules/mobile-rules.md → Cline\n  ✓ .roo/rules/mobile-rules.md → Roo Code\n  ✓ .kilocode/rules/mobile-rules.md → Kilo Code\n  ✓ .kiro/steering/mobile-rules.md → Kiro\n  ✓ .windsurfrules → Windsurf\n\n  ✅ Done! → 7 file(s) generated\n```\n\n### Step 3: Use in your AI agent\n\n#### Claude Code\n\n```bash\n# In Claude Code terminal, type:\n@skill-mobile-mt\n\n# Then ask anything:\n> Create auth feature with login and register screens\n\n# Or with project mode (reads YOUR code first):\n@skill-mobile-mt project\n> Add cart feature following the same pattern as ProductList\n```\n\n#### Cline / Roo Code / Kilo Code\n\nAfter running `--init cline` (or `roocode`, `kilocode`), rules are auto-loaded from the project directory. Just open your project and ask:\n\n```\n> Create a login screen with email/password\n> Fix the crash in ProductDetail when images is null\n> Review this PR for mobile best practices\n```\n\n#### Cursor\n\nAfter running `--init cursor`, Cursor auto-loads `.cursorrules` every session. Just open your project and code normally.\n\n#### Kiro (AWS)\n\nAfter running `--init kiro`, Kiro loads `.kiro/steering/mobile-rules.md` as steering context. The generated file uses `inclusion: always` frontmatter.\n\n#### GitHub Copilot\n\nAfter running `--init copilot`, Copilot reads `.github/copilot-instructions.md` as workspace context.\n\n#### Windsurf\n\nAfter running `--init windsurf`, Windsurf auto-loads `.windsurfrules`. Just code normally.\n\n#### Gemini CLI\n\n```bash\n# In Gemini CLI:\n@skill-mobile-mt\n> Setup a new Flutter project with Riverpod + clean architecture\n```\n\n#### Codex / Kimi / Antigravity\n\nSame as Claude Code — the skill is loaded from the skills directory.\n\n### Example Prompts (all agents)\n\n| What you want | What to type |\n|--------------|-------------|\n| New feature | `Create auth feature with login, register, forgot password` |\n| New screen | `Add settings screen with profile, notifications, theme toggle` |\n| Fix bug | `Fix crash when product.images is undefined` |\n| Code review | `Review src/features/cart/ for mobile best practices` |\n| Performance | `Optimize ProductList — it's janky when scrolling 100+ items` |\n| Architecture | `Setup project structure for a new Expo app with Zustand + TanStack Query` |\n| Release | `Prepare the app for App Store submission` |\n| Security | `Audit the auth flow for security vulnerabilities` |\n\n## Auto-Detect\n\nThe skill automatically detects before any action:\n\n| What | How |\n|------|-----|\n| **Framework** | `pubspec.yaml` → Flutter, `package.json` with `react-native` → RN, `*.xcodeproj` → iOS, `build.gradle` → Android |\n| **Language** | `.dart` → Dart, `.tsx/.ts` → TypeScript, `.swift` → Swift, `.kt` → Kotlin |\n| **Package Manager** | `yarn.lock` → yarn, `pnpm-lock.yaml` → pnpm, `package-lock.json` → npm, `pubspec.lock` → flutter pub |\n| **State Management** | Redux / MobX / Zustand / Riverpod / BLoC / StateFlow / Combine |\n| **Navigation** | React Navigation / Expo Router / GoRouter / NavigationStack |\n\n## Smart Loading\n\nOnly loads the relevant platform docs — saves **~45% context tokens** vs loading everything.\n\n```\nFlutter project?\n  → Load: flutter/flutter.md + ios/ + android/ + shared/\n  → Skip: react-native/\n\nReact Native project?\n  → Load: react-native/react-native.md + ios/ + android/ + shared/\n  → Skip: flutter/\n\niOS only?\n  → Load: ios/ios-native.md + shared/\n  → Skip: flutter/ + react-native/ + android/\n```\n\n## Context Cost\n\n| Scenario | Tokens | % of 128K | % of 200K |\n|----------|-------:|----------:|----------:|\n| SKILL.md only | ~25,150 | 19.6% | 12.6% |\n| **Smart load (recommended)** | **~53,350 – 57,350** | **42% – 45%** | **27% – 29%** |\n| Cross-platform (RN+Flutter+iOS+Android) | ~95,350 | 74.5% | 47.7% |\n| All files loaded | ~166,380 | 130.0% | 83.2% |\n| | | *exceeds 128K* | *fits 200K* |\n\n### Per-file token breakdown\n\n| File | Tokens |\n|------|-------:|\n| `SKILL.md` | ~25,150 |\n| `AGENTS.md` | ~6,440 |\n| `react-native/react-native.md` | ~5,840 |\n| `flutter/flutter.md` | ~2,350 |\n| `ios/ios-native.md` | ~1,660 |\n| `android/android-native.md` | ~4,370 |\n| `shared/code-review.md` | ~11,600 |\n| `shared/bug-detection.md` | ~7,290 |\n| `shared/debugging-intelligence.md` | ~8,730 |\n| `shared/prompt-engineering.md` | ~7,440 |\n| `shared/architecture-intelligence.md` | ~3,860 |\n| `shared/common-pitfalls.md` | ~1,330 |\n| `shared/error-recovery.md` | ~2,780 |\n| `shared/document-analysis.md` | ~1,520 |\n| `shared/release-checklist.md` | ~670 |\n| `shared/anti-patterns.md` | ~2,910 |\n| `shared/performance-prediction.md` | ~1,310 |\n| `shared/platform-excellence.md` | ~1,890 |\n| `shared/version-management.md` | ~3,660 |\n| `shared/observability.md` | ~5,750 |\n| `shared/offline-first.md` | ~2,930 |\n| `shared/testing-strategy.md` | ~2,500 |\n| `shared/ci-cd.md` | ~2,830 |\n| `shared/ai-dlc-workflow.md` | ~1,950 |\n| `shared/ui-ux-mobile.md` | ~6,910 |\n| `shared/storage-patterns.md` | ~2,760 |\n| `shared/i18n-localization.md` | ~3,140 |\n| `shared/intent-analysis.md` | ~6,250 |\n| `shared/code-generation-templates.md` | ~5,370 |\n| `shared/spec-to-code.md` | ~2,640 |\n| `shared/navigation-patterns.md` | ~2,900 |\n| `shared/complex-ui-patterns.md` | ~3,810 |\n| `shared/data-flow-patterns.md` | ~3,250 |\n| `shared/error-handling.md` | ~2,960 |\n| `shared/testing-patterns.md` | ~3,410 |\n| `shared/claude-md-template.md` | ~1,050 |\n| `shared/agent-rules-template.md` | ~2,870 |\n| `humanizer/humanizer-mobile.md` | ~2,630 |\n| **Total** | **~166,380** |\n\n## Installed Structure\n\n```\n~/.claude/skills/               (or ~/.cline/skills/, ~/.roo/skills/, ~/.gemini/skills/, etc.)\n└── skill-mobile-mt/\n    ├── SKILL.md                       Entry point + auto-detect + quality gates\n    ├── AGENTS.md                      Multi-agent compatibility\n    ├── react-native/\n    │   └── react-native.md            React Native + Expo patterns\n    ├── flutter/\n    │   └── flutter.md                 Flutter + Dart patterns\n    ├── ios/\n    │   └── ios-native.md              iOS Swift patterns\n    ├── android/\n    │   └── android-native.md          Android Kotlin + Java patterns\n    └── shared/\n        ├── code-review.md             Senior review checklist\n        ├── bug-detection.md           Auto bug scanner (4 modes + git-aware)\n        ├── debugging-intelligence.md  30+ error patterns + root cause tracing\n        ├── prompt-engineering.md      Auto-think + prompt templates\n        ├── architecture-intelligence.md  Patterns from 30+ production repos\n        ├── common-pitfalls.md         Problem → Symptoms → Solution\n        ├── error-recovery.md          16 build/runtime error fixes\n        ├── document-analysis.md       Parse docs/images → code\n        ├── anti-patterns.md           PII, cardinality, payload detection\n        ├── performance-prediction.md  Frame budget, FPS prediction\n        ├── platform-excellence.md     iOS 18+ vs Android 15+ guidelines + HIG\n        ├── version-management.md      SDK compatibility matrix\n        ├── observability.md           Sessions as 4th pillar\n        ├── release-checklist.md       Pre-release verification\n        ├── offline-first.md           Local-first + sync patterns\n        ├── storage-patterns.md        Storage selection matrix (AsyncStorage/MMKV/SQLite/etc.)\n        ├── i18n-localization.md       Internationalization + RTL + locale patterns\n        ├── testing-strategy.md        Detox + Maestro + XCUITest + Espresso E2E\n        ├── ci-cd.md                   GitHub Actions CI/CD templates\n        ├── ai-dlc-workflow.md         AI-DLC structured dev workflow\n        ├── ui-ux-mobile.md            Design system + screen templates + touch + navigation\n        ├── claude-md-template.md      CLAUDE.md template for projects\n        └── agent-rules-template.md    Rules templates for all agents\n```\n\n### Project-level files (generated by `--init`)\n\n```\nyour-project/\n├── .cursorrules                       Cursor rules (auto-detected stack)\n├── .windsurfrules                     Windsurf rules (auto-detected stack)\n├── .clinerules/\n│   └── mobile-rules.md               Cline rules (auto-detected stack)\n├── .roo/\n│   └── rules/\n│       └── mobile-rules.md           Roo Code rules (auto-detected stack)\n├── .kilocode/\n│   └── rules/\n│       └── mobile-rules.md           Kilo Code rules (auto-detected stack)\n├── .kiro/\n│   └── steering/\n│       └── mobile-rules.md           Kiro steering (auto-detected stack)\n└── .github/\n    └── copilot-instructions.md        Copilot rules (auto-detected stack)\n```\n\n## What's Included\n\n### Clean Architecture & SOLID\n- Dependencies flow inward (UI → Domain → Data)\n- Single responsibility per file (max 300 lines)\n- Dependency injection, no hardcoded singletons\n\n### Code Review Protocol (12-category, PR-level)\n- **PR-Level Review**: size check, single responsibility, test accompaniment, commit hygiene — BEFORE code review\n- **12 categories**: architecture, correctness, boundary conditions, test quality, readability, performance, security (expanded), accessibility (WCAG 2.1), breaking changes, platform, documentation, i18n\n- **Severity levels**: Critical / High / Medium / Low with structured output format\n- **Auto-fail patterns**: 10 code + 4 PR-level + 7 AI-specific grounding checks\n- **Review output**: PR-level summary → findings by severity → verdict (APPROVE / CHANGES REQUESTED)\n- **Boundary conditions**: null, empty, off-by-one, numeric limits, unicode, timezone — dedicated dimension\n- **Accessibility**: touch targets (44pt/48dp), contrast ratios, screen reader, font scaling, focus management\n- **Breaking change detection**: public API, deep links, DB schema, push payload, analytics events\n- **Security depth**: certificate pinning, JWT lifecycle, bridge security, biometric auth, dependency audit\n- **Grounded review (anti-false-positive)**: verify every finding before flagging — check actual installed APIs, don't flag from memory, confidence levels (high/medium/low)\n- **Practical usage review**: 25 production crash patterns — 5 cross-platform + 5 React Native + 5 Flutter + 5 iOS Swift + 5 Android Kotlin\n- **Library-specific traps**: React Native, Flutter, iOS Swift, Android Kotlin — real gotchas per platform\n- **Cross-platform examples**: before/after code for all 4 platforms (not just RN)\n\n### Bug Detection Scanner\n- 4 debug modes: Error Analysis, Fix Bug, Investigate, Diagnostic Scan\n- Git-aware debugging: checks recent commits before deep-diving (auto-skips if no git)\n- 4-phase fix protocol: Root Cause → Pattern Analysis → Single Hypothesis → Defense in Depth\n- 45+ error pattern database with exact search strategies — RN (7) + Flutter (6) + iOS Swift (5) + Android Kotlin (6) + Network (4) + State (3) + Navigation (2) + Build (4) + Platform (3)\n- Anti-rationalization table: catches self-deception during debugging\n\n### Decision Matrix Protocol\n- Structured comparison format when multiple valid approaches exist\n- Estimation protocol: classify effort XS/S/M/L/XL with risk assessment\n- Migration/upgrade decision protocol: breaking changes analysis + impact scan\n\n### Codebase Scan Strategy\n- 3 scan levels: Quick (~5 reads), Standard (~15 reads), Deep (~30+ reads)\n- Monorepo strategy: focus target package, scan shared deps\n- Multi-module strategy: JS/TS vs Native vs Cross-layer task detection\n\n### Grounding Protocol (Anti-Hallucination)\n- **Source hierarchy**: project code > skill files > official docs > production repos > AI knowledge\n- **Mandatory rules**: Read before answer, verify APIs exist, cite sources, say \"I don't know\" when unsure\n- **No phantom packages**: verify package exists in package.json before suggesting\n- **Version-specific**: check actual SDK version, never assume latest\n- **Grounded bug fix**: read file → find exact line → verify types → cite source\n- **Anti-hallucination checklist**: runs before every AI response\n\n### Docs-First Protocol (Always Use Latest)\n- **WebSearch before coding**: when setting up any library, ALWAYS search official docs first\n- **Never rely on AI memory**: docs change, APIs change, syntax changes between versions\n- **Package installation protocol**: verify exists → check compatibility → search install guide → test both platforms\n- **Common AI traps**: React Navigation v5 vs v7, Firebase v8 vs v9 modular, Swift async/await availability\n- **Version matrix + live verification**: snapshot matrix in skill + mandatory WebSearch for current data\n\n### Security Protocol\n- **7-category security scan** on every feature: secrets, token storage, input validation, network, data protection, auth flow, platform-specific\n- **6 absolute rules**: never store tokens in plain storage, never hardcode secrets, never log sensitive data, never trust deep links, never disable SSL, never commit .env\n- **Platform-specific checks**: iOS ATS + privacy manifest, Android cleartext + ProGuard + exported components\n- **Never skip security**: even for prototypes, internal apps, or \"quick fixes\"\n\n### Advanced AI Patterns (from top 53k+ star repos + Lovable, Cursor, Manus prompts)\n- **7 Cardinal Rules**: Inviolable rules at the top of SKILL.md (read before write, verify before done, clone before create, cite source, 4 states always, platform parity, ask after 3 fails)\n- **Self-Critique Loop**: Generate → Review own code → Refine → Verify (catch bugs before \"done\")\n- **Context Staleness Rule**: Re-read files after 5+ messages (from Cursor's pattern)\n- **Parallel Execution**: Default to parallel tool calls unless sequential dependency\n- **Leverage Pyramid**: Research → Planning → Implementation (review plans, not just code)\n- **Session State Tracking**: Structured progress tracking for long multi-file tasks\n- **Verification-First**: Include test criteria BEFORE implementation (Anthropic's #1 recommendation)\n- **Assumption-Driven Progress**: State assumptions → proceed → let user correct (don't ask for every decision)\n- **Negative Space Pattern**: Explicit NEVER rules prevent drift better than positive instructions\n- **Brevity Default**: 1-line status updates, detail only when asked (from Lovable, Claude Code)\n- **Error Recovery Protocol**: Max 3 attempts with escalation, then ask user\n- **Build & Deploy Gates**: Platform-specific pre-completion checklists\n- **Mobile Anti-Patterns**: Common mistakes from AI tools (and how to avoid them)\n\n### Intelligent Prompt Engineering\n- Trained from 7 major AI tools' system prompts (Lovable, Cursor, Manus, Windsurf, Kiro, Replit, Claude Code)\n- XML tag structure for clarity (`<task>`, `<context>`, `<instructions>`, `<constraints>`)\n- Enhanced auto-think templates with pre-action validation\n- Progressive context loading (5 levels: overview → pattern → files → docs → expert)\n- Just-in-time file reading (grep first, read only needed)\n- Reference pattern system (clone existing instead of reading docs)\n- Multi-AI format support (Claude, Gemini, Kimi, Cursor, Copilot, Windsurf)\n- Advanced patterns: verification-first, investigate-before-answer, batched operations, negative space\n\n### Document Analysis\n- Parse images (mockups, wireframes), PDFs (requirements), DOCX, XML, JSON\n- UI Analysis: extract layout, components, styling, states from screenshots\n- Requirements Extraction: user stories, screen flows, data models, business rules\n- Document → Code pipeline: read → extract → map features → scaffold\n\n### Architecture Intelligence (from 30+ production repos)\n\n- **Architecture Intelligence** (`architecture-intelligence.md`): Cross-platform patterns from Ignite, Immich, AppFlowy, TCA, Now in Android and more. Includes: dual state management, feature-based modules, bootstrap/startup pattern, functional error handling, architecture validation (Konsist), production folder structure templates, and decision matrices for state/nav/testing.\n\n### Production Patterns (from Senaiverse, Mhuxain, VoltAgent, Nexus)\n\n- **Anti-Pattern Detection** (`anti-patterns.md`): Detect PII leaks (CRITICAL), high cardinality tags, unbounded payloads, unstructured logs, sync telemetry on main thread — with auto-fix suggestions\n- **Performance Prediction** (`performance-prediction.md`): Calculate frame budget, FlatList bridge calls, and memory usage BEFORE writing code. Example: `50 items × 3 bridge calls × 0.3ms = 45ms/frame → 22 FPS ❌ JANK`\n- **Platform Excellence** (`platform-excellence.md`): iOS 18+ vs Android 15+ native UX standards — navigation patterns, typography, haptic feedback types, permission timing, ratings prompt flow, Live Activities/Dynamic Island, performance targets (cold start < 1s iOS, < 1.5s Android)\n- **Version Management** (`version-management.md`): Full SDK compatibility matrix for RN 0.73-0.76, Expo 50-52, Flutter 3.22-3.27, iOS 16-18, Android 13-15. Check SDK compat BEFORE `npm install`. Release-mode testing protocol.\n- **Observability** (`observability.md`): Sessions as the 4th pillar (Metrics + Logs + Traces + **Sessions**). Session lifecycle, enrichment API, unified instrumentation stack, correlation queries. Every event carries `session_id` for full user journey reconstruction.\n\n### UI/UX Mobile Design\n- Screen templates with ASCII wireframes: Login, Home/Feed, Detail, Profile/Settings, Onboarding\n- Design tokens system (colors, spacing, radius, shadows, typography) for RN and Flutter\n- Component patterns: bottom sheet, empty state, loading skeleton, toast/snackbar\n- Touch targets (44pt iOS / 48dp Android), dark mode implementation, animation guidelines\n- Accessibility checklist (screen reader labels, contrast ratios, font scaling)\n- Device sizing reference table (iPhone SE → Pro Max, Android small → large, iPad)\n\n### AI-DLC Workflow (AI-Driven Development Lifecycle)\n- Based on AWS AI-DLC methodology — structured development for complex features\n- **Elaboration**: decompose task into Intent + Units before coding\n- **Construction loop**: 4 Hats per Unit (Architecture → Builder → Security → Reviewer)\n- **Backpressure gates**: compiler, lint, security, review must pass before next Unit\n- **Operating modes**: HITL (human approves each Unit), OHOTL, AHOTL\n- Auto-activates for multi-screen features (3+ units); skips for bug fixes\n\n### Error Recovery\n- 16 common build/runtime errors with concrete fixes\n- Platform-specific solutions (RN CLI, Expo, Flutter, iOS, Android)\n- General recovery protocol for systematic debugging\n\n### Release & Review\n- Pre-release checklist for App Store and Play Store submissions\n- Common pitfalls with Problem → Symptoms → Solution format\n- Security audit patterns\n\n### Security Non-Negotiables\n- No hardcoded secrets\n- Secure token storage (Keychain / EncryptedSharedPreferences / SecureStore)\n- Deep link validation, HTTPS only\n\n## Supported Agents\n\n| Agent | How it works | Setup command |\n|-------|-------------|---------------|\n| **Claude Code** | Reads from `~/.claude/skills/` | `npx skill-mobile-mt --claude` |\n| **Cline** | Reads `.clinerules/` from project root | `npx skill-mobile-mt --init cline` |\n| **Roo Code** | Reads `.roo/rules/` from project root | `npx skill-mobile-mt --init roocode` |\n| **Cursor** | Reads `.cursorrules` from project root | `npx skill-mobile-mt --init cursor` |\n| **Windsurf** | Reads `.windsurfrules` from project root | `npx skill-mobile-mt --init windsurf` |\n| **Copilot** | Reads `.github/copilot-instructions.md` | `npx skill-mobile-mt --init copilot` |\n| **Codex** | Reads from `~/.codex/skills/` | `npx skill-mobile-mt --codex` |\n| **Gemini CLI** | Reads from `~/.gemini/skills/` | `npx skill-mobile-mt --gemini` |\n| **Kimi** | Reads from `~/.kimi/skills/` | `npx skill-mobile-mt --kimi` |\n| **Kilo Code** | Reads `.kilocode/rules/` from project root | `npx skill-mobile-mt --init kilocode` |\n| **Kiro** | Reads `.kiro/steering/` from project root | `npx skill-mobile-mt --init kiro` |\n| **Antigravity** | Reads from `~/.agents/skills/` | `npx skill-mobile-mt --antigravity` |\n\n## Companion Skill\n\n**humanizer-mobile** is auto-installed alongside the main skill. It humanizes AI-generated mobile copy — app store descriptions, release notes, error messages, push notifications, paywall text.\n\n```\n@humanizer-mobile\n> \"Humanize this app store description\"\n```\n\n---\n\n## License\n\nMIT — by [buivietphi](https://github.com/buivietphi)\n","readmeFilename":"README.md"}