@ikyyofc/gemini-cli 3.0.1 → 3.0.2

package/index.js

@@ -24,11 +24,16 @@ import {
 } from "./src/input.js";
 import { setupGlobalProxy, proxyStatus, setProxyEnabled } from "./src/utils/proxy.js";
 import { Spinner } from "./src/utils/spinner.js";
+import {
+    listInstalledSkills, installSkill, removeSkill,
+    searchSkills, browseSkills, ensureSkillsDirs, loadSkills,
+} from "./src/skills.js";
 
 // ─────────────────────────────────────────────────────────────────
 //  Bootstrap
 // ─────────────────────────────────────────────────────────────────
 ensureGlobalDir();
+ensureSkillsDirs();
 setupGlobalProxy();   // aktifkan rotasi proxy sebelum request apapun
 
 let extensions    = loadExtensions();
@@ -231,6 +236,138 @@ async function handleCommand(input) {
             printInfo("conversation cleared");
             break;
 
+        case "/skill": case "/skills": {
+            const sub  = tokens[1]?.toLowerCase();
+            const rest = tokens.slice(2).join(" ").trim();
+
+            // /skill list
+            if (!sub || sub === "list") {
+                const list = listInstalledSkills();
+                if (!list.length) {
+                    printInfo("no skills installed  ·  use /skill add <id> to install");
+                    printInfo("browse skills at https://skills.sh");
+                    break;
+                }
+                console.log("");
+                list.forEach(s => {
+                    const scope = s.global ? chalk.dim("global") : chalk.hex("#4EC9B0")("project");
+                    console.log(
+                        "  " + chalk.hex("#FFD080").bold(s.slug.padEnd(28)) +
+                        chalk.dim(s.source.padEnd(30)) + scope
+                    );
+                });
+                console.log(chalk.dim(`\n  ${list.length} skill(s) loaded into agent context\n`));
+                break;
+            }
+
+            // /skill add <id> [--global]
+            if (sub === "add" || sub === "install") {
+                const isGlobal = rest.includes("--global");
+                const id       = rest.replace("--global", "").trim();
+                if (!id) { printError("usage: /skill add <owner/repo/slug> [--global]"); break; }
+                const sp = new Spinner();
+                sp.start(`installing ${id}…`, "#FFD080");
+                try {
+                    const result = await installSkill(id, isGlobal ? "global" : "project");
+                    sp.succeed(`installed: ${result.name}  →  ${result.dir}`);
+                    printInfo("skill will be active on next message");
+                } catch (e) {
+                    sp.fail(e.message);
+                    printError(e.message);
+                }
+                break;
+            }
+
+            // /skill remove <slug>
+            if (sub === "remove" || sub === "rm") {
+                const slug = rest;
+                if (!slug) { printError("usage: /skill remove <slug>"); break; }
+                try {
+                    const removed = removeSkill(slug);
+                    removed.forEach(r => printSuccess(`removed: ${r}`));
+                } catch (e) { printError(e.message); }
+                break;
+            }
+
+            // /skill search <query>
+            if (sub === "search") {
+                if (!rest) { printError("usage: /skill search <query>"); break; }
+                const sp = new Spinner();
+                sp.start(`searching "${rest}"…`, "#4A9EFF");
+                try {
+                    const results = await searchSkills(rest, 8);
+                    sp.stop();
+                    if (!results.length) { printInfo("no results found"); break; }
+                    console.log("");
+                    results.forEach(r => {
+                        console.log(
+                            "  " + chalk.hex("#4A9EFF").bold(r.id.padEnd(48)) +
+                            chalk.dim(String(r.installs).padStart(8) + " installs")
+                        );
+                        if (r.name !== r.slug)
+                            console.log("  " + chalk.dim(" ".repeat(2) + r.name));
+                    });
+                    console.log(chalk.dim("\n  install: /skill add <id>\n"));
+                } catch (e) {
+                    sp.fail(e.message);
+                    printError(e.message);
+                }
+                break;
+            }
+
+            // /skill browse [trending|hot]
+            if (sub === "browse") {
+                const view = rest || "all-time";
+                const sp   = new Spinner();
+                sp.start(`fetching ${view}…`, "#4A9EFF");
+                try {
+                    const results = await browseSkills(view, 15);
+                    sp.stop();
+                    console.log("");
+                    results.forEach((r, i) => {
+                        console.log(
+                            "  " + chalk.dim(String(i+1).padStart(2) + ".") + " " +
+                            chalk.hex("#4A9EFF").bold(r.id.padEnd(46)) +
+                            chalk.dim(String(r.installs).padStart(8) + " installs")
+                        );
+                    });
+                    console.log(chalk.dim("\n  /skill browse trending  ·  /skill browse hot\n"));
+                } catch (e) {
+                    sp.fail(e.message);
+                    printError(e.message);
+                }
+                break;
+            }
+
+            // /skill info <id>
+            if (sub === "info") {
+                if (!rest) { printError("usage: /skill info <id>"); break; }
+                const sp = new Spinner();
+                sp.start(`fetching ${rest}…`, "#4A9EFF");
+                try {
+                    const { default: ax } = await import("axios");
+                    const { data } = await ax.get(`https://skills.sh/api/v1/skills/${rest}`);
+                    sp.stop();
+                    console.log("");
+                    printInfo(`id       ${data.id}`);
+                    printInfo(`source   ${data.source}`);
+                    printInfo(`installs ${data.installs}`);
+                    printInfo(`files    ${data.files?.length ?? 0}`);
+                    if (data.files?.length) {
+                        data.files.forEach(f => console.log(chalk.dim("           " + f.path)));
+                    }
+                    console.log(chalk.dim(`\n  /skill add ${data.id}\n`));
+                } catch (e) {
+                    sp.fail(e.message);
+                    printError(e.message);
+                }
+                break;
+            }
+
+            printInfo("usage: /skill [list | add | remove | search | browse | info]");
+            break;
+        }
+
         case "/file":
             if (!arg) { printError("usage: /file <path>"); break; }
             attachFile(arg); break;
@@ -282,12 +419,14 @@ async function handleCommand(input) {
             break;
 
         case "/model": {
-            const px = proxyStatus();
+            const px  = proxyStatus();
+            const sk  = loadSkills();
             printInfo(`model      gemini-pro-latest`);
             printInfo(`tools      ${agentMode ? "on (native function calling)" : "off"}`);
             printInfo(`yolo       ${autoApprove ? "on" : "off"}`);
             printInfo(`memory     ${memoryLoaded.length} file(s)  ·  extensions: ${extensions.length}`);
-            printInfo(`proxy      ${px.available}/${px.total} available  ·  ${px.blocked} blocked  ·  ${px.enabled ? "on" : "off"}`);
+            printInfo(`skills     ${sk.length} active  ·  .agents/ + ~/.gemini/agents/`);
+            printInfo(`proxy      ${px.available}/${px.total} available  ·  ${px.enabled ? "on" : "off"}`);
             printInfo(`config     ${GLOBAL_DIR}`);
             break;
         }
@@ -324,7 +463,7 @@ async function handleCommand(input) {
 // ─────────────────────────────────────────────────────────────────
 async function main() {
     process.stdout.write("\x1Bc");
-    console.log(renderWelcome(memoryLoaded.length, extensions.length));
+    console.log(renderWelcome(memoryLoaded.length, extensions.length, loadSkills().length));
 
     const argv = process.argv.slice(2);
     const positional = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikyyofc/gemini-cli",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "description": "AI Agent CLI — native function calling · GEMINI.md context · extensions",
   "type": "module",
   "bin": { "gemini": "./index.js" },

package/src/agent.js

@@ -3,6 +3,7 @@ import chalk from "chalk";
 import { callGemini } from "./gemini.js";
 import { GEMINI_TOOLS, FUNCTION_DECLARATIONS, executeTool } from "./tools.js";
 import { Spinner } from "./utils/spinner.js";
+import { loadSkills, buildSkillsPrompt } from "./skills.js";
 import {
     printAssistant, printError, printWarning,
     printToolCall, printToolResult,
@@ -15,7 +16,10 @@ const TIMEOUT_MS = 10 * 60 * 1000; // 10 minutes
 //  System prompt
 // ─────────────────────────────────────────────────────────────────
 function buildSystemPrompt(extra = "") {
-    const toolList = FUNCTION_DECLARATIONS.map(t => `- ${t.name}: ${t.description}`).join("\n");
+    const toolList    = FUNCTION_DECLARATIONS.map(t => `- ${t.name}: ${t.description}`).join("\n");
+    const skills      = loadSkills();
+    const skillsBlock = buildSkillsPrompt(skills);
+
     return `You are an autonomous AI coding agent running in the user's terminal. You have full access to their filesystem and shell through tools.
 
 ## CORE RULE — NEVER ASK, ALWAYS ACT
@@ -49,7 +53,7 @@ ${toolList}
 - Current working directory: ${process.cwd()}
 - Platform: ${process.platform}
 
-${extra ? `## EXTRA INSTRUCTIONS\n${extra}` : ""}`.trim();
+${skillsBlock ? skillsBlock + "\n" : ""}${extra ? `## EXTRA INSTRUCTIONS\n${extra}` : ""}`.trim();
 }
 
 // ─────────────────────────────────────────────────────────────────

package/src/renderer.js

@@ -324,11 +324,12 @@ export function printWarning(msg) { process.stdout.write(chalk.hex(C.yellow)("
 // ─────────────────────────────────────────────────────────────────
 //  Welcome & Help
 // ─────────────────────────────────────────────────────────────────
-export function renderWelcome(memCount = 0, extCount = 0) {
+export function renderWelcome(memCount = 0, extCount = 0, skillCount = 0) {
     const W = bw();
     const stats = [
-        memCount ? `${memCount} context file${memCount > 1 ? "s" : ""}` : null,
-        extCount ? `${extCount} extension${extCount > 1 ? "s" : ""}` : null,
+        memCount   ? `${memCount} context file${memCount > 1 ? "s" : ""}`     : null,
+        extCount   ? `${extCount} extension${extCount > 1 ? "s" : ""}`         : null,
+        skillCount ? `${skillCount} skill${skillCount > 1 ? "s" : ""} active`  : null,
     ].filter(Boolean).join("  ·  ");
     return [
         "",
@@ -366,6 +367,15 @@ export function renderHelp(customCommands = {}) {
         row("/new  /clear",       "Reset conversation"),
         row("/model",             "Model & config info"),
         row("/proxy [on|off]",    "Proxy rotation status/toggle"),
+        "  " + sep,
+        chalk.hex(C.yellow).bold("  Skills  ·  skills.sh"),
+        "  " + sep,
+        row("/skill list",        "List installed skills"),
+        row("/skill add <id>",    "Install from skills.sh (--global for global)"),
+        row("/skill remove <n>",  "Uninstall a skill"),
+        row("/skill search <q>",  "Search skills.sh registry"),
+        row("/skill browse",      "Browse top skills (trending/hot)"),
+        row("/skill info <id>",   "Show skill details"),
         row("/exit  /quit",       "Exit"), sep,
         chalk.hex(C.dim)("  Ctrl+C  interrupt  ·  Ctrl+D  exit"), "",
     ];

package/src/skills.js

@@ -0,0 +1,218 @@
+// src/skills.js — Agent Skills Manager
+// Integrates with skills.sh registry
+// Skills are stored in .agents/ (project) or ~/.gemini/agents/ (global)
+import fs   from "fs";
+import path from "path";
+import os   from "os";
+import axios from "axios";
+
+const API   = "https://skills.sh/api/v1";
+const GLOBAL_AGENTS_DIR = path.join(os.homedir(), ".gemini", "agents");
+
+// ─────────────────────────────────────────────────────────────────
+//  Resolve skills directories
+//  Priority: .agents/ (project) → ~/.gemini/agents/ (global)
+// ─────────────────────────────────────────────────────────────────
+export function getSkillsDirs() {
+    const dirs = [];
+    const local = path.join(process.cwd(), ".agents");
+    if (fs.existsSync(local)) dirs.push(local);
+    if (fs.existsSync(GLOBAL_AGENTS_DIR)) dirs.push(GLOBAL_AGENTS_DIR);
+    return dirs;
+}
+
+export function ensureSkillsDirs() {
+    fs.mkdirSync(GLOBAL_AGENTS_DIR, { recursive: true });
+}
+
+// ─────────────────────────────────────────────────────────────────
+//  Load all installed skills — returns array of { name, path, content }
+// ─────────────────────────────────────────────────────────────────
+export function loadSkills() {
+    const skills = [];
+    const seen   = new Set();
+
+    for (const dir of getSkillsDirs()) {
+        if (!fs.existsSync(dir)) continue;
+
+        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+            if (!entry.isDirectory()) continue;
+            const skillDir  = path.join(dir, entry.name);
+            const skillMd   = path.join(skillDir, "SKILL.md");
+            const metaFile  = path.join(skillDir, ".meta.json");
+
+            if (!fs.existsSync(skillMd)) continue;
+            if (seen.has(entry.name)) continue; // project-level takes priority
+            seen.add(entry.name);
+
+            let meta = {};
+            try { meta = JSON.parse(fs.readFileSync(metaFile, "utf8")); } catch {}
+
+            const content = fs.readFileSync(skillMd, "utf8");
+
+            // Also read any supporting files (examples, etc.)
+            const extras = fs.readdirSync(skillDir)
+                .filter(f => f !== "SKILL.md" && f !== ".meta.json" && f.endsWith(".md"))
+                .map(f => fs.readFileSync(path.join(skillDir, f), "utf8"))
+                .join("\n\n");
+
+            skills.push({
+                name:    meta.name  ?? entry.name,
+                slug:    meta.slug  ?? entry.name,
+                source:  meta.source ?? "local",
+                path:    skillDir,
+                content: content + (extras ? "\n\n" + extras : ""),
+                global:  dir === GLOBAL_AGENTS_DIR,
+            });
+        }
+    }
+
+    return skills;
+}
+
+// ─────────────────────────────────────────────────────────────────
+//  Build skills section for system prompt
+// ─────────────────────────────────────────────────────────────────
+export function buildSkillsPrompt(skills) {
+    if (!skills.length) return null;
+
+    const sections = skills.map(s =>
+        `### Skill: ${s.name}\n${s.content.trim()}`
+    ).join("\n\n---\n\n");
+
+    return `## INSTALLED SKILLS\n\nThe following skills provide additional knowledge and capabilities. Apply them when relevant:\n\n${sections}`;
+}
+
+// ─────────────────────────────────────────────────────────────────
+//  API helpers
+// ─────────────────────────────────────────────────────────────────
+async function apiFetch(path, params = {}) {
+    const url = `${API}${path}`;
+    const res = await axios.get(url, {
+        params,
+        headers: { "User-Agent": "gemini-cli/2.0" },
+        timeout: 15000,
+    });
+    return res.data;
+}
+
+// ─────────────────────────────────────────────────────────────────
+//  Search skills
+// ─────────────────────────────────────────────────────────────────
+export async function searchSkills(query, limit = 10) {
+    const data = await apiFetch("/skills/search", { q: query, limit });
+    return data.data ?? [];
+}
+
+export async function browseSkills(view = "all-time", perPage = 20) {
+    const data = await apiFetch("/skills", { view, per_page: perPage });
+    return data.data ?? [];
+}
+
+// ─────────────────────────────────────────────────────────────────
+//  Fetch skill files from API
+//  id format: "owner/repo/slug"  e.g. "vercel-labs/agent-skills/next-js-development"
+// ─────────────────────────────────────────────────────────────────
+export async function fetchSkill(id) {
+    const data = await apiFetch(`/skills/${id}`);
+    return data; // { id, slug, name?, files: [{ path, contents }] }
+}
+
+// ─────────────────────────────────────────────────────────────────
+//  Install a skill
+//  source: "owner/repo/slug" or just "owner/repo" (installs all)
+//  scope:  "project" | "global"
+// ─────────────────────────────────────────────────────────────────
+export async function installSkill(id, scope = "project") {
+    const skill = await fetchSkill(id);
+
+    if (!skill.files?.length) {
+        throw new Error(`Skill "${id}" has no files.`);
+    }
+
+    const targetDir = scope === "global"
+        ? GLOBAL_AGENTS_DIR
+        : path.join(process.cwd(), ".agents");
+
+    const slug    = skill.slug ?? id.split("/").pop();
+    const skillDir = path.join(targetDir, slug);
+    fs.mkdirSync(skillDir, { recursive: true });
+
+    // Write all skill files
+    for (const file of skill.files) {
+        const filePath = path.join(skillDir, file.path);
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+        fs.writeFileSync(filePath, file.contents ?? "", "utf8");
+    }
+
+    // Write metadata
+    fs.writeFileSync(path.join(skillDir, ".meta.json"), JSON.stringify({
+        id:        skill.id,
+        name:      skill.name ?? slug,
+        slug,
+        source:    skill.source,
+        installs:  skill.installs,
+        installedAt: new Date().toISOString(),
+        scope,
+    }, null, 2));
+
+    return { slug, name: skill.name ?? slug, dir: skillDir };
+}
+
+// ─────────────────────────────────────────────────────────────────
+//  Remove a skill
+// ─────────────────────────────────────────────────────────────────
+export function removeSkill(slug, scope = "both") {
+    const removed = [];
+
+    const dirs = scope === "global"
+        ? [GLOBAL_AGENTS_DIR]
+        : scope === "project"
+            ? [path.join(process.cwd(), ".agents")]
+            : [path.join(process.cwd(), ".agents"), GLOBAL_AGENTS_DIR];
+
+    for (const dir of dirs) {
+        const skillDir = path.join(dir, slug);
+        if (fs.existsSync(skillDir)) {
+            fs.rmSync(skillDir, { recursive: true, force: true });
+            removed.push(skillDir);
+        }
+    }
+
+    if (!removed.length) throw new Error(`Skill "${slug}" not found.`);
+    return removed;
+}
+
+// ─────────────────────────────────────────────────────────────────
+//  List installed skills with status
+// ─────────────────────────────────────────────────────────────────
+export function listInstalledSkills() {
+    const result = [];
+
+    const checkDir = (dir, isGlobal) => {
+        if (!fs.existsSync(dir)) return;
+        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+            if (!entry.isDirectory()) continue;
+            const skillDir = path.join(dir, entry.name);
+            const metaFile = path.join(skillDir, ".meta.json");
+            const hasSkillMd = fs.existsSync(path.join(skillDir, "SKILL.md"));
+            if (!hasSkillMd) continue;
+
+            let meta = {};
+            try { meta = JSON.parse(fs.readFileSync(metaFile, "utf8")); } catch {}
+
+            result.push({
+                slug:   entry.name,
+                name:   meta.name   ?? entry.name,
+                source: meta.source ?? "local",
+                global: isGlobal,
+                dir:    skillDir,
+                installedAt: meta.installedAt ?? null,
+            });
+        }
+    };
+
+    checkDir(path.join(process.cwd(), ".agents"), false);
+    checkDir(GLOBAL_AGENTS_DIR, true);
+    return result;
+}