add-skill-kit 3.2.4 → 3.2.6

package/README.md

@@ -1,149 +1,222 @@
-# Add Skill Kit
+# add-skill-kit
 
-> **Package Manager cho AI Agent Skills - Cài đặt 1 lệnh, dùng ngay lập tức**
+> **CLI installer for Agent Skill Kit - FAANG-grade AI skills, workflows, and agents**
 
-[![npm](https://img.shields.io/npm/v/add-skill-kit?style=flat&colorA=18181b&colorB=7c3aed)](https://www.npmjs.com/package/add-skill-kit)
-[![downloads](https://img.shields.io/npm/dm/add-skill-kit?style=flat&colorA=18181b&colorB=7c3aed)](https://www.npmjs.com/package/add-skill-kit)
+[![npm](https://img.shields.io/badge/npm-add--skill--kit-CB3837?style=flat&logo=npm)](https://www.npmjs.com/package/add-skill-kit)
+[![version](https://img.shields.io/badge/version-3.2.5-7c3aed?style=flat&colorA=18181b)](https://www.npmjs.com/package/add-skill-kit)
+[![JavaScript](https://img.shields.io/badge/100%25-JavaScript-F7DF1E?style=flat&colorA=18181b&logo=javascript)](https://github.com/agentskillkit/add-skill-kit)
 [![license](https://img.shields.io/badge/license-MIT-7c3aed?style=flat&colorA=18181b)](LICENSE)
 
 ---
 
-## 🎯 Lợi Ích Cho Bạn (Benefits)
-
-### ⚡ Từ 0 → Production-Ready Trong 30 Giây
+## ⚡ Installation
 
 ```bash
 npx -y add-skill-kit agentskillkit/agent-skills
 ```
 
-**Xong.** AI Agent của bạn đã có:
-- 40+ skills chuyên môn
-- 20 specialist agents
-- 11 workflows có sẵn
-- **✅ Agent CLI (`npx agent`) đã sẵn sàng**
+**That's it!** One command installs everything:
 
-### 🧩 Không Bao Giờ Copy-Paste Prompts Nữa
+| Component | Count | Description |
+|-----------|-------|-------------|
+| **Skills** | 49 | FAANG-grade coding skills |
+| **Workflows** | 26 | `/think`, `/build`, `/autopilot`, etc. |
+| **Agents** | 25 | Specialist AI agents |
+| **Rules** | GEMINI.md | AI behavior configuration |
+| **Scripts** | 25 | JavaScript automation scripts |
+| **Commands** | `kit` | CLI management tool |
+| **Commands** | `agent` | Interactive learning (optional) |
 
-Quên việc:
-- ❌ Tìm kiếm prompts tốt trên internet
-- ❌ Copy-paste vào từng project
-- ❌ Maintain nhiều phiên bản khác nhau
+---
 
-Với Add Skill Kit:
-- ✅ **1 source of truth** - Cập nhật trung tâm, mọi project đều nhận
-- ✅ **Symlink install** - Không duplicate files
-- ✅ **Version control** - Rollback bất cứ lúc nào
+## 🎯 What This CLI Does
 
-### 💡 AI Agent Của Bạn Tự Học
+### 1. Fetches Skills from GitHub
 
 ```bash
-# Dạy AI một lesson mới
-npx ag-smart learn --pattern "var " --message "Use const/let instead"
+# Install from any GitHub repo
+npx -y add-skill-kit <owner>/<repo>
+
+# Examples:
+npx -y add-skill-kit agentskillkit/agent-skills     # Official skills
+npx -y add-skill-kit myteam/company-skills          # Custom skills
+```
+
+### 2. Interactive Installation
+
+```
+┌───────────────────────────────────────────┐
+│   🛠️  Agent Skill Kit Installer          │
+├───────────────────────────────────────────┤
+│   ◆  Select skills to install            │
+│   ◆  Choose install scope                │
+│   ◆  Configure AutoLearn (optional)      │
+│   ◆  Auto-install dependencies           │
+└───────────────────────────────────────────┘
+```
+
+### 3. Creates Ready-to-Use Structure
 
-# Từ nay AI sẽ nhớ mãi và không lặp lại
 ```
+your-project/
+├── .agent/
+│   ├── GEMINI.md              # AI Rules
+│   ├── skills/                # 49 Skills
+│   ├── workflows/             # 26 Workflows
+│   ├── agents/                # 25 Agents
+│   ├── knowledge/             # Learning memory
+│   ├── config/                # Configuration
+│   ├── scripts-js/            # Automation
+│   └── metrics/               # Tracking
+│
+├── kit.cmd / kit              # CLI wrapper
+└── agent.cmd / agent          # AutoLearn (optional)
+```
+
+---
+
+## 🔧 CLI Options
+
+### Install Scope
+
+| Option | Location | Best For |
+|--------|----------|----------|
+| **Project** | `.agent/` in current project | Single project |
+| **Global** | `~/.gemini/antigravity/` | All projects |
+
+### AutoLearn (Optional)
+
+When prompted "Install AutoLearn?":
+
+| Choice | Effect |
+|--------|--------|
+| **Yes** | Installs `agent` command for interactive learning |
+| **No** | Core functionality works perfectly, just no `agent` CLI |
+
+> **Note:** Choosing "No" does NOT affect workflows, skills, or agents.
 
 ---
 
-## 🚀 Quick Start
+## 📦 Commands After Installation
 
-### Cài Đặt Skills
+### `kit` Command (Always Available)
 
 ```bash
-# Install toàn bộ Agent Skills Kit
-npx -y add-skill-kit agentskillkit/agent-skills
+kit list                    # List all installed skills
+kit validate                # Validate skill structure  
+kit info <skill>            # Show skill details
+kit doctor                  # Check system health
+kit cache status            # View cache usage
+kit cache clear             # Clear cache
+```
 
-# Hoặc chỉ 1 skill cụ thể
-npx -y add-skill-kit agentskillkit/agent-skills#react-patterns
+### `agent` Command (If AutoLearn Installed)
+
+```bash
+agent                       # Launch dashboard
+agent learn                 # Teach patterns
+agent recall                # Scan violations
+agent stats                 # View statistics
+agent watch                 # Real-time monitor
 ```
 
-### Quản Lý Skills
+---
+
+## 🚀 Usage Examples
+
+### Install Official Skills
 
 ```bash
-# Liệt kê skills đã cài
-add-skill-kit list
+npx -y add-skill-kit agentskillkit/agent-skills
+```
 
-# Cập nhật skills
-add-skill-kit update
+### Install Specific Skill
 
-# Gỡ cài đặt
-add-skill-kit uninstall react-patterns
+```bash
+npx -y add-skill-kit agentskillkit/agent-skills/react-architect
+```
+
+### Install to Global Location
+
+```bash
+npx -y add-skill-kit agentskillkit/agent-skills --global
+```
+
+### Force Reinstall
 
-# Kiểm tra health
-add-skill-kit doctor
+```bash
+npx -y add-skill-kit agentskillkit/agent-skills --force
 ```
 
 ---
 
-## 🏆 Ưu Điểm Vượt Trội (Advantages)
+## 🗂️ What Gets Installed
 
-| Feature | Add Skill Kit | Copy-Paste Thủ Công |
-|---------|---------------|---------------------|
-| **Install time** | 30 giây | 30+ phút |
-| **Cập nhật** | 1 lệnh | Manual mỗi file |
-| **Consistency** | 100% đồng bộ | Dễ sai lệch |
-| **Rollback** | ✅ Built-in | ❌ Manual backup |
-| **Integrity check** | ✅ Merkle hash | ❌ Không có |
-| **Self-learning** | ✅ Knowledge base | ❌ Không có |
+### Complete Structure
 
----
+```
+.agent/
+├── GEMINI.md                      # Supreme AI Rules
+├── ARCHITECTURE.md                # System Overview
+├── CONTINUOUS_EXECUTION_POLICY.md # Autopilot Rules
+├── WORKFLOW_CHAINS.md             # Workflow Patterns
+│
+├── skills/                        # 49 Skills
+│   ├── auto-learner/
+│   ├── react-architect/
+│   ├── typescript-expert/
+│   ├── debug-pro/
+│   ├── studio/
+│   └── ... (44 more)
+│
+├── workflows/                     # 26 Workflows
+│   ├── think.md
+│   ├── build.md
+│   ├── autopilot.md
+│   └── ... (23 more)
+│
+├── agents/                        # 25 Agents
+│   ├── frontend-specialist.md
+│   ├── backend-specialist.md
+│   └── ... (23 more)
+│
+├── knowledge/                     # Learning Memory
+│   └── lessons-learned.yaml
+│
+├── config/                        # Configuration
+├── scripts-js/                    # 25 JS Scripts
+└── metrics/                       # Performance
+```
 
-## 📦 Tính Năng Đầy Đủ (Features)
+### Dependencies Auto-Installed
 
-### 🔧 CLI Commands
+```bash
+npm install                        # Node.js dependencies
+```
 
-| Command | Chức năng |
-|---------|-----------|
-| `install` / `add` / `i` | Cài đặt skills từ GitHub |
-| `uninstall` / `remove` / `rm` | Gỡ cài đặt |
-| `update` | Cập nhật skills |
-| `list` / `ls` | Liệt kê skills |
-| `verify` | Kiểm tra integrity |
-| `doctor` | Health check |
-| `validate` / `check` | Validate spec |
-| `analyze` | Phân tích skill |
-| `info` / `show` | Thông tin skill |
-| `lock` | Lock file |
-| `cache` | Quản lý cache |
+---
 
-### 🎯 Intelligent Installation
+## 🔗 Related Packages
 
-- **Interactive selection** - Chọn skills cần cài
-- **Auto-Install CLI** - Tự động cài `agentskillskit-cli`
-- **Symlink mode** - Tiết kiệm disk space
-- **Copy mode** - Offline support
-- **Merkle verification** - Đảm bảo integrity
+| Package | Purpose |
+|---------|---------|
+| [agent-skills](https://github.com/agentskillkit/agent-skills) | Main skills repository |
+| [add-skill-kit](https://www.npmjs.com/package/add-skill-kit) | This CLI installer |
 
-### 📁 Cài Đặt Đầy Đủ
+---
 
-Một lệnh cài đặt tất cả:
+## 📈 Version History
 
-```
-.agent/
-├── skills/        # 40+ domain skills
-├── agents/        # 20 specialist personas
-├── workflows/     # 11 slash commands
-├── knowledge/     # Self-learning memory
-├── rules/         # Global rules
-├── .shared/       # Shared resources
-├── GEMINI.md      # Configuration
-└── ARCHITECTURE.md
-```
-
-### ⚡ 11 Slash Commands Có Sẵn
-| Command | Chức năng |
-|---------|-----------|
-| `/brainstorm` | Khám phá options trước khi code |
-| `/create` | Tạo features/apps mới |
-| `/debug` | Debug có hệ thống |
-| `/deploy` | Deploy production |
-| `/enhance` | Thêm/cập nhật features |
-| `/orchestrate` | Điều phối multi-agents |
-| `/plan` | Lập kế hoạch task |
-| `/preview` | Quản lý dev server |
-| `/status` | Xem tiến độ project |
-| `/test` | Tạo và chạy tests |
-| `/ui-ux-pro-max` | Thiết kế UI chuyên sâu |
+**v3.2.5 (Current)**
+- ✅ 100% JavaScript - No Python required
+- ✅ AutoLearn made optional
+- ✅ Complete installation (config, scripts-js, metrics, policy docs)
+- ✅ Improved error messages
+- ✅ Wrapper scripts for `kit` and `agent`
+
+**v3.2.0**
+- Migrated all scripts to JavaScript
+- Added `kit` CLI command
 
 ---
 
@@ -157,34 +230,21 @@ cd add-skill-kit
 # Install dependencies
 npm install
 
-# Run tests
-npm test
-
-# Run linting
-npm run lint
+# Run locally
+node bin/kit.js install agentskillkit/agent-skills
 ```
 
 ---
 
-## 📋 Requirements
-
-- Node.js 18+
-- Git (để clone repositories)
-
----
-
-## 🔗 Links
+## 📄 License
 
-- [Agent Skills Kit (Content)](https://github.com/agentskillkit/agent-skills)
-- [NPM Package](https://www.npmjs.com/package/add-skill-kit)
-- [Issues](https://github.com/agentskillkit/add-skill-kit/issues)
+MIT - Free for all projects.
 
 ---
 
-## 📄 License
-
-MIT - Sử dụng tự do.
+**⚡ add-skill-kit v3.2.5**
+*One command. Complete AI setup.*
 
 ---
 
-**⭐ Star nếu hữu ích. Cài đặt ngay. Build faster.**
+**[GitHub](https://github.com/agentskillkit/add-skill-kit) • [npm](https://www.npmjs.com/package/add-skill-kit) • [Issues](https://github.com/agentskillkit/add-skill-kit/issues)**

package/bin/lib/commands/help.js

@@ -12,10 +12,6 @@ export async function run() {
   let running = true;
 
   while (running) {
-    stepLine();
-    step(c.bold("kit") + c.dim(` v${VERSION}`));
-    step(c.dim("What would you like to know?"));
-    stepLine();
 
     const choice = await select({
       message: "Select a topic",

package/bin/lib/commands/install.js

@@ -523,6 +523,58 @@ export async function run(spec) {
         knowledgeInstalled = true;
     }
 
+    // Install config/ if it exists (required for skill configuration)
+    const configDir = path.join(baseAgentDir, "config");
+    const targetConfigDir = path.join(WORKSPACE, "..", "config");
+    let configInstalled = false;
+
+    if (fs.existsSync(configDir) && !fs.existsSync(targetConfigDir)) {
+        fs.cpSync(configDir, targetConfigDir, { recursive: true });
+        step("Installed config/");
+        configInstalled = true;
+    }
+
+    // Install scripts-js/ if it exists (required for skill operations)
+    const scriptsJsDir = path.join(baseAgentDir, "scripts-js");
+    const targetScriptsJsDir = path.join(WORKSPACE, "..", "scripts-js");
+    let scriptsJsInstalled = false;
+
+    if (fs.existsSync(scriptsJsDir) && !fs.existsSync(targetScriptsJsDir)) {
+        fs.cpSync(scriptsJsDir, targetScriptsJsDir, { recursive: true });
+        step("Installed scripts-js/");
+        scriptsJsInstalled = true;
+    }
+
+    // Install metrics/ if it exists (for agent performance tracking)
+    const metricsDir = path.join(baseAgentDir, "metrics");
+    const targetMetricsDir = path.join(WORKSPACE, "..", "metrics");
+    let metricsInstalled = false;
+
+    if (fs.existsSync(metricsDir) && !fs.existsSync(targetMetricsDir)) {
+        fs.cpSync(metricsDir, targetMetricsDir, { recursive: true });
+        step("Installed metrics/");
+        metricsInstalled = true;
+    }
+
+    // Install additional policy documents
+    const policyDocs = [
+        "CONTINUOUS_EXECUTION_POLICY.md",
+        "WORKFLOW_CHAINS.md"
+    ];
+    let policyDocsInstalled = 0;
+
+    for (const doc of policyDocs) {
+        const docSrc = path.join(baseAgentDir, doc);
+        const docDest = path.join(WORKSPACE, "..", doc);
+        if (fs.existsSync(docSrc) && !fs.existsSync(docDest)) {
+            fs.copyFileSync(docSrc, docDest);
+            policyDocsInstalled++;
+        }
+    }
+    if (policyDocsInstalled > 0) {
+        step(`Installed ${policyDocsInstalled} policy docs`);
+    }
+
     // Install rules if they exist
     const rulesDir = path.join(baseAgentDir, "rules");
     const targetRulesDir = path.join(WORKSPACE, "..", "rules");
@@ -630,17 +682,37 @@ export async function run(spec) {
 
     fs.rmSync(tmp, { recursive: true, force: true });
 
+    // Ask user about AutoLearn installation
+    stepLine();
+    const installAutoLearn = await confirm({
+        message: "Install AutoLearn (enables 'agent' command for learning & self-improvement)?",
+        initialValue: true
+    });
+
+    if (isCancel(installAutoLearn)) {
+        cancel("Installation cancelled");
+        process.exit(0);
+    }
+
     // Install CLI package
     stepLine();
     const cliSpinner = spinner();
-    const cliPackage = "agentskillskit-cli";
+    const cliPackage = "add-skill-kit";
 
     if (isGlobal) {
-        cliSpinner.start(`Installing Agent CLI globally (${cliPackage})`);
+        if (installAutoLearn) {
+            cliSpinner.start(`Installing CLI globally (${cliPackage})`);
+        } else {
+            cliSpinner.start(`Installing kit CLI globally (${cliPackage})`);
+        }
         try {
             await execAsync(`npm install -g ${cliPackage}`, { timeout: 120000 });
-            cliSpinner.stop("Agent CLI installed globally");
-            step(c.dim("Run: agent"));
+            cliSpinner.stop("CLI installed globally");
+            if (installAutoLearn) {
+                step(c.dim("Commands: agent, kit"));
+            } else {
+                step(c.dim("Command: kit"));
+            }
         } catch (e) {
             cliSpinner.stop(c.yellow("Global CLI installation failed"));
             step(c.dim(`Try running manually: npm i -g ${cliPackage}`));
@@ -649,7 +721,7 @@ export async function run(spec) {
         cliSpinner.start(`Installing Agent CLI locally (${cliPackage})`);
         try {
             await execAsync(`npm install -D ${cliPackage}`, { timeout: 120000 });
-            cliSpinner.stop("Agent CLI installed locally");
+            cliSpinner.stop("CLI installed locally");
 
             // Add npm scripts to package.json
             try {
@@ -658,25 +730,73 @@ export async function run(spec) {
                     const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
                     pkg.scripts = pkg.scripts || {};
 
-                    // Add agent script if not exists
-                    if (!pkg.scripts.agent) {
+                    // Always add kit script
+                    if (!pkg.scripts.kit) {
+                        pkg.scripts.kit = "kit";
+                    }
+
+                    // Add agent script only if AutoLearn enabled
+                    if (installAutoLearn && !pkg.scripts.agent) {
                         pkg.scripts.agent = "agent";
                     }
 
                     fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
-                    step(c.green("✓ Added npm script: 'agent'"));
+                    if (installAutoLearn) {
+                        step(c.green("✓ Added npm scripts: 'agent', 'kit'"));
+                    } else {
+                        step(c.green("✓ Added npm script: 'kit'"));
+                    }
                 }
             } catch (scriptErr) {
                 step(c.yellow("⚠ Could not add npm scripts automatically"));
             }
 
-            step(c.dim("Run: npm run agent"));
+            // Create wrapper scripts for direct command access (Windows + Unix)
+            try {
+                const projectRoot = process.cwd();
+
+                // Always create kit wrappers
+                const kitCmd = `@echo off\nnode "%~dp0node_modules\\add-skill-kit\\bin\\kit.js" %*`;
+                const kitSh = `#!/bin/sh\nnode "$(dirname "$0")/node_modules/add-skill-kit/bin/kit.js" "$@"`;
+                fs.writeFileSync(path.join(projectRoot, "kit.cmd"), kitCmd);
+                fs.writeFileSync(path.join(projectRoot, "kit"), kitSh, { mode: 0o755 });
+
+                if (installAutoLearn) {
+                    // Create agent wrappers only if AutoLearn enabled
+                    const agentCmd = `@echo off\nnode "%~dp0node_modules\\add-skill-kit\\lib\\agent-cli\\bin\\agent.js" %*`;
+                    const agentSh = `#!/bin/sh\nnode "$(dirname "$0")/node_modules/add-skill-kit/lib/agent-cli/bin/agent.js" "$@"`;
+                    fs.writeFileSync(path.join(projectRoot, "agent.cmd"), agentCmd);
+                    fs.writeFileSync(path.join(projectRoot, "agent"), agentSh, { mode: 0o755 });
+
+                    step(c.green("✓ Created wrapper scripts: agent, kit"));
+                    step(c.dim("Run directly: ./agent or ./kit (Unix) | agent or kit (Windows)"));
+                } else {
+                    step(c.green("✓ Created wrapper script: kit"));
+                    step(c.dim("Run directly: ./kit (Unix) | kit (Windows)"));
+                }
+            } catch (wrapperErr) {
+                step(c.dim("Run: npx kit"));
+            }
         } catch (e) {
             cliSpinner.stop(c.yellow("Local CLI installation skipped"));
             step(c.dim(`Run manually: npm i -D ${cliPackage}`));
         }
     }
 
+    // Run npm install to ensure all skill dependencies are available
+    stepLine();
+    const depsSpinner = spinner();
+    depsSpinner.start("Installing skill dependencies (csv-parse, etc.)");
+    try {
+        await execAsync("npm install", { timeout: 120000 });
+        depsSpinner.stop("Skill dependencies installed");
+    } catch (e) {
+        depsSpinner.stop(c.yellow("Dependencies installation skipped"));
+        step(c.dim("Run manually: npm install"));
+    }
+
+    // Python dependencies no longer needed - all scripts migrated to JS
+
     stepLine();
     console.log(` ${c.cyan("Done!")}`);
     console.log();

package/bin/lib/ui.js

@@ -177,7 +177,7 @@ export function brandedIntro(version, status = "") {
     // Last line: gradient ASCII + dim version (aligned at bottom)
     const lastLine = bannerLines[bannerLines.length - 1];
     console.log(pikaGradient(lastLine) + `  ${c.dim(`v${version}`)}`);
-    console.log(''); // Empty line after banner
+
 
     if (status) {
         console.log(`${c.dim(status)}`);