@leejungkiin/awkit 1.6.5 → 1.6.8

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/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.