@buivietphi/skill-mobile-mt 1.1.0 → 1.2.0

package/AGENTS.md

@@ -6,16 +6,16 @@
 
 ## Agent Compatibility Matrix
 
-| Agent | Skill Path | Invocation | Think Block |
-|-------|-----------|------------|-------------|
-| Claude Code | `~/.claude/skills/skill-mobile-mt/` | `@skill-mobile-mt` or `@skill-mobile-mt project` | `<think>...</think>` |
-| Codex | `~/.codex/skills/skill-mobile-mt/` | `@skill-mobile-mt` or load as context | `<think>...</think>` |
-| Gemini CLI | `~/.gemini/skills/skill-mobile-mt/` | Load as context | `## Thinking:` block |
-| Kimi | `~/.kimi/skills/skill-mobile-mt/` | Load as context | `【思考】` or markdown |
-| Cursor | `~/.cursor/skills/skill-mobile-mt/` | Auto-loaded in Composer | Inline reasoning |
-| Copilot | `~/.copilot/skills/skill-mobile-mt/` | Loaded via workspace | `// PLAN:` comments |
-| Windsurf | `~/.windsurf/skills/skill-mobile-mt/` | Auto-loaded | Inline reasoning |
-| Antigravity | `~/.agents/skills/skill-mobile-mt/` | Loaded by orchestrator | Agent-native format |
+| Agent | How it loads rules | Setup | Think Block |
+|-------|-------------------|-------|-------------|
+| Claude Code | `~/.claude/skills/` (auto) | `npx skill-mobile-mt --claude` | `<think>...</think>` |
+| Codex | `~/.codex/skills/` (auto) | `npx skill-mobile-mt --codex` | `<think>...</think>` |
+| Gemini CLI | `~/.gemini/skills/` (auto) | `npx skill-mobile-mt --gemini` | `## Thinking:` block |
+| Kimi | `~/.kimi/skills/` (manual) | `npx skill-mobile-mt --kimi` | `【思考】` or markdown |
+| **Cursor** | **`.cursorrules` in project root** | **`npx skill-mobile-mt --init cursor`** | Inline reasoning |
+| **Copilot** | **`.github/copilot-instructions.md`** | **`npx skill-mobile-mt --init copilot`** | `// PLAN:` comments |
+| **Windsurf** | **`.windsurfrules` in project root** | **`npx skill-mobile-mt --init windsurf`** | Inline reasoning |
+| Antigravity | `~/.agents/skills/` (auto) | `npx skill-mobile-mt --antigravity` | Agent-native format |
 
 ---
 
@@ -137,7 +137,7 @@ The agent reads the task, then decides which extra file to load:
 ```yaml
 skill:
   name: skill-mobile-mt
-  version: "1.0.0"
+  version: "1.2.0"
   author: buivietphi
   category: engineering
   tags:
@@ -299,10 +299,23 @@ Priority 6 (ON-DEMAND): shared/common-pitfalls.md — Known issue patterns
 - Supports both Chinese and English prompts
 - Think blocks use `【思考】` format
 
-### Cursor / Copilot / Windsurf
-- Auto-loaded when skill directory detected in workspace
-- Mode determined by presence of project files in workspace
-- Think blocks embedded as comments before code
+### Cursor
+- **Does NOT read from `~/.cursor/skills/`** — reads `.cursorrules` from project root
+- Run `npx @buivietphi/skill-mobile-mt --init cursor` in your project to generate `.cursorrules`
+- The generated file includes auto-detected framework, rules, and security patterns
+- Think blocks embedded as inline reasoning in Composer
+
+### GitHub Copilot
+- **Does NOT read from `~/.copilot/skills/`** — reads `.github/copilot-instructions.md`
+- Run `npx @buivietphi/skill-mobile-mt --init copilot` in your project to generate the file
+- The generated file includes code patterns, required templates, and rules
+- Think blocks as `// PLAN:` comments before code
+
+### Windsurf
+- **Does NOT read from `~/.windsurf/skills/`** — reads `.windsurfrules` from project root
+- Run `npx @buivietphi/skill-mobile-mt --init windsurf` in your project to generate `.windsurfrules`
+- The generated file includes coding rules, security rules, and architecture patterns
+- Think blocks as inline reasoning
 
 ### Antigravity
 - Orchestrator loads based on detected project type
@@ -340,6 +353,8 @@ Copy the relevant section to your project to enable auto-check rules in every se
 
 ## Installation Paths
 
+### Skill directory install (agents that read from skills/)
+
 ```bash
 # Claude Code (global)
 ~/.claude/skills/skill-mobile-mt/
@@ -356,15 +371,6 @@ Copy the relevant section to your project to enable auto-check rules in every se
 # Kimi
 ~/.kimi/skills/skill-mobile-mt/
 
-# Cursor
-~/.cursor/skills/skill-mobile-mt/
-
-# Windsurf
-~/.windsurf/skills/skill-mobile-mt/
-
-# Copilot
-~/.copilot/skills/skill-mobile-mt/
-
 # Antigravity (shared agent directory)
 ~/.agents/skills/skill-mobile-mt/
 
@@ -372,6 +378,28 @@ Copy the relevant section to your project to enable auto-check rules in every se
 npx @buivietphi/skill-mobile-mt --path /your/custom/path
 ```
 
