@leejungkiin/awkit 1.6.6 → 1.7.0

package/skills/awf-caveman/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: awf-caveman
+description: >-
+  Ultra-compressed communication mode. Cuts token usage ~75% by speaking like caveman.
+  Checks `.project-identity` for `communication.cavemanMode.enabled`. 
+  Supports both Vietnamese and English.
+version: 1.0.0
+---
+
+# AWF Caveman Mode
+
+Chế độ giao tiếp siêu nén (Ultra-compressed communication mode).
+Tự động kích hoạt dựa trên cấu hình `.project-identity` của dự án hiện tại.
+
+## Trigger Conditions
+
+**Pre-hook for ALL workflows** - Activates at session start.
+
+**Check Configuration:**
+```python
+config = read(".project-identity")
+if config?.communication?.cavemanMode?.enabled == true:
+    level = config.communication.cavemanMode.level || "full"
+    # Activate Caveman Mode with `level`
+```
+
+## Rules (Quy tắc "Người Tối Cổ")
+
+Áp dụng cho mọi phản hồi của AI (cả Tiếng Việt và Tiếng Anh). Mọi hàm lượng kỹ thuật phải giữ nguyên, CHỈ lược bỏ từ thừa.
+
+1. **BỎ TỪ ĐỆM**: Bỏ mọi từ thừa, từ lịch sự ("Vâng", "Dạ", "Chắc chắn rồi", "Theo tôi thấy thì...", "Tôi hiểu ý anh...").
+2. **NÓI CỤT LỦN**: Đi thẳng vào vấn đề. Bắt đầu ngay bằng nguyên nhân lỗi hoặc hành động. Dùng câu mảnh (fragments).
+3. **KHÔNG GIẢI THÍCH DÀI DÒNG**: Dùng mũi tên `->` để chỉ nguyên nhân/kết quả.
+4. **GIỮ NGUYÊN TỪ KHÓA KỸ THUẬT**: Tên biến, tên file, code blocks, API names PHẢI CHÍNH XÁC. Không viết tắt từ khóa kỹ thuật.
+
+## Intensity Levels (Mức độ)
+
+| Level | Tiếng Anh | Tiếng Việt |
+|-------|-----------|------------|
+| **lite** | No filler. Professional but tight. | Bỏ từ lịch sự, chào hỏi. Giữ câu hoàn chỉnh, chuyên nghiệp nhưng súc tích. |
+| **full** | Drop articles, fragments OK, short synonyms. | Nói cụt lủn, bỏ chủ ngữ. Bắt đầu ngay vào hành động. (VD: "Lỗi do X. Cần sửa Y.") |
+| **ultra** | Abbreviate prose words, arrows for causality (X → Y). | Dùng ký hiệu mũi tên. Cực kỳ ngắn. (VD: "Lỗi auth → sửa dòng 5 → xong.") |
+
+### Examples
+
+**Câu hỏi: Tại sao component React này lại re-render liên tục?**
+
+- **Normal**: "Nguyên nhân khiến component của anh bị re-render liên tục là do anh đang tạo một object mới trong mỗi chu kỳ render. Vì vậy, React hiểu đó là một reference mới. Anh nên bọc nó trong useMemo nhé."
+- **lite**: "Component re-render do tạo object mới mỗi lần render. Bọc object trong `useMemo`."
+- **full**: "Object mới mỗi lần render. Gây re-render. Dùng `useMemo`."
+- **ultra**: "Object mới mỗi render → re-render liên tục. `useMemo`."
+
+## Auto-Clarity (Tạm dừng khi cần thiết)
+
+Tạm thời ngưng Caveman (trở lại bình thường) khi:
+- Cảnh báo bảo mật quan trọng (Security warnings).
+- Hành động không thể hoàn tác (Xóa DB, git reset --hard).
+- Các bước hướng dẫn quá phức tạp dễ gây hiểu nhầm nếu nói tắt.
+- Chữa cháy / Giải thích lỗi quá lắt léo cần rõ nghĩa.
+
+Sau khi giải thích rõ, tự động quay lại Caveman.
+
+## Integration
+
+Skill này chạy ngầm và override communication style của hệ thống nếu được cấu hình `enabled: true` trong `.project-identity`.

package/skills/expo-build-optimizer/SKILL.md

