@xaviele/ag-kit (Antigravity Agent Kit)

🌎 English | 🇻🇳 Tiếng Việt

🇬🇧 English Version

🚀 Antigravity Agent Kit is a powerful CLI utility that injects an advanced AI Agent workspace into any of your projects. Packed with 45 specialized skills, 12 automated workflows, and smart project configurations.

📦 Quick Install

Run directly via npx in your target project root folder to install the AI system:

npx @xaviele/ag-kit init

🎯 Specialized Commands

| Command | Functionality | Description | |---------|---------------|-------------| | init | Core setup | Automatically generates the .agent/ directory with the full core system. Use the --force flag to overwrite/reset. | | add <skill> | Add single skill | Swiftly inject any missing individual skill into an installed project (E.g.: npx @xaviele/ag-kit add clean-code). | | update | Safe Sync | Downloads the latest core Skills from the Master Repo but STRICTLY PRESERVES your current configurations (Rules, Architecture). |

🛠️ What's inside the AI Brain?

After installation, your .agent directory serves as the control center guiding the behavior of your AI Programming Assistants (Claude, Cursor, Gemini)... with 3 main architectural blocks:

1. 🧠 Skills (45 Skills)

The Kit comes pre-loaded with numerous deep-expertise skills, acting as instruction manuals helping the AI behave like an expert Senior Engineer.

• Frontend & Web: React patterns, Tailwind v4, Mobile Design, Web Testing (Playwright), Waterfall fetching optimization.
• System & Backend: Database architecture logic, REST & GraphQL API design, Server Management, Deployment strategies.
• Security & Metrics: Standardized Clean Code, Vulnerability scanning, Red-team tactics, Core Web Vitals 2025.
• Super Apps: Blazing-fast Zalo Mini App capabilities, premium ZaUI interfaces, UI/UX Pro Max standards.

2. 🔄 Automated Workflows (12 Workflows)

Slash-command shortcuts (like /slash-commands) standardizing your development lifecycle. For example:

• /brainstorm: Forces the AI to think and solve edge cases thoroughly before rushing into code.
• /plan: Demands the AI write an Implementation Plan File for components so you can approve it before execution.
• /ui-ux-pro-max: A specialized process preventing the AI from using outdated libraries, forcing Glassmorphism and smooth Gradient designs.
• /test: Automatically scours the Source Code to attach AAA-standard Unit/E2E tests.

3. 🛡️ Rules & Architecture

The area establishing boundaries for the Assistant:

• rules/: Contains rules specific to you or your organization. (E.g., "Always explain in English," "Do not use Moment.js").
• ARCHITECTURE.md / mcp_config.json: Documentation noting your unique system architecture (The AI ecosystem scans these first to grasp the current Codebase context).

🚀 Use Cases

1. Super App Initialization (e.g., Zalo Mini App): Setup an empty project, install the Kit, and chat: "Use /ui-ux-pro-max to design the Index screen" -> The AI immediately complies with flat Mobile design standards and exact Styles.
2. Code & Architecture Review: Use the /orchestrate workflow, and the AI will summon various Virtual Engineers (Frontend Specialist, Backend Architect, Security Auditor) to jointly review your repository's security.
3. Legacy Code Revival: Drop the Kit into dusty code and chat: "Clean up trash variables based on clean-code and react-best-practices" -> The AI systematically refactors each file.

🇻🇳 Phiên bản Tiếng Việt

🚀 Antigravity Agent Kit là một tiện ích dòng lệnh CLI mạnh mẽ giúp tự động cấy ghép Không gian làm việc Trợ lý AI nâng cao vào bất kỳ dự án nào của bạn. Gói bao gồm 45 kỹ năng chuyên môn, 12 quy trình luồng làm việc tự động, và các cấu hình dự án thông minh.

📦 Cài đặt thao tác nhanh

Chỉ cần chạy trực tiếp bằng lệnh npx ở thư mục gốc của dự án bạn muốn cài đặt hệ thống AI:

npx @xaviele/ag-kit init

🎯 Các lệnh Chuyên biệt