+### Project-level files (agents that read from project root)
+
+These agents read rules from project-level files, NOT from a skills directory.
+Use `--init` to generate them:
+
+```bash
+# Generate all project-level files (interactive selector)
+npx @buivietphi/skill-mobile-mt --init
+
+# Generate specific agent file
+npx @buivietphi/skill-mobile-mt --init cursor     # → .cursorrules
+npx @buivietphi/skill-mobile-mt --init copilot    # → .github/copilot-instructions.md
+npx @buivietphi/skill-mobile-mt --init windsurf   # → .windsurfrules
+npx @buivietphi/skill-mobile-mt --init all        # → all three files
+```
+
+**What `--init` does:**
+1. Auto-detects your project (framework, language, state management, etc.)
+2. Generates rules files pre-filled with your detected stack
+3. Includes all mobile best practices, security rules, and quality gates
+4. Won't overwrite existing files (safe to run multiple times)
+
 ---
 
 ## Metadata
@@ -380,7 +408,7 @@ npx @buivietphi/skill-mobile-mt --path /your/custom/path
 {
   "id": "skill-mobile-mt",
   "name": "skill-mobile-mt",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "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.",

package/README.md

@@ -2,7 +2,7 @@
 
 **Master Senior Mobile Engineer** — AI skill for Claude Code, Codex, Gemini CLI, Kimi, Cursor, Copilot, Windsurf, and Antigravity.
 
-Pre-built architecture patterns from **18 production mobile apps + 4 production open-source skills** + auto-adaptation to your current project.
+Pre-built architecture patterns from **30+ production repos (200k+ GitHub stars)** including Ignite, Expensify, Mattermost, Immich, AppFlowy, Now in Android, TCA + auto-adaptation to your current project.
 
 ## Install
 
@@ -10,20 +10,38 @@ Pre-built architecture patterns from **18 production mobile apps + 4 production
 npx @buivietphi/skill-mobile-mt
 ```
 
-Interactive mode — detects which AI agents are installed and prompts you.
+Interactive checkbox UI — detects which AI agents are installed, lets you select with arrow keys + space.
 
 ### Install to specific agents
 
 ```bash
-npx @buivietphi/skill-mobile-mt --claude       # Claude Code only
-npx @buivietphi/skill-mobile-mt --codex        # Codex only
-npx @buivietphi/skill-mobile-mt --gemini       # Gemini CLI only
-npx @buivietphi/skill-mobile-mt --kimi         # Kimi only
-npx @buivietphi/skill-mobile-mt --antigravity  # Antigravity only
-npx @buivietphi/skill-mobile-mt --all          # All detected agents
+npx @buivietphi/skill-mobile-mt --claude       # Claude Code
+npx @buivietphi/skill-mobile-mt --codex        # Codex
+npx @buivietphi/skill-mobile-mt --gemini       # Gemini CLI
+npx @buivietphi/skill-mobile-mt --kimi         # Kimi
+npx @buivietphi/skill-mobile-mt --antigravity  # Antigravity
+npx @buivietphi/skill-mobile-mt --all          # All agents
 npx @buivietphi/skill-mobile-mt --path ./dir   # Custom directory
 ```
 
+### Generate project-level rules (Cursor, Copilot, Windsurf)
+
+Cursor, Copilot, and Windsurf read rules from **project-level files**, not from a skills directory. Run `--init` inside your project to generate them:
+
+```bash
+npx @buivietphi/skill-mobile-mt --init            # Interactive selector
+npx @buivietphi/skill-mobile-mt --init cursor     # .cursorrules
+npx @buivietphi/skill-mobile-mt --init copilot    # .github/copilot-instructions.md
+npx @buivietphi/skill-mobile-mt --init windsurf   # .windsurfrules
+npx @buivietphi/skill-mobile-mt --init all        # All three files
+```
+
+**What `--init` does:**
+1. Auto-detects your project (framework, language, state management, navigation, API client, package manager)
+2. Generates rules files pre-filled with your detected stack
+3. Includes mobile best practices, security rules, and quality gates
+4. Won't overwrite existing files (safe to run multiple times)
+
 ## Usage
 
 ### Mode 1: Pre-Built Architecture (default)
@@ -32,11 +50,11 @@ npx @buivietphi/skill-mobile-mt --path ./dir   # Custom directory
 @skill-mobile-mt
 ```
 
-Uses battle-tested patterns extracted from real production apps:
-- **10 React Native apps** — Redux, MobX, Apollo/GraphQL, React Navigation
-- **3 Flutter apps** — Riverpod, Clean Architecture, Dio, GoRouter
-- **4 Android Native apps** — Multi-module Gradle, Hilt, Compose, Room
-- **1 iOS Native app** — Swift, MVVM, CocoaPods, Combine
+Uses battle-tested patterns from 30+ production repos:
+- **React Native** — Ignite (19.7k stars), Obytes Template, Expensify/App, Mattermost Mobile, Artsy Eigen
+- **Flutter** — Immich (93.5k stars), AppFlowy (68.2k), Spotube (44.6k), Hiddify, Ente Photos
+- **iOS** — TCA / Point-Free (14.4k), Clean Arch SwiftUI, Modern Clean Arch
+- **Android** — Now in Android (20.7k), Android Showcase, Mihon (18.8k)
 
 ### Mode 2: Adapt to Your Project (project)
 
@@ -47,8 +65,123 @@ Uses battle-tested patterns extracted from real production apps:
 Reads your current project first, then follows **your** conventions:
 - Detects framework, language, package manager, state management, navigation
 - Matches your naming, imports, file structure, patterns
+- Clones the most similar existing feature when scaffolding new ones
 - Never suggests migrations or imposes different architecture
 
+## Quick Start Examples
+
+### Step 1: Install the skill
+
+```bash
+# Install globally (one-time setup)
+npx @buivietphi/skill-mobile-mt
+```
+
+You'll see an interactive checkbox — use arrow keys to navigate, space to select, Enter to confirm:
+
+```
+  Select agents to install:
+  ↑↓ navigate   Space toggle   A select all   Enter confirm   Q cancel
+
+  › ◉ Claude Code   [detected]
+    ◯ Cursor         [detected]
+    ◯ Windsurf       [not found]
+    ◯ Copilot        [not found]
+    ◯ Codex          [not found]
+    ◉ Gemini CLI     [detected]
+    ◯ Kimi           [not found]
+    ◯ Antigravity    [not found]
+```
+
+### Step 2 (Cursor/Copilot/Windsurf only): Generate project rules
+
+```bash
+# cd into your mobile project first
+cd ~/projects/my-app
+
+# Generate rules for your agents
+npx @buivietphi/skill-mobile-mt --init all
+```
+
+Output:
+
+```
+  📁 Project directory: /Users/you/projects/my-app
+  🔍 Detected: Expo (React Native) (TypeScript)
+
+  ✓ .cursorrules → Cursor (auto-detected: Expo (React Native))
+  ✓ .github/copilot-instructions.md → GitHub Copilot
+  ✓ .windsurfrules → Windsurf
+
+  ✅ Done! → 3 file(s) generated
+```
+
+### Step 3: Use in your AI agent
+
+#### Claude Code
+
+```bash
+# In Claude Code terminal, type:
+@skill-mobile-mt
+
+# Then ask anything:
+> Create auth feature with login and register screens
+
+# Or with project mode (reads YOUR code first):
+@skill-mobile-mt project
+> Add cart feature following the same pattern as ProductList
+```
+
+#### Cursor
+
+After running `--init cursor`, Cursor auto-loads `.cursorrules` every session. Just open your project and code — Cursor follows the rules automatically.
+
+```
+# In Cursor Composer, just ask:
+> Create a login screen with email/password
+> Fix the crash in ProductDetail when images is null
+> Review this PR for mobile best practices
+```
+
+#### GitHub Copilot
+
+After running `--init copilot`, Copilot reads `.github/copilot-instructions.md` as workspace context.
+
+```
+# In VS Code with Copilot Chat:
+> Add pagination to the product list
+> Handle offline mode for the cart feature
+```
+
+#### Windsurf
+
+After running `--init windsurf`, Windsurf auto-loads `.windsurfrules`. Just code normally.
+
+#### Gemini CLI
+
+```bash
+# In Gemini CLI:
+@skill-mobile-mt
+> Setup a new Flutter project with Riverpod + clean architecture
+```
+
+#### Codex / Kimi / Antigravity
+
+Same as Claude Code — the skill is loaded from the skills directory.
+
+### Example Prompts (all agents)
+
+| What you want | What to type |
+|--------------|-------------|
+| New feature | `Create auth feature with login, register, forgot password` |
+| New screen | `Add settings screen with profile, notifications, theme toggle` |
+| Fix bug | `Fix crash when product.images is undefined` |
+| Code review | `Review src/features/cart/ for mobile best practices` |
+| Performance | `Optimize ProductList — it's janky when scrolling 100+ items` |
+| Architecture | `Setup project structure for a new Expo app with Zustand + TanStack Query` |
+| Release | `Prepare the app for App Store submission` |
+| Security | `Audit the auth flow for security vulnerabilities` |
+
 ## Auto-Detect
 
 The skill automatically detects before any action:
@@ -102,6 +235,7 @@ iOS only?
 | `shared/code-review.md` | 865 |
 | `shared/bug-detection.md` | 499 |
 | `shared/prompt-engineering.md` | 3,927 |
+| `shared/architecture-intelligence.md` | 4,500 |
 | `shared/common-pitfalls.md` | 1,160 |
 | `shared/error-recovery.md` | 2,435 |
 | `shared/document-analysis.md` | 1,200 |
@@ -111,36 +245,51 @@ iOS only?
 | `shared/platform-excellence.md` | 1,500 |
 | `shared/version-management.md` | 3,500 |
 | `shared/observability.md` | 3,000 |
-| **Total** | **~41,700** |
+| `shared/claude-md-template.md` | ~500 |
+| `shared/agent-rules-template.md` | ~2,500 |
+| **Total** | **~46,000** |
 
 ## Installed Structure
 
 ```
 ~/.claude/skills/               (or ~/.gemini/skills/, ~/.agents/skills/, etc.)
 └── skill-mobile-mt/
-    ├── SKILL.md                    Entry point + auto-detect
-    ├── AGENTS.md                   Multi-agent compatibility
+    ├── SKILL.md                       Entry point + auto-detect + quality gates
+    ├── AGENTS.md                      Multi-agent compatibility
     ├── react-native/
-    │   └── react-native.md         React Native patterns
+    │   └── react-native.md            React Native + Expo patterns
     ├── flutter/
-    │   └── flutter.md              Flutter patterns
+    │   └── flutter.md                 Flutter + Dart patterns
     ├── ios/
-    │   └── ios-native.md           iOS Swift patterns
+    │   └── ios-native.md              iOS Swift patterns
     ├── android/
-    │   └── android-native.md       Android Kotlin patterns
+    │   └── android-native.md          Android Kotlin patterns
     └── shared/
-        ├── code-review.md          Senior review checklist
-        ├── bug-detection.md        Auto bug scanner
-        ├── prompt-engineering.md   Intelligent prompt generation
-        ├── common-pitfalls.md      Problem → Symptoms → Solution
-        ├── error-recovery.md       Fix build/runtime errors
-        ├── document-analysis.md    Parse docs/images → code
-        ├── anti-patterns.md        PII, cardinality, payload detection
-        ├── performance-prediction.md  Predict FPS/memory BEFORE shipping
-        ├── platform-excellence.md  iOS 18+ vs Android 15+ guidelines
-        ├── version-management.md   SDK compatibility matrix + release testing
-        ├── observability.md        Sessions as 4th pillar, context-rich events
-        └── release-checklist.md    Pre-release verification
+        ├── code-review.md             Senior review checklist
+        ├── bug-detection.md           Auto bug scanner
+        ├── prompt-engineering.md      Auto-think + prompt templates
+        ├── architecture-intelligence.md  Patterns from 30+ production repos
+        ├── common-pitfalls.md         Problem → Symptoms → Solution
+        ├── error-recovery.md          16 build/runtime error fixes
+        ├── document-analysis.md       Parse docs/images → code
+        ├── anti-patterns.md           PII, cardinality, payload detection
+        ├── performance-prediction.md  Frame budget, FPS prediction
+        ├── platform-excellence.md     iOS 18+ vs Android 15+ guidelines
+        ├── version-management.md      SDK compatibility matrix
+        ├── observability.md           Sessions as 4th pillar
+        ├── release-checklist.md       Pre-release verification
+        ├── claude-md-template.md      CLAUDE.md template for projects
+        └── agent-rules-template.md    Rules templates for all agents
+```
+
+### Project-level files (generated by `--init`)
+
+```
+your-project/
+├── .cursorrules                       Cursor rules (auto-detected stack)
+├── .windsurfrules                     Windsurf rules (auto-detected stack)
+└── .github/
+    └── copilot-instructions.md        Copilot rules (auto-detected stack)
 ```
 
 ## What's Included
@@ -183,6 +332,10 @@ iOS only?
 - Requirements Extraction: user stories, screen flows, data models, business rules
 - Document → Code pipeline: read → extract → map features → scaffold
 
+### Architecture Intelligence (from 30+ production repos)
+
+- **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.
+
 ### Production Patterns (from Senaiverse, Mhuxain, VoltAgent, Nexus)
 
 - **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
@@ -208,16 +361,16 @@ iOS only?
 
 ## Supported Agents
 
-| Agent | Install Path | Status |
-|-------|-------------|--------|
-| Claude Code | `~/.claude/skills/skill-mobile-mt/` | Full support |
-| Codex | `~/.codex/skills/skill-mobile-mt/` | Full support |
-| Gemini CLI | `~/.gemini/skills/skill-mobile-mt/` | Full support |
-| Kimi | `~/.kimi/skills/skill-mobile-mt/` | Full support |
-| Cursor | `~/.cursor/skills/skill-mobile-mt/` | Full support |
-| Copilot | `~/.copilot/skills/skill-mobile-mt/` | Full support |
-| Windsurf | `~/.windsurf/skills/skill-mobile-mt/` | Full support |
-| Antigravity | `~/.agents/skills/skill-mobile-mt/` | Full support |
+| Agent | How it works | Setup command |
+|-------|-------------|---------------|
+| **Claude Code** | Reads from `~/.claude/skills/` | `npx skill-mobile-mt --claude` |
+| **Codex** | Reads from `~/.codex/skills/` | `npx skill-mobile-mt --codex` |
+| **Gemini CLI** | Reads from `~/.gemini/skills/` | `npx skill-mobile-mt --gemini` |
+| **Kimi** | Reads from `~/.kimi/skills/` | `npx skill-mobile-mt --kimi` |
+| **Antigravity** | Reads from `~/.agents/skills/` | `npx skill-mobile-mt --antigravity` |
+| **Cursor** | Reads `.cursorrules` from project root | `npx skill-mobile-mt --init cursor` |
+| **Copilot** | Reads `.github/copilot-instructions.md` | `npx skill-mobile-mt --init copilot` |
+| **Windsurf** | Reads `.windsurfrules` from project root | `npx skill-mobile-mt --init windsurf` |
 
 ## License
 

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.1.0"
+version: "1.2.0"
 author: buivietphi
 priority: high
 user-invocable: true

package/bin/install.mjs

@@ -14,9 +14,14 @@
  *   npx @buivietphi/skill-mobile --antigravity # Antigravity
  *   npx @buivietphi/skill-mobile --auto       # Auto-detect (postinstall)
  *   npx @buivietphi/skill-mobile --path DIR   # Custom path
+ *   npx @buivietphi/skill-mobile --init       # Generate project-level rules (interactive)
+ *   npx @buivietphi/skill-mobile --init cursor    # Generate .cursorrules
+ *   npx @buivietphi/skill-mobile --init copilot   # Generate .github/copilot-instructions.md
+ *   npx @buivietphi/skill-mobile --init windsurf  # Generate .windsurfrules
+ *   npx @buivietphi/skill-mobile --init all       # Generate all project-level files
  */
 
-import { existsSync, mkdirSync, cpSync, readFileSync } from 'node:fs';
+import { existsSync, mkdirSync, cpSync, readFileSync, writeFileSync } from 'node:fs';
 import { join, resolve, dirname } from 'node:path';
 import { homedir } from 'node:os';
 import { fileURLToPath } from 'node:url';
@@ -56,7 +61,7 @@ const fail = m => log(`  ${c.red}✗${c.reset} ${m}`);
 
 function banner() {
   log(`\n${c.bold}${c.cyan}  ┌──────────────────────────────────────────────┐`);
-  log(`  │  📱 @buivietphi/skill-mobile-mt v1.1.0       │`);
+  log(`  │  📱 @buivietphi/skill-mobile-mt v1.2.0       │`);
   log(`  │  Master Senior Mobile Engineer                │`);
   log(`  │                                              │`);
   log(`  │  Claude · Codex · Gemini · Kimi              │`);
@@ -113,6 +118,368 @@ function install(baseDir, agentName) {
   return n;
 }
 
+// ─── Project Auto-Detect ─────────────────────────────────────────────────────
+
+function detectProject(dir) {
+  const has = f => existsSync(join(dir, f));
+  const readJson = f => { try { return JSON.parse(readFileSync(join(dir, f), 'utf-8')); } catch { return null; } };
+
+  let framework = '[React Native CLI / Expo / Flutter / iOS / Android]';
+  let language  = '[TypeScript / Dart / Swift / Kotlin]';
+  let state     = '[Redux Toolkit / Zustand / Riverpod / BLoC / StateFlow]';
+  let nav       = '[React Navigation / Expo Router / GoRouter / UIKit / Jetpack]';
+  let api       = '[axios / fetch / Dio / Firebase / Retrofit]';
+  let pkgMgr    = '[yarn / npm / bun / flutter pub]';
+
+  // Detect framework + language
+  if (has('pubspec.yaml')) {
+    framework = 'Flutter'; language = 'Dart'; pkgMgr = 'flutter pub';
+  } else if (has('package.json')) {
+    const pkg = readJson('package.json');
+    const deps = { ...(pkg?.dependencies || {}), ...(pkg?.devDependencies || {}) };
+    if (deps['expo'])                  { framework = 'Expo (React Native)'; }
+    else if (deps['react-native'])     { framework = 'React Native CLI'; }
+    language = deps['typescript'] || has('tsconfig.json') ? 'TypeScript' : 'JavaScript';
+    // State
+    if (deps['@reduxjs/toolkit'] || deps['redux'])  state = 'Redux Toolkit';
+    else if (deps['zustand'])                        state = 'Zustand';
+    else if (deps['mobx-react-lite'] || deps['mobx'])state = 'MobX';
+    // Nav
+    if (deps['expo-router'])                         nav = 'Expo Router';
+    else if (deps['@react-navigation/native'])       nav = 'React Navigation';
+    // API
+    if (deps['axios'])                               api = 'axios';
+    else if (deps['@apollo/client'])                 api = 'GraphQL (Apollo)';
+    // Pkg manager
+    if (has('yarn.lock'))       pkgMgr = 'yarn';
+    else if (has('pnpm-lock.yaml')) pkgMgr = 'pnpm';
+    else if (has('bun.lockb'))  pkgMgr = 'bun';
+    else                        pkgMgr = 'npm';
+  } else if (has('build.gradle') || has('build.gradle.kts')) {
+    framework = 'Android Native'; language = 'Kotlin'; pkgMgr = 'Gradle';
+  }
+  // iOS detection (*.xcodeproj) is harder — leave as placeholder
+
+  return { framework, language, state, nav, api, pkgMgr };
+}
+
+// ─── Project-Level File Templates ────────────────────────────────────────────
+
+const PROJECT_AGENTS = {
+  cursor: {
+    name: 'Cursor',
+    file: '.cursorrules',
+    dir:  '.',
+    generate: (p) => `# ${p.framework} Project — Cursor Rules
+# Generated by @buivietphi/skill-mobile-mt
+
+## Project
+- Framework: ${p.framework}
+- Language: ${p.language}
+- State: ${p.state}
+- Navigation: ${p.nav}
+- API: ${p.api}
+- Package Manager: ${p.pkgMgr}
+
+## Code Style
+- PascalCase for screens and components
+- camelCase for hooks, services, utils
+- Absolute imports with @/ alias (if configured)
+
+## Auto-Check (before every completion)
+- No console.log / print in production code
+- No hardcoded secrets or API keys
+- All async wrapped in try/catch
+- All 4 states: loading / error / empty / success
+- useEffect has cleanup (return () => ...)
+- FlatList (not ScrollView) for dynamic lists > 20 items
+- No implicit 'any' in TypeScript
+- No force unwrap (! / !!) without null check
+- New screens registered in navigator
+
+## Performance
+- React.memo / const widget for expensive components
+- useMemo/useCallback for stable references
+- Images cached and resized
+- No main thread blocking
+
+## Security (non-negotiable)
+- Tokens → SecureStore / Keychain / EncryptedSharedPreferences
+- API calls → HTTPS only
+- Sensitive data → never in logs
+- User input → sanitize before display
+- Deep links → validate before navigation
+
+## Never
+- Change framework or architecture
+- Change state management library
+- Add packages without checking SDK compatibility
+- Mix package managers
+- Use ScrollView for long lists
+- Leave empty catch blocks
+- Store tokens in AsyncStorage / SharedPreferences / UserDefaults
+
+## Architecture
+- Dependencies flow inward: UI → Domain → Data
+- Single responsibility per file (max 300 lines)
+- Feature-based organization preferred
+
+## Reference
+- Full skill: ~/.cursor/skills/skill-mobile-mt/
+- Patterns from 30+ production repos (200k+ GitHub stars)
+`,
+  },
+
+  copilot: {
+    name: 'GitHub Copilot',
+    file: 'copilot-instructions.md',
+    dir:  '.github',
+    generate: (p) => `# Copilot Instructions — ${p.framework} Project
+
+> Generated by @buivietphi/skill-mobile-mt
+
+## Project Context
+- **Framework:** ${p.framework}
+- **Language:** ${p.language}
+- **State Management:** ${p.state}
+- **Navigation:** ${p.nav}
+- **API:** ${p.api}
+- **Package Manager:** ${p.pkgMgr}
+
+## Conventions
+- PascalCase: components, screens, classes
+- camelCase: hooks, services, utilities, variables
+- Files named same as their default export
+
+## Required Patterns
+
+### Every async function
+\`\`\`typescript
+try {
+  setLoading(true);
+  const result = await apiCall();
+  setData(result);
+} catch (error) {
+  setError(error.message);
+} finally {
+  setLoading(false);
+}
+\`\`\`
+
+### Every screen must handle 4 states
+\`\`\`typescript
+if (loading) return <LoadingScreen />;
+if (error) return <ErrorScreen error={error} />;
+if (!data?.length) return <EmptyScreen />;
+return <DataScreen data={data} />;
+\`\`\`
+
+### Every useEffect with subscriptions
+\`\`\`typescript
+useEffect(() => {
+  const sub = subscribe();
+  return () => sub.unsubscribe(); // REQUIRED
+}, []);
+\`\`\`
+
+## Rules
+- No console.log / print in production
+- No hardcoded secrets or API keys
+- FlatList (not ScrollView) for dynamic lists
+- Tokens in SecureStore / Keychain only
+- No force unwrap (! / !!) without null check
+- No implicit 'any' in TypeScript
+- No empty catch blocks
+- No inline functions in render/build
+- Images cached and resized
+- New screens registered in navigator
+
+## Security
+- Tokens → SecureStore / Keychain / EncryptedSharedPreferences
+- API calls → HTTPS only
+- Sensitive data → never in logs
+- User input → sanitize before rendering
+- Deep links → validate before navigation
+
+## Never
+- Suggest migrating to a different framework
+- Change state management library
+- Add packages without checking SDK compatibility
+- Mix package managers (yarn + npm)
+- Use ScrollView for lists > 20 items
+- Store tokens in AsyncStorage / SharedPreferences / UserDefaults
+
+## Architecture
+- Clean Architecture: UI → Domain → Data
+- Single responsibility per file (max 300 lines)
+- Feature-based organization preferred
+
+## Reference
+Full skill with patterns from 30+ production repos: ~/.copilot/skills/skill-mobile-mt/
+`,
+  },
+
+  windsurf: {
+    name: 'Windsurf',
+    file: '.windsurfrules',
+    dir:  '.',
+    generate: (p) => `# ${p.framework} Project — Windsurf Rules
+# Generated by @buivietphi/skill-mobile-mt
+
+Project: ${p.framework}
+Language: ${p.language}
+State management: ${p.state}
+Navigation: ${p.nav}
+API: ${p.api}
+Package manager: ${p.pkgMgr}
+
+## Coding Rules
+
+Always:
+- Wrap all async operations in try/catch
+- Handle all 4 states: loading, error, empty, success
+- Add cleanup to useEffect (return () => ...)
+- Use FlatList for dynamic lists (not ScrollView)
+- Use PascalCase for components and screens
+- Use camelCase for hooks, services, and utilities
+- No implicit 'any' in TypeScript
+- No force unwrap (! / !!) without null check
+- New screens registered in navigator
+- React.memo / const widget for expensive components
+- Images cached and resized
+
+Never:
+- Leave console.log / print in production code
+- Hardcode secrets, tokens, or API keys
+- Store tokens in AsyncStorage / SharedPreferences / UserDefaults
+- Change the framework or architecture
+- Change state management library
+- Add packages without verifying SDK compatibility
+- Mix yarn and npm
+- Use ScrollView for lists > 20 items
+- Leave empty catch blocks
+- Use index as list key
+
+## Security (non-negotiable)
+- Tokens → SecureStore / Keychain / EncryptedSharedPreferences
+- API calls → HTTPS only
+- Sensitive data → never in logs
+- User input → sanitize before display
+- Deep links → validate before navigation
+
+## Architecture
+- Clean Architecture: UI → Domain → Data
+- Single responsibility per file (max 300 lines)
+- Feature-based organization preferred
+
+## Reference
+Full skill: ~/.windsurf/skills/skill-mobile-mt/
+Patterns from 30+ production repos (200k+ GitHub stars)
+`,
+  },
+};
+
+// Agents that need project-level files (don't just read from skills dir)
+const NEEDS_PROJECT_FILE = new Set(['cursor', 'copilot', 'windsurf']);
+
+function initProjectFiles(dir, agents) {
+  const project = detectProject(dir);
+  let created = 0;
+
+  for (const key of agents) {
+    const agent = PROJECT_AGENTS[key];
+    if (!agent) continue;
+
+    const targetDir = join(dir, agent.dir);
+    const targetFile = join(targetDir, agent.file);
+
+    if (existsSync(targetFile)) {
+      info(`${c.yellow}${agent.file}${c.reset} already exists — skipped (won't overwrite)`);
+      continue;
+    }
+
+    mkdirSync(targetDir, { recursive: true });
+    writeFileSync(targetFile, agent.generate(project), 'utf-8');
+    ok(`${c.bold}${join(agent.dir, agent.file)}${c.reset} → ${agent.name} ${c.dim}(auto-detected: ${project.framework})${c.reset}`);
+    created++;
+  }
+
+  return created;
+}
+
+async function selectProjectAgents() {
+  if (!process.stdin.isTTY) return Object.keys(PROJECT_AGENTS);
+
+  const keys    = Object.keys(PROJECT_AGENTS);
+  const selected = new Set(keys); // all selected by default
+  let cursor    = 0;
+
+  const UP       = '\x1b[A';
+  const DOWN     = '\x1b[B';
+  const ERASE_DN = '\x1b[J';
+  const HIDE_CUR = '\x1b[?25l';
+  const SHOW_CUR = '\x1b[?25h';
+  const moveUp   = n => `\x1b[${n}A`;
+  const TOTAL_LINES = 3 + keys.length;
+
+  function render(first) {
+    if (!first) process.stdout.write(moveUp(TOTAL_LINES) + ERASE_DN);
+    process.stdout.write(`\n${c.bold}  Select project-level files to generate:${c.reset}\n`);
+    process.stdout.write(`  ${c.dim}↑↓ navigate   Space toggle   A select all   Enter confirm   Q cancel${c.reset}\n`);
+
+    for (let i = 0; i < keys.length; i++) {
+      const k     = keys[i];
+      const agent = PROJECT_AGENTS[k];
+      const isCur = i === cursor;
+      const isSel = selected.has(k);
+
+      const ptr   = isCur ? `${c.cyan}›${c.reset}` : ' ';
+      const box   = isSel ? `${c.green}◉${c.reset}` : `${c.dim}◯${c.reset}`;
+      const name  = isCur ? `${c.bold}${c.cyan}${agent.name}${c.reset}` : agent.name;
+      const file  = `${c.dim}→ ${join(agent.dir, agent.file)}${c.reset}`;
+
+      process.stdout.write(`  ${ptr} ${box} ${name.padEnd(20)}${file}\n`);
+    }
+  }
+
+  process.stdout.write(HIDE_CUR);
+  render(true);
+
+  return new Promise(resolve => {
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.setEncoding('utf8');
+
+    const onKey = key => {
+      const done = result => {
+        process.stdin.setRawMode(false);
+        process.stdin.pause();
+        process.stdin.off('data', onKey);
+        process.stdout.write(SHOW_CUR + '\n');
+        resolve(result);
+      };
+
+      if (key === '\x03') { done(null); process.exit(0); }
+      if (key === 'q' || key === 'Q' || key === '\x1b') { done([]); return; }
+      if (key === '\r' || key === '\n') { done([...selected]); return; }
+
+      if (key === UP)    cursor = (cursor - 1 + keys.length) % keys.length;
+      else if (key === DOWN) cursor = (cursor + 1) % keys.length;
+      else if (key === ' ') {
+        if (selected.has(keys[cursor])) selected.delete(keys[cursor]);
+        else selected.add(keys[cursor]);
+      } else if (key === 'a' || key === 'A') {
+        if (selected.size === keys.length) selected.clear();
+        else keys.forEach(k => selected.add(k));
+      }
+
+      render(false);
+    };
+
+    process.stdin.on('data', onKey);
+  });
+}
+
 // ─── Checkbox UI ─────────────────────────────────────────────────────────────
 
 async function selectAgents(detected) {
@@ -201,6 +568,56 @@ async function main() {
   const flags = new Set(args.map(a => a.replace(/^--?/, '')));
 
   banner();
+
+  // ─── --init mode: generate project-level files ─────────────────────────────
+  if (flags.has('init')) {
+    const cwd = process.cwd();
+    log(`${c.bold}  📁 Project directory:${c.reset} ${c.dim}${cwd}${c.reset}`);
+
+    const project = detectProject(cwd);
+    log(`${c.bold}  🔍 Detected:${c.reset} ${c.cyan}${project.framework}${c.reset} (${project.language})\n`);
+
+    // Determine which agents to init
+    let initTargets = [];
+    const initIdx = args.indexOf('--init');
+    const initArg = args[initIdx + 1];
+
+    if (initArg === 'all') {
+      initTargets = Object.keys(PROJECT_AGENTS);
+    } else if (initArg && PROJECT_AGENTS[initArg]) {
+      initTargets = [initArg];
+    } else if (initArg && !initArg.startsWith('-')) {
+      fail(`Unknown agent: ${initArg}. Available: ${Object.keys(PROJECT_AGENTS).join(', ')}, all`);
+      process.exit(1);
+    } else {
+      // Interactive selection
+      const chosen = await selectProjectAgents();
+      if (!chosen || chosen.length === 0) { info('Cancelled.'); return; }
+      initTargets = chosen;
+    }
+
+    log(`\n${c.bold}  Generating project-level rules...${c.reset}\n`);
+    const n = initProjectFiles(cwd, initTargets);
+
+    if (n > 0) {
+      log(`\n${c.green}${c.bold}  ✅ Done!${c.reset} → ${n} file(s) generated\n`);
+      log(`  ${c.bold}Generated files:${c.reset}`);
+      for (const k of initTargets) {
+        const agent = PROJECT_AGENTS[k];
+        if (agent) {
+          const fp = join(agent.dir, agent.file);
+          log(`    ${c.green}●${c.reset} ${agent.name.padEnd(18)} ${c.dim}${fp}${c.reset}`);
+        }
+      }
+      log(`\n  ${c.dim}Files are auto-detected for ${project.framework}.`);
+      log(`  Edit the generated files to customize for your project.${c.reset}\n`);
+    } else {
+      info('No files generated (all already exist).\n');
+    }
+    return;
+  }
+
+  // ─── Normal install mode ───────────────────────────────────────────────────
   showContext();
 
   let targets = [];
@@ -237,13 +654,28 @@ async function main() {
 
   log(`\n${c.green}${c.bold}  ✅ Done!${c.reset} → ${targets.length} agent(s)\n`);
   log(`  ${c.bold}Usage:${c.reset}`);
-  log(`    ${c.cyan}@skill-mobile-mt${c.reset}         Pre-built patterns (18 production apps)`);
+  log(`    ${c.cyan}@skill-mobile-mt${c.reset}         Pre-built patterns (30+ production repos)`);
   log(`    ${c.cyan}@skill-mobile-mt project${c.reset} Read current project, adapt to it\n`);
   log(`  ${c.bold}Installed to:${c.reset}`);
   for (const k of targets) {
     log(`    ${c.green}●${c.reset} ${AGENTS[k].name.padEnd(14)} ${c.dim}${AGENTS[k].dir}/${SKILL_NAME}${c.reset}`);
   }
-  log('');
+
+  // Show tip for agents that need project-level files
+  const needsInit = targets.filter(k => NEEDS_PROJECT_FILE.has(k));
+  if (needsInit.length > 0) {
+    const names = needsInit.map(k => AGENTS[k].name).join(', ');
+    log('');
+    log(`  ${c.yellow}${c.bold}💡 Important:${c.reset} ${names} read rules from ${c.bold}project-level files${c.reset},`);
+    log(`     not from the skills directory. Run this in your project root:`);
+    log('');
+    log(`     ${c.cyan}npx @buivietphi/skill-mobile-mt --init${c.reset}`);
+    log('');
+    log(`     This generates ${c.bold}.cursorrules${c.reset}, ${c.bold}.windsurfrules${c.reset}, ${c.bold}.github/copilot-instructions.md${c.reset}`);
+    log(`     with auto-detected project settings.\n`);
+  } else {
+    log('');
+  }
 }
 
 main().catch(e => { fail(e.message); process.exit(1); });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buivietphi/skill-mobile-mt",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "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.",
   "author": "buivietphi",
   "license": "MIT",
@@ -38,7 +38,12 @@
     "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"
+    "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"