@@ -0,0 +1,33 @@
+---
+name: expo-build-optimizer
+description: Use when building Expo applications, tracking EAS build counts, optimizing free tier limits, or creating production APKs/IPAs.
+---
+
+# Expo Build Optimizer
+
+## Overview
+This skill enforces best practices and limits for Expo Free Tier development. It prevents exhausting the 30 EAS build limit per month by promoting local builds, Expo Go testing, and tracking usage. 
+
+## When to Use
+- When the user asks to build an Expo app (`eas build`).
+- When checking Expo infrastructure limits.
+- When there's a need to create an APK/IPA.
+
+## Core Pattern
+1. **Always check limits first:** Read `expo.builds` from `.project-identity` before running `eas build`.
+2. **Prioritize Expo Go:** For normal feature development, recommend Expo Go.
+3. **Use Local Build:** Suggest `eas build --local` as the primary alternative to server builds to save quotas.
+4. **Track Usage:** Every time an `eas build` (non-local) is performed, increment the `usedThisMonth` counter in `.project-identity`.
+5. **EAS Updates:** Use updates sparingly to stay under the 1,000 MAU and 100 GB bandwidth limit.
+
+## Quick Reference
+- **Local Build Android:** `eas build -p android --profile production --local`
+- **Local Build iOS:** `eas build -p ios --profile production --local` (Requires macOS)
+- **Check Limits:** Check `.project-identity` `expo.builds` section.
+
+## Implementation Steps
+1. Before running `eas build`, read `.project-identity`. Check if `expo.builds.usedThisMonth` < `expo.builds.limit` (usually 30).
+2. If close to the limit (e.g., >25), warn the user and explicitly suggest `--local`.
+3. If the user insists on a remote build and is under the limit, run the build and then increment the count in `.project-identity`.
+4. If building for simple UI/Logic testing, remind the user about Expo Go.
+5. Emphasize that remote builds have a "Priority: Low" queue in the free tier, which might take hours during peak times, making `--local` the superior choice when hardware permits.

package/skills/ios-app-store-audit/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: ios-app-store-audit
+description: "Chuyên gia kiểm định iOS App trước khi nộp lên App Store. Quét mã nguồn, Info.plist, IAP, và UI để phát hiện sớm các vi phạm Apple Guideline."
+version: 1.0.0
+trigger: conditional
+activation_keywords:
+  - "/ios-app-store-audit"
+  - "/apple-review"
+  - "kiểm tra app store"
+  - "kiểm tra trước khi submit ios"
+  - "preflight ios"
+---
+
+# 🍏 iOS App Store Audit (Pre-flight Checklist)
+
+**Mục đích**: Đóng vai trò là Reviewer của Apple, skill này sẽ quét toàn bộ dự án iOS để chỉ ra những vi phạm có nguy cơ reject cao trước khi Submit.
+
+## 🛠 Hướng dẫn thực thi (Checklist)
+
+Khi được gọi, AI phải kiểm tra lần lượt các hạng mục sau trong codebase iOS:
+
+### 1. Guideline 5.1 & 2.1 - Privacy & App Tracking (ATT)
+- **Kiểm tra file Info.plist**: Tìm `NSUserTrackingUsageDescription`. Nếu có, yêu cầu nội dung phải chi tiết, ví dụ: *"This identifier will be used to deliver personalized ads to you."*
+- **Kiểm tra Code**: Tìm `ATTrackingManager.requestTrackingAuthorization`. Đảm bảo nó được chạy ở thời điểm phù hợp (vd: sau màn hình Onboarding), không gọi quá sớm khi giao diện chưa kịp render.
+- **Purpose Strings khác**: Các chuỗi `NSPhotoLibraryUsageDescription`, `NSCameraUsageDescription` phải mô tả ĐÚNG MỤC ĐÍCH và VÍ DỤ ("We need camera access to let you scan the QR code"). Tuyệt đối cấm các string hời hợt như "App needs camera".
+
+### 2. Guideline 1.4.1 - Health & Medical Safety
+Dành cho app Y Tế / Sức khoẻ:
+- **Medical Disclaimer**: Yêu cầu phải có dòng chữ *"Vui lòng tham khảo ý kiến bác sĩ trước khi đưa ra bất kỳ quyết định y tế nào"* trong giao diện (hoặc ở App Store Description).
+- **Citations**: Những nội dung nội bộ hoặc do AI tư vấn sức khỏe phải đi kèm trích dẫn (References / Sources).
+- **Video Physical Device**: Nhắc nhở người dùng phải tự quay bằng video máy thật với luồng đo sức khoẻ để đính kèm App Review Notes.
+
+### 3. Guideline 3.1 & 2.1 - Subscriptions & IAP
+- Nhắc nhở User: "Bạn đã đính kèm In-App Purchases cùng với bản Build khi Submit chưa?"
+- Yêu cầu kiểm tra màn hình bán hàng (Premium/Paywall) phải bao gồm: 
+  - Nút **Restore Purchases**
+  - Link **Terms of Use (EULA)**
+  - Link **Privacy Policy**
+
+### 4. Guideline 4.0 - Design (iPad Compatibility)
+- Quét mã nguồn UI (SwiftUI views): Cảnh báo nếu sử dụng `.frame(width: UIScreen.main.bounds.width)`, vì nó gây rách layout trên iPad.
+- Đề xuất giải pháp an toàn như `.frame(maxWidth: .infinity)` hoặc sử dụng `NavigationSplitView`.
+
+### 5. Fake Reviewer State
+- AI nhắc nhở User test kịch bản "Fresh Install" bằng cách khôi phục cài đặt gốc của App trước khi build nộp lại, vì Reviewer luôn test trên một máy hoàn toàn trắng.
+
+## 📥 Báo cáo
+In ra một báo cáo MarkDown gồm 🔴 (Lỗi Cần Sửa Gấp) và 🟡 (Cảnh Báo Cần Chú Ý), sau đó gợi ý người dùng cách chỉnh sửa từng mục.