| Lệnh | Tính năng | Mô tả chi tiết | |------|-----------|----------------| | init | Khởi tạo toàn bộ lõi | Tự động sinh mục .agent/ với toàn bộ hệ thống gốc. Dùng cờ --force để cài đè (Reset). | | add <skill> | Thêm 1 kỹ năng lẻ | Bổ sung siêu tốc bất kỳ kỹ năng nào bị thiếu vào dự án đã cài đặt (VD: npx @xaviele/ag-kit add clean-code). | | update | Cập nhật đồng bộ | Tải các Kỹ năng gốc mới nhất từ Master Repo nhưng BẢO TOÀN TUYỆT ĐỐI các cài đặt (Rules, Cấu hình) của bạn hiện tại. |

🛠️ Cấu trúc "Bộ não AI" có gì?

Sau khi cài đặt xong, thư mục .agent của bạn sẽ đóng vai trò điều hướng mọi hành vi của Trợ lý lập trình AI (Claude, Cursor, Gemini)... với 3 khối kiến trúc chính:

1. 🧠 Kỹ năng (45 Skills)

Bộ Kit chứa sẵn vô số kỹ năng chuyên môn sâu, đóng vai trò như cẩm nang hướng dẫn AI làm việc chuẩn xác như một kỹ sư chuyên nghiệp (Senior Engineer).

• Frontend & Web: Kỹ năng viết React, Tailwind v4, Mobile Design, Web Testing (Playwright), Tối ưu hoá Waterfall fetching.
• Hệ thống & Backend: Thiết kế kiến trúc Database logic, REST & GraphQL API, Quản lý Server, Mẹo Deploy an toàn.
• Bảo mật & Tối ưu: Clean Code quy chuẩn quốc tế, Rà quét lỗ hổng rủi ro (Vulnerability scanner), Chiến thuật Red-team, Đo tốc độ web 2025.
• Siêu Ứng dụng (Super Apps): Kỹ năng code Zalo Mini App thần tốc, giao diện ZaUI cao cấp, UI/UX Pro Max.

2. 🔄 Luồng làm việc tự động (12 Workflows)

Các phím tắt quy trình (kiểu /slash-commands) chuẩn hóa vòng đời phát triển dự án. Chẳng hạn:

• /brainstorm: Ép AI động não, rào trước đón sau giải quyết triệt để edge-cases trước khi hùng hục lao vào code.
• /plan: Yêu cầu AI viết Kế hoạch triển khai (Implementation Plan) thật kĩ để bạn Phê duyệt trước khi tiến hành viết Code.
• /ui-ux-pro-max: Quy trình chuyên biệt ép AI không được dùng Bootstrap cũ rích mà phải thiết kế giao diện Glassmorphism, Gradient bóng mượt.
• /test: Tự động lùng sục Source Code và đính kèm Unit test chuẩn mô hình cốt lõi.

3. 🛡️ Quy tắc (Rules) & Cấu hình (Architecture)

Khu vực thiết lập giới hạn và điều luật ranh giới cho Trợ lý:

• rules/: Chứa các quy định riêng theo văn hóa tổ chức của bạn. Định dạng file markdown cực kì cơ bản. Ví dụ: "Luôn luôn trả lời Tiếng Việt", "Nghiêm cấm dùng thư viện Moment.js", v.v.
• ARCHITECTURE.md / mcp_config.json: Tài liệu ghi chú kiến trúc hệ thống riêng biệt của bạn (Hệ sinh thái AI sẽ scan các file này đầu tiên để móc nối bối cảnh làm việc hiện tại).

🚀 Các Trường hợp sử dụng tiêu biểu

1. Khởi động Nhanh Siêu ứng dụng (VD: Zalo Mini App Taisun): Bạn tạo dự án trống, cài Gói Kit này bằng lệnh init, sau đó chat với AI: "Hãy dùng lệnh /ui-ux-pro-max và thiết kế màn hình Check-in" -> AI lập tức tuân thủ quy chuẩn thiết kế Mobile phẳng, áp dụng Style chuẩn xác và giao diện hút mắt.
2. Review Code & Kiến trúc Hệ thống: Dùng quy trình /orchestrate (Điều phối), AI sẽ tự gọi ra Hội Đồng Kỹ sư ảo (Frontend Specialist, Backend Architect, Security Auditor) luân lưu code và dò lổ hổng bảo mật trang Repo cho bạn.
3. Tái sinh mã nguồn cũ rích: Thả bộ Kit vào đống code đã bám bụi, gõ vào luồng chat: "Hãy dọn dẹp các biến rác theo chuẩn skill clean-code và react-best-practices" -> AI tự thực thi cải tạo và refactor tối ưu theo chuẩn quốc tế 2025 từng đoạn code một.

⚖️ License

MIT © Xavie Le