package/skills/ios-expert-coder/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: ios-expert-coder
+description: "Chuyên gia Lập trình iOS & Pháp chế Apple. Kích hoạt ngầm khi phát hiện dev app iOS để đảm bảo tuân thủ App Store Guidelines từ khâu thiết kế."
+version: 1.0.0
+trigger: auto
+activation_keywords:
+  - "code ios"
+  - "swiftui"
+  - "lập trình ios"
+  - "code app ios"
+  - "xcode"
+---
+
+# 🛡️ iOS Guardian & Expert Coder
+
+**Mục đích**: Skill này sẽ kích hoạt tự động làm "tấm khiên" cho Antigravity khi phát hiện người dùng đang lập trình giao diện hoặc tính năng cho hệ điều hành iOS. Không đợi User yêu cầu, AI luôn phải thiết lập ngay vào source code các thành phần tuân thủ chuẩn Apple.
+
+## 📜 Các Luật Ngầm Bắt Buộc Khi Lập Trình iOS
+
+Khi đang tham gia vào quy trình lập trình cho iOS UI/Tính năng, AI PHẢI tuân thủ các quy định sau:
+
+### 1. Nguyên Tắc Thiết Kế Layout (iPad Safe)
+- **KHÔNG BAO GIỜ** sử dụng độ dài tĩnh màn hình cố định như `UIScreen.main.bounds.width`.
+- Sử dụng Constraint linh hoạt qua `.frame(maxWidth: .infinity)`.
+- Trên iPadOS: Luôn chú ý `.navigationViewStyle(.stack)` (nếu không dùng `NavigationSplitView`) để tránh màn hình chia đôi rỗng tuếch.
+
+### 2. Các Strings Xin Quyền (Info.plist Security)
+- Bất cứ khi nào cập nhật luồng dùng phần cứng (Camera, Mic, GPS, Photo Library), AI TỰ ĐỘNG yêu cầu cập nhật `Info.plist`.
+- AI phải tạo một câu giải thích tại sao xin quyền một cách chi tiết có kèm ví dụ cụ thể thay vì nội dung sáo rỗng. (Ví dụ chuẩn: *"We need access to your photo library to let you select a profile picture for your account."*).
+
+### 3. Medical & Health Protocol (Chống reject 1.4.1)
+- Nếu App liên quan đến sức khoẻ (Health, Glucose, Blood Pressure, Trackers):
+  - Tự động gợi ý thêm Disclaimer Y tế (Text Disclaimer: Please consult a physician before making medical decisions) ngay bên dưới các biểu đồ máu hoặc AI Chat tư vấn.
+
+### 4. Giao diện Bán Hàng In-App Purchases (Chống reject 3.1.2)
+- Khi thi công màn hình `PaywallView` / `PremiumView`, TỰ ĐỘNG thiết kế UI có đủ 3 hành động MANG TÍNH PHÁP LÝ BẮT BUỘC:
+  1. Nút `Restore Purchases`
+  2. Nút nhỏ để mở `EULA (Terms of Use)`
+  3. Nút nhỏ để mở `Privacy Policy`
+
+### 5. Khóa Luồng Xin Quyền Theo Dõi (ATT Prompt Lifecycle)
+- Luôn luôn đặt việc request `ATTrackingManager.requestTrackingAuthorization` về sau luồng Onboarding. Không được phép gọi ở ngay trạng thái chưa init xong màn hình đầu tiên.
+
+## ⚙️ Hành động
+AI chủ động rà soát tư duy trong mỗi lượt code, báo ngay cho user nếu phát hiện user muốn tạo ra một chức năng vi phạm 5 luật kể trên.

package/skills/marketing-spec-writer/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: marketing-spec-writer
+description: |
+  Đóng vai trò là Giám đốc Marketing (CMO) của dự án. AI tự động quét codebase, đọc project identity
+  và dịch các tính năng kỹ thuật khô khan thành tài liệu Marketing Spec (Value Props, ASO, Campaign Briefs).
+  Cung cấp đầu vào cực chuẩn (Prompt Ready) để đưa cho các AI Agent khác như `short-maker` làm video quảng cáo.
+metadata:
+  stage: workflow
+  version: "1.0"
+  tags: [marketing, aso, spec, content, ads, brief, strategy]
+trigger: explicit
+activation_keywords:
+  - "/marketing"
+  - "/marketing-spec"
+  - "viết tài liệu marketing"
+  - "tạo spec quảng cáo"
+---
+
+# 📈 Marketing Spec Writer (CMO Mode)
+
+> **Mục tiêu**: Biến Codebase kỹ thuật thành "Vàng Marketing". Skill này chuẩn bị toàn bộ "đạn dược" (Asset Briefs, ASO, USP) để cung cấp cho các AI Agent khác (như `short-maker` làm video, hoặc AI viết bài PR) thao tác tự động.
+
+## 🚀 Quy trình hoạt động
+
+### Bước 1: Thu thập Context Kỹ Thuật
+- Đọc file `.project-identity` và `CODEBASE.md` để hiểu "Linh hồn" và tính năng chính của App.
+- (Tùy chọn) Dùng `gitnexus_query` tìm các tính năng cốt lõi hoặc các module vừa được push code gần đây nếu làm Release Marketing.
+
+### Bước 2: Dịch Thuật Kỹ Thuật -> Lợi Ích (Tech-to-Value)
+- Phân tích và chuyển đổi các Specs kỹ thuật (ví dụ: *Offline First SQLite*, *End-to-End Encryption*, *50fps Rendering*) thành User Benefits (ví dụ: *Use Anywhere, Even in the Woods*, *Your Secrets are Safe*, *Silky Smooth Experience*).
+
+### Bước 3: Phân rã theo định dạng (Marketing Spec Generation)
+Tạo file `docs/MARKETING_SPEC.md` theo template chuẩn bao gồm các phần:
+1.  **Product Core Identity**: Sứ mệnh, Đối tượng mục tiêu (Persona), Tone of Voice.
+2.  **App Store Optimization (ASO)**: Đề xuất Tiêu đề, Subtitle, Keywords, Description.
+3.  **Unique Selling Propositions (USPs)**: 3-5 điểm ăn tiền nhất.
+4.  **Campaign Angles (Góc nhìn truyền thông)**: Các kịch bản đánh vào cảm xúc (Nỗi đau - Giải pháp, hoặc Khát vọng).
+5.  **AI Video Prompt (BẮT BUỘC)**: Đóng gói sẵn 1 đoạn Text để User **chỉ việc Copy-Paste vào lệnh `/short` hoặc `short-maker`** để ra lệnh làm video.
+
+### Bước 4: Review & Chốt Hướng Đi
+- Trình bày tóm tắt cho User duyệt.
+- Nếu User duyệt, hướng dẫn cách sử dụng đoạn prompt đã gen để đẩy sang quy trình Video Marketing (`short-maker`).
+
+## 🔗 Liên kết hệ sinh thái (Agent Hand-off)
+Tài liệu sinh ra từ skill này được thiết kế ĐẶC BIỆT để làm mồi (Input) cho các tools khác:
+- **`short-maker` (Video Ads)**: Sử dụng phần Campaign Angles và Persona để xây dựng Character và kịch bản AIDA chính xác nhất.
+- **`blitz-macos` (Store Upload)**: Copy phần ASO để dán tự động lên App Store Connect.
+
+## ⚠️ Lưu ý cho AI
+- TUYỆT ĐỐI không dùng ngôn ngữ máy móc kiểu "App này dùng React Native...". Hãy dùng ngôn ngữ bán hàng, thuyết phục, đánh vào cảm xúc người dùng cuối (End-user).
+- Hãy áp dụng các Framework Marketing chuẩn: AIDA (Attention - Interest - Desire - Action) hoặc PAS (Problem - Agitate - Solve).

package/skills/marketing-spec-writer/templates/MARKETING_SPEC.md

@@ -0,0 +1,53 @@
+# 📈 Marketing Spec: {{APP_NAME}}
+
+> Tự động tạo bởi `marketing-spec-writer` 
+> Ngày: {{DATE}} | Phiên bản: {{VERSION}}
+
+## 1. Bản sắc Cốt lõi (Product Soul)
+- **Sứ mệnh**: [App này tồn tại để giải quyết vấn đề gì, mang lại niềm vui gì?]
+- **Tone of Voice**: [Chuyên nghiệp/Hài hước/Đồng cảm/Tạo động lực...]
+- **Khách hàng Mục tiêu (Persona)**: 
+  - *Bề mặt*: [Ví dụ: Dân văn phòng 25-35 tuổi]
+  - *Nỗi đau (Pain Point)*: [Họ đang gặp rắc rối gì hàng ngày?]
+  - *Khát vọng (Desire)*: [Họ muốn đạt được trạng thái nào?]
+
+## 2. Điểm Bán Hàng Độc Nhất (USPs - Tech to Value)
+*(Dịch từ Codebase sang Lợi ích)*
+1. **[Tên USP 1]**: (Tech: *[Tech Note]*) -> Value: *[Người dùng nhận được gì?]*
+2. **[Tên USP 2]**: (Tech: *[Tech Note]*) -> Value: *[Tại sao nó tuyệt vời?]*
+3. **[Tên USP 3]**: (Tech: *[Tech Note]*) -> Value: *[Điều này đánh bại đối thủ như thế nào?]*
+
+## 3. Tối ưu Kho Ứng dụng (ASO Meta)
+*(Dùng để đẩy lên App Store / Google Play)*
+- **Title (Tối đa 30 ký tự)**: [Chứa Keyword chính]
+- **Subtitle (Tối đa 30 ký tự)**: [Định vị ngắn gọn]
+- **Keywords (Dấu phẩy)**: [word1, word2, word3...]
+- **Promotional Text**: [Câu slogan ăn tiền nhất]
+- **Description Hook**:
+  > *[Câu mở đầu giật gân, ví dụ: "Bạn đã chán ngấy việc...?"]*
+
+## 4. Kịch bản Truyền thông (Campaign Angles)
+*(Góc nhìn để chạy quảng cáo Facebook/TikTok)*
+
+### Angle 1: Đánh vào nỗi sợ / sự bất tiện (Pain-driven)
+- **Mở bài**: Bạn đang tốn quá nhiều thời gian cho X?
+- **Giải pháp**: Với {{APP_NAME}}, X được giải quyết trong 1 nốt nhạc nhờ [USP 1].
+
+### Angle 2: Bán kết quả / Ước mơ (Desire-driven)
+- **Mở bài**: Trở thành phiên bản tốt nhất của bạn với...
+- **Giải pháp**: Sở hữu [Kết quả lý tưởng] mà không cần [Trở ngại].
+
+---
+
+## 🤖 [Handoff] Short-Maker Ready Prompt
+*(Bạn có thể copy nội dung dưới đây và dán cho `short-maker` hoặc gọi `/short`)*
+
+```text
+/short
+
+Tên App: {{APP_NAME}}
+Thông điệp chính: [Chọn 1 Angle ở trên]
+Tone: [Tone of Voice]
+Nhân vật: [Mô tả Persona lý tưởng làm diễn viên, ví dụ: "Một nam thanh niên mặc đồ gym, vóc dáng săn chắc, khuôn mặt quyết tâm..."]
+Yêu cầu nội dung: Làm nổi bật tính năng [USP 1] và [USP 2]. Đoạn Hook phải bắt ngay vào nỗi đau [Pain Point]. Call To Action cuối video là tải app {{APP_NAME}} ngay hôm nay.
+```

package/skills/mascot-designer/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: mascot-designer
+description: Use when the user wants to design a mascot, define character concepts, create emotional states for onboarding/engagement, or integrate characters into UI designs. Triggers on "mascot design", "character concept", "virtual coach", "pixel mascot". Chains to pixel-gen or generate_image depending on the required art style.
+---
+
+# Mascot Designer & Virtual Coach Systems
+
+You are an expert in character design and brand gamification. Mascots (Virtual Coaches) significantly increase user engagement, retention, and onboarding completion rates by providing an emotional anchor, normalizing struggles, and delivering intermittent reinforcement.
+
+## Core Responsibilities
+1. **Concept Development**: Defining the mascot's identity, personality, and art style.
+2. **State Generation**: Defining the emotional and functional states needed for the app.
+3. **Pencil/UI Integration**: Planning how the mascot overlays or interacts with UI components.
+
+---
+
+## 🎭 1. Mascot Concept Design
+
+Before generating any art, define the character profile:
+- **Species/Form**: Animal, Robot, Abstract Shape, Humanoid?
+- **Personality**: Energetic cheerleader, calm mentor, sarcastic friend?
+- **Art Style**: Pixel Art (Retro/Gamified), 3D Render (Modern), Flat Vector (SaaS), Ghibli (Emotional).
+- **Core Purpose**: Is it just a logo, or does it guide the user through a Quiz Funnel?
+
+## 📊 2. Essential Emotional States
+
+If the mascot is used for **Onboarding (Quiz Funnels)** or **Health/EdTech**, you must define these core states:
+
+| State | Purpose | Context |
+|:---|:---|:---|
+| `idle` / `greeting` | Welcoming | Hook screens, app launch |
+| `thinking` / `curious` | Asking questions | Survey screens, data collection |
+| `encouraging` / `cheering`| Positive reinforcement | After completing a task |
+| `empathizing` / `sad` | Normalizing pain points | When user selects a negative option |
+| `analyzing` / `working` | Labor Illusion | Fake loading screens |
+| `presenting` / `proud` | Revealing results | Dynamic UI Reveal screen |
+| `celebrating` / `confetti`| Final conversion | Paywall completion, goal reached |
+
+---
+
+## 🎨 3. Asset Generation Chains
+
+Depending on the chosen art style, you MUST chain to the appropriate generation skill:
+
+### Option A: Pixel Art (Recommended for gamification)
+- Chain to **`aseprite-artist`** (or `pixel-gen` if configured)
+- Provide the exact palette and dimensions.
+- Ask for spritesheets if animations are needed.
+
+### Option B: High-Fidelity Illustration
+- Chain to **`generate_image`** tool
+- Maintain a consistent prompt prefix for style (e.g., "A flat vector illustration, pastel colors, white background, mascot of a robot...").
+
+---
+
+## 🚀 Execution Workflow
+
+1. **Ask for Context**: What is the app? Target audience? Brand colors?
+2. **Propose 3 Concepts**: Short descriptions of potential mascots.
+3. **Map the States**: List the exact states needed based on the feature (e.g., Onboarding requires 7 states).
+4. **Generate Base Asset**: Use the chained skills to generate the `idle` state first to lock in the design.
+5. **Generate State Variations**: Generate the rest of the states based on the locked-in base.
+6. **Integration Plan**: Document how the assets will be bundled (spritesheet vs individual PNGs) and used in code.
+
+## References
+See `examples/witny-case-study.md` for a complete example of a successful pixel art mascot implementation.

package/skills/mascot-designer/examples/witny-case-study.md

@@ -0,0 +1,35 @@
+# Case Study: Witny the Owl (FitWitness Simple)
+
+## Overview
+**Witny** is the official mascot for "FitWitness Simple", an app utilizing a SpriteCook/WitnyGame engine to visualize health and onboarding data. The mascot uses a pixel-art style, evoking nostalgia while maintaining a gamified coaching presence.
+
+## 1. Character Concept
+- **Form**: A small, wise, but cute owl.
+- **Personality**: A gentle observer and guide. Not overly energetic, but reliable and encouraging.
+- **Art Style**: 16-bit Pixel Art.
+- **Color Palette**: Muted earthy tones (browns, tans) with bright yellow eyes for expressiveness.
+
+## 2. Emotional and Action States
+
+For the integration into the app's onboarding and daily tracking, specific sprite states were generated:
+
+### Core Movement (Game Engine)
+- `idle`: Witny standing still, blinking occasionally. (Default anchor state)
+- `walk`: A 4-frame walking animation for navigating between UI sections.
+- `run`: Faster movement for achieving goals.
+- `jump_front`: Used for active celebrations or transitioning.
+- `hurt`: Used when a user breaks a streak or inputs negative health metrics.
+- `death`: (Rare) Used for extreme gamified fail-states or complete account resets.
+
+### Onboarding Expansion (For Quiz Funnels)
+Using the `mascot-designer` playbook, Witny was extended for the Quiz Funnel:
+- `greeting`: Witny waves a wing at the user on the Splash screen.
+- `thinking`: Witny taps their head with a wing when asking "What's your current weight?"
+- `empathizing`: Witny looks down with drooping eyes when the user selects "I feel tired often" (Normalization).
+- `analyzing`: Witny wears tiny pixel glasses and reads a book during the "Hold on, analyzing your profile..." Labor Illusion screen.
+
+## 3. Integration Learnings
+
+1. **Asset Management**: Pixel art creates many files. Grouping them into folders by state (e.g., `assets/mascot/witny/idle/`) or exporting as a unified `.aseprite` JSON spritesheet was critical for developer handoff.
+2. **Animation Over Static**: Because it's pixel art, a static image feels "dead". Even the `idle` state needed a 2-frame breathing animation to maintain the "Virtual Coach" presence.
+3. **UI Overlay**: Witny was designed with a transparent background so it could float above the standard iOS/Android native UI, breaking the grid and making the app feel alive.

package/skills/orchestrator/SKILL.md

@@ -68,5 +68,25 @@ No match → Ask clarifying question (max 2 times)
 Still unclear → Suggest `/help`
 ```
 
+### 5. Model Fitness Check (Pre-Execution Gate)
+```yaml
+model_fitness_gate:
+  purpose: "Đúng mô hình — đúng việc — tránh lãng phí token và tránh hallucination do mismatch."
+  action: "Orchestrator must analyze task complexity vs current model tier before code execution."
+  tiers:
+    - LIGHT: Flash/Haiku/4o-mini (config, syntax, docs, simple boilerplate)
+    - STANDARD: Pro/Sonnet/4o (90% dev work, active coding, feature additions, standard bug fixes)
+    - HEAVY: Opus/Ultra/o1/o3 (Architecture, custom framework, refactor > 5 files, deep debugging)
+  detect_signals:
+    escalate_if: "Blast radius > 5 files, ≥ 2 custom types (e.g. protocol matching), COMPLEX triage, circular self-correction"
+    downgrade_if: "Single file < 20 lines, *.plist|*.json|*.env, string replacements, no logic changes"
+  procedure:
+    1: "Phân loại mức độ phức tạp của Task để chốt Hạng Yêu Cầu (Required Tier) (tham khảo project-identity modelPolicy hoặc tự nội suy)."
+    2: "Chú ý Môi trường IDE (Cursor, Gemini) -> AI KHÔNG THỂ tự động đổi Model."
+    3: "Nếu phát hiện Mismatch (Over-fit lãng phí token như dùng Opus cho task dễ, HOẶC Under-fit sinh lỗi như dùng Flash cho task khó) -> Print ⚠️ MODEL TRIAGE CHECKPOINT và BẮT BUỘC DỪNG quá trình."
+    4: "Yêu cầu user tự chuyển đổi model trên IDE hoặc gõ 'Tiếp tục' để ép buộc chạy model hiện tại."
+    5: "Nếu Match (Đạt yêu cầu) -> Tiếp tục chạy bình thường."
+```
+
 ## Auto-Activation
 This skill is always active. It runs as the first layer before any other processing.

package/skills/review/SKILL.md

@@ -0,0 +1,87 @@
+---
+name: review
+description: Use when completing tasks, implementing features, or before merging. Dispatch structured code review with severity classification via Codex CLI.
+---
+
+<!-- ⚠️ SMART REVIEW AGENT — Intelligent routing for Security, Localization, Compliance, and Quality -->
+
+# Smart Code Review
+
+## Overview
+
+Review early, review often. Catch issues before they cascade.
+Antigravity uses `codex` CLI to perform deep, multi-file code reviews across specific domains (Security, Localization, Compliance, Quality). 
+
+**Core principle:** Actionable, domain-specific feedback via Multi-Agent Flow.
+
+## The Review Modules (Execution via Codex CLI)
+
+Thay vì tự đọc diff và đánh giá, Antigravity **BẮT BUỘC** gọi `codex` CLI để thực hiện Code Review nhằm mở rộng Context Window và sử dụng subagent chuyên dụng.
+Dưới đây là 5 Module Review Tự Động. Antigravity tự động map intent của User để chọn Module phù hợp:
+
+### 1. 🛡️ Security & Privacy Review (Thay thế `/audit`)
+**Dùng khi User yêu cầu:** *"review bảo mật", "check security", "kiểm tra an toàn"*
+
+```bash
+codex -p "Thực hiện Security & Privacy Review. Hãy quét khắt khe các điểm sau:
+1. Hardcoded API Keys/Secrets trong code hoặc file config.
+2. Dữ liệu PII (Personal Identifiable Information) có bị log ra console không (print, console.log).
+3. Lỗ hổng OWASP (SQL Injection, XSS, thiếu Rate Limiting, CORS/Headers lỏng lẻo).
+4. Kiểm tra việc sử dụng Secure Storage (Keychain/EncryptedSharedPreferences).
+5. Phân tích file Privacy Policy có khớp với dữ liệu thực tế thu thập không.
+Trả về báo cáo phân loại Critical/High/Low." --approval-mode auto
+```
+
+### 2. 🌐 Localization & UI Review
+**Dùng khi User yêu cầu:** *"review đa ngôn ngữ", "check hardcode string", "kiểm tra UI"*
+
+```bash
+codex -p "Thực hiện Localization Review. Quét các file UI (Views, Components):
+1. Tìm tất cả các string hiển thị cho người dùng bị hardcode mà chưa bọc qua hàm dịch (i18n, LocalizedStringKey, R.string).
+2. Đối chiếu xem các key được gọi trong UI đã tồn tại trong file từ điển (en/vi) chưa.
+Liệt kê chi tiết tên file và số dòng vi phạm." --approval-mode auto
+```
+
+### 3. 🍏 Store Compliance Review
+**Dùng khi User yêu cầu:** *"review appstore", "check compliance", "chuẩn bị submit"*
+
+```bash
+codex -p "Thực hiện App Store / Play Store Compliance Review. Đánh giá:
+1. Info.plist / AndroidManifest: Các chuỗi giải thích quyền (NSCameraUsageDescription...) có đầy đủ ý nghĩa không.
+2. App Tracking Transparency (ATT): Đã cấu hình và gọi khi cần chưa.
+3. Background Modes: Có khai báo thừa thãi không.
+4. Kiểm tra mã nguồn có API riêng tư (Private APIs) hoặc code tải logic động trái phép không." --approval-mode auto
+```
+
+### 4. 🧠 Architecture & Logic Review
+**Dùng khi User yêu cầu:** *"review kiến trúc", "review logic", "code smell"*
+
+```bash
+codex -p "Thực hiện Architecture & Logic Review. Đánh giá:
+1. Vi phạm nguyên tắc SOLID và Clean Architecture (VD: View xử lý Business Logic).
+2. Code duplication (Lặp code) hoặc Hàm quá dài (>50 lines).
+3. Thiếu Error Handling trong các async function / API calls.
+4. Memory Leaks (Retain cycles, forgot to unsubscribe)." --approval-mode auto
+```
+
+### 5. ⚡ Auto Diff Review (Mặc định)
+**Dùng khi User yêu cầu:** *"review", "review diff", "check code vừa viết"* hoặc khi hoàn thành Task.
+
+```bash
+codex -p "Review các thay đổi hiện tại (git diff/staged). Đảm bảo code mới viết đáp ứng Spec, không phá vỡ logic cũ và tuân thủ Coding Convention của dự án. Nếu an toàn, hãy trả về LGTM (Looks Good To Me)." --approval-mode auto
+```
+
+---
+
+## Cách Xử Lý Output Từ Codex
+1. Fix 🔴 **Critical** issues NGAY LẬP TỨC. (VD: Lộ Key, API chưa chặn rate limit).
+2. Fix 🟡 **Important** issues trước khi kết thúc task hoặc chuyển sang Phase mới. (VD: Quên localize string).
+3. Log 🟢 **Minor** issues để cấu trúc lại sau.
+4. Proceed nếu Subagent Codex báo "LGTM" hoặc không có issue nào nghiêm trọng.
+
+## Integration
+
+**Used by:**
+- `single-flow-task-execution` — Review sau mỗi task
+- `symphony-enforcer` — Review trước khi `symphony_complete_task`
+- Thay thế hoàn toàn quy trình thủ công của `/audit` workflow.